Интерфейс IIOParamController

public interface IIOParamController

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

В методе activate, контроллер получает начальные значения, запрашивая методы объекта IIOParam get, изменяет значения любым способом, затем вызывает методы объекта IIOParam set, чтобы изменить соответствующие настройки. Обычно, эти методы 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.