Интерфейс IIOMetadataController
public interface IIOMetadataController
IIOMetadata, либо путём отображения графического интерфейса для получения значений от пользователя, либо иными средствами. Данный интерфейс просто определяет универсальный activate метод, который вызывает контроллер, не обращая внимания на то, каким образом контроллер получает значения (т.е., безразлично, отображает ли контроллер графический интерфейс или просто вычисляет набор значений). Внутри activate метода контроллер получает начальные значения, запросив настройки объекта IIOMetadata, либо с помощью дерева XML DOM, либо с помощью специфичного для плагина интерфейса, изменяет значения любым способом, а затем изменяет настройки объекта IIOMetadata, используя либо setFromTree или mergeTree методы, либо специфичный для плагина интерфейс. В общем случае приложения могут ожидать, что при возврате activate метода значением true, объект IIOMetadata готов к использованию в операции записи.
Поставщики могут выбрать предоставление графических интерфейсов для IIOMetadata подклассов, которые они определяют для конкретного плагина. Эти графические интерфейсы могут быть настроены в качестве контроллеров по умолчанию в соответствующих IIOMetadata подклассах.
В качестве альтернативы, в качестве контроллера может использоваться алгоритмический процесс, такой как поиск в базе данных или обработка командной строки, в этом случае метод activate просто выполнит поиск или вычисление настроек, вызовет методы объекта IIOMetadata для установки его состояния и вернёт значение true.
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
activate |
Активирует контроллер. |
Подробное описание методов
activate
boolean activate(IIOMetadata metadata)
true, все настройки в объекте IIOMetadata должны быть готовы к использованию в операции записи. Если возвращается false, никакие настройки в объекте IIOMetadata не будут изменены (т.е., пользователь отменил операцию).- Параметры:
-
metadata- объектIIOMetadata, который будет изменён. - Возвращает:
-
trueеслиIIOMetadataбыл изменён,falseв противном случае. - Выбрасывает:
-
IllegalArgumentException- еслиmetadataимеет значениеnullили не является экземпляром правильного класса.
© 1993, 2021, 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/17/docs/api/java.desktop/javax/imageio/metadata/IIOMetadataController.html