Класс EventHandler

public class EventHandler extends Object implements InvocationHandler

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