Интерфейс IIOParamController

public interface IIOParamController

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

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

Методы

activate

boolean activate(IIOParam param)

Активирует контроллер. Если возвращается true, все параметры в объекте IIOParam должны быть готовы к использованию в операции чтения или записи. Если возвращается false, никакие параметры в объекте IIOParam не будут изменены (т.е., пользователь отменил операцию).

Параметры:

param - объект IIOParam для изменения.

Возвращает:

true если объект IIOParam был изменён, false в противном случае.

Исключения:

IllegalArgumentException - если param имеет значение null или не является экземпляром соответствующего класса.