Module  java.desktop

Package javax.imageio.metadata

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

当读取图像时，其每个流和每个图像元数据可用作IIOMetadata对象。 该对象的内部特定于创建它的插件。 其内容可以以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