Класс EventHandler

public class EventHandler extends Object implements InvocationHandler

Класс EventHandler обеспечивает поддержку динамического создания прослушивателей событий, методы которых выполняют простую инструкцию с использованием входящего объекта события и целевого объекта.

Класс EventHandler предназначен для использования интерактивными инструментами, такими как конструкторы приложений, которые позволяют разработчикам создавать связи между компонентами Bean. Обычно связи устанавливаются от компонента пользовательского интерфейса (источника события) к компоненту бизнес-логики приложения (целевому объекту). Наиболее эффективные связи такого рода изолируют бизнес-логику приложения от пользовательского интерфейса. Например, EventHandler для связи от JCheckBox с методом, принимающим логическое значение, может извлечь состояние флажка и передать его непосредственно методу, благодаря чему метод изолирован от уровня пользовательского интерфейса.

Внутренние классы — ещё один, более универсальный способ обработки событий пользовательского интерфейса. Класс EventHandler обрабатывает лишь часть случаев, возможных при использовании внутренних классов. Однако EventHandler лучше взаимодействует со схемой долговременного хранения, чем внутренние классы. Кроме того, использование EventHandler в крупных приложениях, где один и тот же интерфейс реализован много раз, может уменьшить объём дискового пространства и памяти, занимаемый приложением.

Причина, по которой прослушиватели, созданные с помощью EventHandler, занимают так мало места, заключается в том, что класс Proxy, на который опирается EventHandler, совместно использует реализации идентичных интерфейсов. Например, если использовать методы EventHandler create для создания всех ActionListener в приложении, все прослушиватели действий будут экземплярами одного класса (созданного классом Proxy). В общем случае для прослушивателей на основе класса Proxy требуется создать один класс прослушивателя для каждого типа прослушивателя (интерфейса), тогда как при использовании внутренних классов требуется создать по одному классу для каждого прослушивателя (объекта, реализующего интерфейс).

Обычно вам не приходится непосредственно работать с экземплярами EventHandler. Вместо этого используйте один из методов EventHandler create, чтобы создать объект, реализующий заданный интерфейс прослушивателя. Этот объект-прослушиватель использует объект EventHandler в скрытом режиме, чтобы инкапсулировать информацию о событии, объекте, которому следует отправить сообщение при наступлении события, сообщении (методе), которое нужно отправить, и аргументах метода. В следующем разделе приведены примеры создания объектов-прослушивателей с помощью методов create.

Примеры использования EventHandler

Самый простой способ использования EventHandler — установить прослушиватель, который вызывает метод целевого объекта без аргументов. В следующем примере мы создаём ActionListener, вызывающий метод toFront для экземпляра javax.swing.JFrame.

myButton.addActionListener(
    (ActionListener)EventHandler.create(ActionListener.class, frame, "toFront"));

При нажатии myButton будет выполнена инструкция frame.toFront(). Того же результата можно добиться, обеспечив дополнительную проверку типов во время компиляции, определив новую реализацию интерфейса ActionListener и добавив её экземпляр к кнопке:

//Equivalent code using an inner class instead of EventHandler.
myButton.addActionListener(new ActionListener() {
    public void actionPerformed(ActionEvent e) {
        frame.toFront();
    }
});

Следующий по простоте способ использования EventHandler — извлечь значение свойства из первого аргумента метода интерфейса прослушивателя (обычно это объект события) и использовать его для задания значения свойства целевого объекта. В следующем примере мы создаём ActionListener, который устанавливает свойству nextFocusableComponent целевого объекта (myButton) значение свойства "source" события.

EventHandler.create(ActionListener.class, myButton, "nextFocusableComponent", "source")

Этому соответствует следующая реализация с использованием внутреннего класса:

//Equivalent code using an inner class instead of EventHandler.
new ActionListener() {
    public void actionPerformed(ActionEvent e) {
        myButton.setNextFocusableComponent((Component)e.getSource());
    }
}

Также можно создать EventHandler, который просто передаёт входящий объект события действию целевого объекта. Если четвёртый аргумент EventHandler.create — пустая строка, событие просто передаётся дальше:

EventHandler.create(ActionListener.class, target, "doActionEvent", "")

Этому соответствует следующая реализация с использованием внутреннего класса:

//Equivalent code using an inner class instead of EventHandler.
new ActionListener() {
    public void actionPerformed(ActionEvent e) {
        target.doActionEvent(e);
    }
}

Вероятно, наиболее распространённый способ использования EventHandler — извлечь значение свойства из источника объекта события и установить это значение в качестве значения свойства целевого объекта. В следующем примере мы создаём ActionListener, который устанавливает свойству "label" целевого объекта значение свойства "text" источника (значение свойства "source") события.

EventHandler.create(ActionListener.class, myButton, "label", "source.text")

Этому соответствует следующая реализация с использованием внутреннего класса:

//Equivalent code using an inner class instead of EventHandler.
new ActionListener {
    public void actionPerformed(ActionEvent e) {
        myButton.setLabel(((JTextField)e.getSource()).getText());
    }
}

Свойство события можно «уточнить» любым количеством префиксов свойств, разделённых символом ".". Имена «уточнения», расположенные перед символами ".", рассматриваются как имена свойств, которые следует последовательно применить к объекту события слева направо.

Например, следующий прослушиватель действий

EventHandler.create(ActionListener.class, target, "a", "b.c.d")

можно записать в виде следующего внутреннего класса (при условии, что у всех свойств имеются стандартные методы получения и они возвращают значения соответствующих типов):

//Equivalent code using an inner class instead of EventHandler.
new ActionListener {
    public void actionPerformed(ActionEvent e) {
        target.setA(e.getB().getC().isD());
    }
}

Целевое свойство также можно «уточнить» любым количеством префиксов свойств, разделённых символом ".". Например, следующий прослушиватель действий:

   EventHandler.create(ActionListener.class, target, "a.b", "c.d")
 

можно записать в виде следующего внутреннего класса (при условии, что у всех свойств имеются стандартные методы получения и они возвращают значения соответствующих типов):

   //Equivalent code using an inner class instead of EventHandler.
   new ActionListener {
     public void actionPerformed(ActionEvent e) {
         target.getA().setB(e.getC().isD());
    }
}

Поскольку EventHandler в конечном счёте использует рефлексию для вызова метода, не рекомендуется указывать в качестве цели перегруженный метод. Например, если целью является экземпляр класса MyTarget, определённого следующим образом:

   public class MyTarget {
     public void doIt(String);
     public void doIt(Object);
   }
 

Тогда метод doIt является перегруженным. EventHandler вызовет метод, подходящий для источника. Если источник равен null, подходят оба метода, и невозможно определить, какой из них будет вызван. Поэтому мы не рекомендуем указывать в качестве цели перегруженные методы.