Интерфейс 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.