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
-
接口摘要 接口 描述 IIOMetadataController 要由可以通过建立GUI以从用户获取值或通过其他方式确定IIOMetadata
对象的设置的对象来实现的接口。IIOMetadataFormat 描述从IIOMetadata.getAsTree
返回并传递给IIOMetadata.setFromTree
和mergeTree
的元数据文档的结构的对象。 -
类摘要 Class 描述 IIOMetadata 由与图像和流相关联的元数据(非图像数据)的对象扩展的抽象类。IIOMetadataFormatImpl 一个具体的类,提供IIOMetadataFormat
接口的可重用实现。IIOMetadataNode -
异常摘要 异常 描述 IIOInvalidTreeException AnIIOInvalidTreeException
is thrown when an attempt by anIIOMetadata
object to parse a tree ofIIOMetadataNode
s fails.