Spec-Zone.ru › OpenJDK 25

Интерфейс IIOMetadataController

public interface IIOMetadataController
Интерфейс, который должны реализовывать объекты, способные определять настройки объекта IIOMetadata: например, отображая графический интерфейс для получения значений от пользователя или используя другие средства. Этот интерфейс лишь определяет универсальный метод activate, вызывающий контроллер, не устанавливая способ получения контроллером значений (т. е., для этого интерфейса не имеет значения, отображает ли контроллер графический интерфейс или просто вычисляет набор значений).

В рамках метода activate контроллер получает начальные значения, запрашивая настройки объекта IIOMetadata с помощью дерева XML DOM или специфичного для подключаемого модуля интерфейса, изменяет значения любым способом, а затем изменяет настройки объекта IIOMetadata с помощью методов setFromTree или mergeTree либо специфичного для подключаемого модуля интерфейса. В общем случае приложения могут рассчитывать, что после возврата метода activate со значением true объект IIOMetadata готов к использованию при записи.

Поставщики могут предоставлять графические интерфейсы для подклассов IIOMetadata, определённых ими для конкретного подключаемого модуля. Их можно настроить в качестве контроллеров по умолчанию в соответствующих подклассах IIOMetadata.

В качестве контроллера также может использоваться алгоритмический процесс, например поиск в базе данных или разбор командной строки. В этом случае метод activate будет просто искать или вычислять настройки, вызывать методы IIOMetadata для установки его состояния и возвращать true.

См. также:
  • IIOMetadata.setController(IIOMetadataController)
  • IIOMetadata.getController()
  • IIOMetadata.getDefaultController()
  • IIOMetadata.hasController()
  • IIOMetadata.activateController()

Краткое описание методов

Модификатор и тип Метод Описание
boolean activate(IIOMetadata metadata)
Активирует контроллер.

Подробное описание методов

activate

boolean activate(IIOMetadata metadata)
Активирует контроллер. Если возвращается true, все настройки объекта IIOMetadata должны быть готовы к использованию при записи. Если возвращается false, настройки объекта IIOMetadata не изменяются (т. е., пользователь отменил операцию).
Параметры:
metadata — объект IIOMetadata, который необходимо изменить.
Возвращает:
true, если IIOMetadata был изменён; в противном случае — false.
Вызывает исключение:
IllegalArgumentException — если metadata равен null или не является экземпляром соответствующего класса.

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/imageio/metadata/IIOMetadataController.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API