JavaTM 2 Platform
Standard Ed. 5.0

软件包 javax.imageio.metadata

用于处理读写元数据的 Java Image I/O API 的包。

请参见:
          描述

接口摘要
IIOMetadataController 该接口将由可以确定 IIOMetadata 对象设置值(通过提供一个 GUI 来从用户那里获取值或其他方式)的对象实现。
IIOMetadataFormat 描述从 IIOMetadata.getAsTree 返回并传递给 IIOMetadata.setFromTreemergeTree 的元数据文档结构的对象。
 

类摘要
IIOMetadata 将由表示与图像和流关联的元数据(非图像数据)的对象扩展的抽象类。
IIOMetadataFormatImpl 提供 IIOMetadataFormat 接口的可重用实现的具体类。
IIOMetadataNode 表示元数据树中节点的类,该类实现 org.w3c.dom.Element 接口,还允许通过 getUserObjectsetUserObject 方法存储非文本对象。
 

异常摘要
IIOInvalidTreeException IIOMetadata 对象尝试解析 IIOMetadataNode 的树失败时,将抛出 IIOInvalidTreeException
 

软件包 javax.imageio.metadata 的描述

用于处理读写元数据的 Java Image I/O API 的包。

读取图像时,其每个流和每个图像元数据都可以作为 IIOMetadata 对象使用。此对象的内部特定于创建它的插件。其内容能够以作为 IIOMetadataNode 对象的树实现的 XML Document 的形式访问。

写入图像时,其元数据可以通过定义或修改 IIOMetadata 对象设置。这种对象可以从(javax.imageio 包中的)ImageWriterImageTranscoder 获得。获得这种对象后,就可以通过修改由 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. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策