Module java.desktop
Package javax.imageio.metadata
package javax.imageio.metadata
Java Image I/O API中处理读取和写入元数据的包。
在读取图像时，其每个流和每个图像的元数据都可以作为一个IIOMetadata对象提供。该对象的内部特定于创建它的插件。其内容可以以XML Document的形式访问，该文档实现为IIOMetadataNode对象的树。
在写入图像时，可以通过定义或修改IIOMetadata对象来设置其元数据。可以从javax.imageio包中的ImageWriter或ImageTranscoder（从javax.imageio包）中获取这样的对象。一旦获取了这样的对象，可以通过由IIOMetadataNode组成的Document设置或修改其内容。文档格式可以选择性地使用IIOMetadataFormat对象描述。
XML Document中包含的元数据的格式由一个字符串标识，该字符串显示为IIOMetadataNode对象树的根节点。该字符串包含一个版本号，例如“javax_imageio_jpeg_image_1.0”。读取器和写入器可以支持同一基本格式的多个版本，Image I/O API具有允许通过将字符串传递给用于获取IIOMetadata对象的方法/构造函数来指定要使用的版本的方法。在某些情况下，较新版本可能与期望较旧版本的程序不完全兼容（例如，请参阅下面的JPEG元数据使用说明的本机元数据格式部分）。
插件可以选择支持一个标准（插件中立）格式。该格式不提供元数据的无损编码，但允许以通用方式访问元数据的一部分。
每个标准插件都支持所谓的“本机”元数据格式，该格式以无损方式编码其元数据：
- 自：
- 1.4
-
ClassDescription当
IIOMetadata对象尝试解析IIOMetadataNode树失败时，将抛出IIOInvalidTreeException。由表示与图像和流关联的元数据（非图像数据）的对象扩展的抽象类。由可以确定IIOMetadata对象设置的对象实现的接口，可以通过向用户提供GUI以从用户获取值或通过其他方式来确定。描述从IIOMetadata.getAsTree返回并传递给IIOMetadata.setFromTree和mergeTree的元数据文档结构的对象。提供IIOMetadataFormat接口的可重用实现的具体类。表示元数据树中的节点的类，该类实现org.w3c.dom.Element接口，并通过getUserObject和setUserObject方法额外允许存储非文本对象。