Класс EventHandler

public class EventHandler extends Object implements InvocationHandler

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

Класс EventHandler предназначен для использования интерактивными инструментами, такими как конструкторы приложений, которые позволяют разработчикам устанавливать связи между компонентами. Обычно соединения создаются от компонента пользовательского интерфейса (источника события) к компоненту логики приложения (целевому компоненту). Наиболее эффективные соединения такого рода изолируют логику приложения от пользовательского интерфейса. Например, 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, то оба метода подходят, и вызов, какой из них будет вызван, не определён. По этой причине мы рекомендуем избегать нацеливания на перегруженные методы.