Класс 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 должен существовать один метод fire.

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