模块 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 。 此格式不提供元数据的无损编码，但允许以通用方式访问部分元数据。
每个标准插件都支持所谓的“本机”元数据格式，它无损地编码其元数据：
- 从以下版本开始：
- 1.4
-
接口摘要 接口 描述 IIOMetadataController 由可以确定IIOMetadata对象设置的对象实现的接口，可以通过建立GUI来从用户获取值，也可以通过其他方式。IIOMetadataFormat 描述从IIOMetadata.getAsTree返回并传递到IIOMetadata.setFromTree和mergeTree的元数据文档结构的对象。 -
类摘要 类 描述 IIOMetadata 由对象扩展的抽象类，表示与图像和流相关联的元数据（非图像数据）。IIOMetadataFormatImpl 一个具体类，提供IIOMetadataFormat接口的可重用实现。IIOMetadataNode 表示元数据树中的节点的类，它实现org.w3c.dom.Element接口，并且还允许通过getUserObject和setUserObject方法存储非文本对象。 -
异常摘要 异常 描述 IIOInvalidTreeException AnIIOInvalidTreeExceptionis thrown when an attempt by anIIOMetadataobject to parse a tree ofIIOMetadataNodes fails.