Интерфейс IIOParamController

public interface IIOParamController

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

Внутри метода activate, контроллер получает начальные значения, запросив методы объекта IIOParam , изменяет значения любым способом, затем вызывает методы объекта IIOParam для изменения соответствующих параметров. Обычно эти методы set вызываются все сразу в ходе финального подтверждения, чтобы операция отмены не нарушила существующие значения. В общем случае, приложения могут ожидать, что когда метод activate возвращает true, объект IIOParam готов к использованию в операции чтения или записи.

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

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

 class MyGUI extends SomeComponent implements IIOParamController {

    public MyGUI() {
        // ...
        setEnabled(false);
    }

    public boolean activate(IIOParam param) {
        // disable other components if desired
        setEnabled(true);
        // go to sleep until either cancelled or committed
        boolean ret = false;
        if (!cancelled) {
            // set values on param
            ret = true;
        }
        setEnabled(false);
        // enable any components disabled above
        return ret;
    }
 

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