软件包 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 一节）。

插件可以选择支持标准（插件无关）格式。此格式不提供元数据的无损耗编码，但是允许以通用方式访问部分元数据。

每个标准插件都支持所谓的“本机”元数据格式，该格式以无损耗的方式编码其元数据：

• GIF 元数据
• JPEG 元数据
• PNG 元数据
• BMP 元数据
• WBMP 元数据

从以下版本开始：

1.4