Класс EventListenerList

public class EventListenerList extends Object implements Serializable

Класс, содержащий список слушателей событий. Один экземпляр можно использовать для хранения всех слушателей (всех типов) экземпляра, использующего этот список. Класс, использующий EventListenerList, должен предоставлять типобезопасный API (предпочтительно соответствующий спецификации JavaBeans) и методы, которые отправляют уведомления о событиях соответствующим слушателям событий из списка. Основные преимущества этого класса — относительно низкие затраты при отсутствии слушателей, возможность сериализации списков слушателей событий в одном месте, а также определённый уровень потокобезопасности (при правильном использовании). Пример использования: предположим, что определяется класс, отправляющий FooEvents, и требуется позволить пользователям этого класса регистрировать FooListeners и получать уведомления при возникновении FooEvents. В определение класса следует добавить следующее:

EventListenerList listenerList = new EventListenerList();
FooEvent fooEvent = null;

public void addFooListener(FooListener l) {
    listenerList.add(FooListener.class, l);
}

public void removeFooListener(FooListener l) {
    listenerList.remove(FooListener.class, l);
}


// Notify all listeners that have registered interest for
// notification on this event type.  The event instance
// is lazily created using the parameters passed into
// the fire method.

protected void fireFooXXX() {
    // Guaranteed to return a non-null array
    Object[] listeners = listenerList.getListenerList();
    // Process the listeners last to first, notifying
    // those that are interested in this event
    for (int i = listeners.length-2; i>=0; i-=2) {
        if (listeners[i]==FooListener.class) {
            // Lazily create the event:
            if (fooEvent == null)
                fooEvent = new FooEvent(this);
            ((FooListener)listeners[i+1]).fooXXX(fooEvent);
        }
    }
}

foo следует заменить подходящим именем, а fireFooXxx — подходящим именем метода. Для каждого метода уведомления в интерфейсе FooListener должен существовать отдельный метод отправки события.

Предупреждение: сериализованные объекты этого класса будут несовместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4 в пакет java.beans добавлена поддержка долговременного хранения всех JavaBeans. См. XMLEncoder.