Класс EventListenerList

public class EventListenerList extends Object implements Serializable

Класс, хранящий список EventListener. Один экземпляр может использоваться для хранения всех слушателей (всех типов) для экземпляра, использующего список. Ответственность класса, использующего EventListenerList, состоит в обеспечении безопасной для типов API (предпочтительно соответствующей спецификации JavaBeans) и методов, которые отправляют методы уведомления о событиях соответствующим EventListener в списке. Основные преимущества этого класса заключаются в том, что он относительно дешев в случае отсутствия слушателей, и он обеспечивает сериализацию списков слушателей событий в одном месте, а также некоторую безопасность в многопоточной среде (при правильном использовании). Пример использования: предположим, что кто-то определяет класс, который отправляет 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 - на соответствующее имя метода. Один метод fire должен существовать для каждого метода уведомления в интерфейсе FooListener.

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