JavaTM 2 Platform
Standard Ed. 6

軟體套件 javax.imageio.metadata

用於處理讀寫元資料的 Java Image I/O API 的套件。

請參見:
          描述

介面摘要
IIOMetadataController 該介面將由可以確定 IIOMetadata 物件設置值(通過提供一個 GUI 來從使用者那裡獲取值或其他方式)的物件實作。
IIOMetadataFormat 描述從 IIOMetadata.getAsTree 返回並傳遞給 IIOMetadata.setFromTree 和 mergeTree 的元資料文檔結構的物件。
 

類別摘要
IIOMetadata 將由表示與圖像和串流關聯的元資料(非圖像資料)的物件擴展的抽象類別。
IIOMetadataFormatImpl 提供 IIOMetadataFormat 介面的可重用實作的具體類別。
IIOMetadataNode 表示元資料階層樹中節點的類別,該類別實作 org.w3c.dom.Element 介面,還允許通過 getUserObject 和 setUserObject 方法存儲非文本物件。
 

異常摘要
IIOInvalidTreeException 當 IIOMetadata 物件嘗試解析 IIOMetadataNode 的階層樹失敗時,將拋出 IIOInvalidTreeException。
 

軟體套件 javax.imageio.metadata 的描述

用於處理讀寫元資料的 Java Image I/O API 的套件。

讀取圖像時,其每個串流和每個圖像元資料都可以作為 IIOMetadata 物件使用。此物件的內部特定於創建它的外掛程式。其內容能夠以作為 IIOMetadataNode 物件的階層樹實作的 XML Document 的形式存取。

寫入圖像時,其元資料可以通過定義或修改 IIOMetadata 物件設置。這種對象可以從(javax.imageio 套件中的)ImageWriter 或 ImageTranscoder 獲得。獲得這種物件後,就可以通過修改由 IIOMetadataNode 組成的 Document 來設置其內容。可以選擇是否使用 IIOMetadataFormat 物件來描述文檔格式。

XML Document 中所含元資料的格式由一個字元串標識,該字元串作為 IIOMetadataNode 物件的階層樹的根節點出現。此字元串包含版本號,例如,"javax_imageio_jpeg_image_1.0"。Reader 和 writer 可能支持同一基本格式的多個版本號,Image I/O API 的方法可以通過將字元串傳遞給用於獲取 IIOMetadata 物件的方法/建構子來指定要使用的版本。在某些情況下,較新的版本可能與按較舊版本編寫的程序不完全相容(有關範例,請參見下文 JPEG 元資料用法說明的 Native Metadata Format 一節)。

外掛程式可以選擇支持標準(外掛程式無關)格式。此格式不提供元資料的無損耗編碼,但是允許以通用方式存取部分元資料。

每個標準外掛程式都支持所謂的“本機”元資料格式,該格式以無損耗的方式編碼其元資料:

從以下版本開始:
1.4

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。