Интерфейс IIOMetadataController

public interface IIOMetadataController

Интерфейс, который должны реализовывать объекты, способные определять настройки объекта IIOMetadata, либо создавая графический интерфейс для получения значений от пользователя, либо другими способами. Данный интерфейс просто определяет универсальный activate метод, который вызывает контроллер, не учитывая способ получения значений контроллером (т.е., контроллер создаёт графический интерфейс или просто вычисляет набор значений – для данного интерфейса это не имеет значения).

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

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

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

См. также:: IIOMetadata.setController(javax.imageio.metadata.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 или не является экземпляром правильного класса.