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