Интерфейс IIOParamController

public interface IIOParamController

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

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