模块 java.desktop

Package javax.imageio.metadata

处理读取和写入元数据的Java Image I / O API包。

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

在编写图像时，可以通过定义或修改IIOMetadata对象来设置其元数据。 这样的物体可以从ImageWriter或ImageTranscoder （来自javax.imageio包）获得。 一旦获得了这样的对象，其内容可以通过由Document组成的IIOMetadataNode进行修改。 可以可选地使用IIOMetadataFormat对象来描述文档格式。

XML Document包含的元数据的格式由字符串标识，该字符串显示为IIOMetadataNode对象树的IIOMetadataNode 。 该字符串包含版本号，例如“javax_imageio_jpeg_image_1.0”。 读者和编写者可能支持相同基本格式的多个版本，而Image I / O API的方法允许通过将字符串传递给用于获取IIOMetadata对象的方法/构造函数来指定要使用的版本。 在某些情况下，较新版本可能与预期较旧版本的程序严格兼容（例如，请参阅下面的JPEG元数据使用说明的本机元数据格式部分）。

插件可能会选择支持standard (plug-in neutral) format 。 此格式不提供元数据的无损编码，但允许以通用方式访问部分元数据。

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

• BMP metadata
• GIF metadata
• JPEG metadata
• PNG metadata
• TIFF metadata
• WBMP metadata

从以下版本开始：

1.4

接口摘要

接口	描述
IIOMetadataController	由可以确定 IIOMetadata对象设置的对象实现的接口，可以通过建立GUI来从用户获取值，也可以通过其他方式。
IIOMetadataFormat	描述从 IIOMetadata.getAsTree返回并传递到 IIOMetadata.setFromTree和 mergeTree的元数据文档结构的对象。

类摘要

类	描述
IIOMetadata	由对象扩展的抽象类，表示与图像和流相关联的元数据（非图像数据）。
IIOMetadataFormatImpl	一个具体类，提供 IIOMetadataFormat接口的可重用实现。
IIOMetadataNode	表示元数据树中的节点的类，它实现org.w3c.dom.Element接口，并且还允许通过getUserObject和setUserObject方法存储非文本对象。

异常摘要

异常	描述
IIOInvalidTreeException	An IIOInvalidTreeException is thrown when an attempt by an IIOMetadata object to parse a tree of IIOMetadataNodes fails.