Класс AWTEventMulticaster

public class AWTEventMulticaster
extends Object
implements ComponentListener, ContainerListener, FocusListener, KeyListener, MouseListener, MouseMotionListener, WindowListener, WindowFocusListener, WindowStateListener, ActionListener, ItemListener, AdjustmentListener, TextListener, InputMethodListener, HierarchyListener, HierarchyBoundsListener, MouseWheelListener

AWTEventMulticaster реализует эффективный и потокобезопасный механизм многоадресной рассылки событий AWT, определённых в пакете java.awt.event.

Следующий пример демонстрирует, как использовать этот класс:

public myComponent extends Component {
     ActionListener actionListener = null;

     public synchronized void addActionListener(ActionListener l) {
         actionListener = AWTEventMulticaster.add(actionListener, l);
     }
     public synchronized void removeActionListener(ActionListener l) {
         actionListener = AWTEventMulticaster.remove(actionListener, l);
     }
     public void processEvent(AWTEvent e) {
         // when event occurs which causes "action" semantic
         ActionListener listener = actionListener;
         if (listener != null) {
             listener.actionPerformed(new ActionEvent());
         }
     }
 }

Важно отметить, что первым аргументом методов add и remove является поле, хранящее слушателей. Кроме того, вы должны присвоить результат методов add и remove полю, хранящему слушателей.

AWTEventMulticaster реализован как пара EventListeners, которые задаются во время создания. AWTEventMulticaster является неизменяемым. Методы add и remove никак не изменяют AWTEventMulticaster. При необходимости создаётся новый AWTEventMulticaster. Таким образом, безопасно добавлять и удалять слушателей во время обработки события. Однако слушатели, добавленные во время обработки события, не уведомляются о событии, которое в данный момент обрабатывается.

Все методы add позволяют передавать два аргумента. Если первый аргумент равен null, возвращается второй аргумент. Если первый аргумент не равен null, а второй аргумент равен null, возвращается первый аргумент. Если оба аргумента равны non-null, создаётся новый AWTEventMulticaster с использованием двух аргументов и возвращается он.

Для методов remove, принимающих два аргумента, возвращается следующее:

• null, если первый аргумент равен null, или аргументы равны, по принципу ==.
• первый аргумент, если первый аргумент не является экземпляром AWTEventMulticaster.
• результат вызова remove(EventListener) на первом аргументе, передавая второй аргумент методу remove(EventListener).

Swing использует EventListenerList для аналогичной логики. Подробнее ознакомьтесь с ним.