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