Пакет javax.imageio.metadata

Пакет API Java Image I/O, отвечающий за чтение и запись метаданных.

Интерфейс	Описание
IIOMetadataController	Интерфейс, который должны реализовывать объекты, способные определять настройки объекта `IIOMetadata`, либо путем отображения графического интерфейса для получения значений от пользователя, либо иными способами.
IIOMetadataFormat	Объект, описывающий структуру документов метаданных, возвращаемых из `IIOMetadata.getAsTree` и передаваемых в `IIOMetadata.setFromTree` и `mergeTree`.

Класс	Описание
IIOMetadata	Абстрактный класс, который должны расширять объекты, представляющие метаданные (данные, не являющиеся изображением), связанные с изображениями и потоками.
IIOMetadataFormatImpl	Конкретный класс, предоставляющий повторно используемую реализацию интерфейса `IIOMetadataFormat`.
IIOMetadataNode	Класс, представляющий узел в дереве метаданных, который реализует интерфейс `org.w3c.dom.Element` и дополнительно позволяет хранить объекты, не являющиеся текстом, с помощью методов `getUserObject` и `setUserObject`.

Исключение	Описание
IIOInvalidTreeException	Исключение `IIOInvalidTreeException` возникает, когда попытка объекта `IIOMetadata` разобрать дерево `IIOMetadataNode` объектов терпит неудачу.

Описание пакета javax.imageio.metadata

Пакет API Java Image I/O, отвечающий за чтение и запись метаданных.

При чтении изображения его метаданные для каждого потока и каждого изображения доступны как объект IIOMetadata. Внутреннее устройство этого объекта специфично для плагина, который его создал. К его содержимому можно получить доступ в виде XML Document, который реализован как дерево объектов IIOMetadataNode.

При записи изображения его метаданные можно задать, определив или изменив объект IIOMetadata. Такой объект можно получить из объекта ImageWriter или ImageTranscoder (из пакета javax.imageio). После получения такого объекта его содержимое можно задать или изменить с помощью Document, состоящего из IIOMetadataNode. Формат документа можно необязательно описать с помощью объекта IIOMetadataFormat.

Формат метаданных, содержащихся в XML Document, определяется строкой, которая появляется как корневой узел дерева объектов IIOMetadataNode . Эта строка содержит номер версии, например, "javax_imageio_jpeg_image_1.0". Читатели и писатели могут поддерживать несколько версий одного и того же базового формата, и API Image I/O имеет методы, которые позволяют указать, какую версию использовать, передав строку в метод/конструктор, используемый для получения объекта IIOMetadata. В некоторых случаях более новая версия может не быть полностью совместима с программой, ожидающей более старую версию (см., например, раздел "Формат нативных метаданных" в примечаниях к использованию метаданных JPEG ниже).

Плагины могут выбрать поддержку стандартного (нейтрального для плагинов) формата. Этот формат не обеспечивает бес потерь кодирование метаданных, но позволяет получить доступ к части метаданных общим способом.

Каждый из стандартных плагинов поддерживает так называемый "родной" формат метаданных, который кодирует свои метаданные без потерь:

С момента:: 1.4

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.