Класс 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 для аналогичной логики. Ссылайтесь на него для получения подробностей.

Поля

a

protected final EventListener a

b

protected final EventListener b

Конструкторы

AWTEventMulticaster

protected AWTEventMulticaster(EventListener a,
                              EventListener b)

Создает экземпляр мультивещателя событий, который связывает listener-a с listener-b. Входные параметры a и b не должны быть null, хотя реализации могут отличаться в выборе, выбрасывать ли NullPointerException в этом случае.

Параметры:

a - listener-a

b - listener-b

Методы

remove

protected EventListener remove(EventListener oldl)

Параметры:

oldl - прослушиватель, который необходимо удалить

Возвращает:

результирующий прослушиватель

componentResized

public void componentResized(ComponentEvent e)

Обрабатывает событие componentResized, вызывая методы componentResized у listener-a и listener-b.

Указано в:

componentResized в интерфейсе ComponentListener

Параметры:

e - событие компонента

componentMoved

public void componentMoved(ComponentEvent e)

Обрабатывает событие componentMoved, вызывая методы componentMoved у listener-a и listener-b.

Указано в:

componentMoved в интерфейсе ComponentListener

Параметры:

e - событие компонента

componentShown

public void componentShown(ComponentEvent e)

Обрабатывает событие componentShown, вызывая методы componentShown у listener-a и listener-b.

Указано в:

componentShown в интерфейсе ComponentListener

Параметры:

e - событие компонента

componentHidden

public void componentHidden(ComponentEvent e)

Обрабатывает событие componentHidden, вызывая методы componentHidden у listener-a и listener-b.

Указано в:

componentHidden в интерфейсе ComponentListener

Параметры:

e - событие компонента

componentAdded

public void componentAdded(ContainerEvent e)

Обрабатывает событие контейнера componentAdded, вызывая методы componentAdded у listener-a и listener-b.

Указано в:

componentAdded в интерфейсе ContainerListener

Параметры:

e - событие компонента

componentRemoved

public void componentRemoved(ContainerEvent e)

Обрабатывает событие контейнера componentRemoved, вызывая методы componentRemoved у listener-a и listener-b.

Указано в:

componentRemoved в интерфейсе ContainerListener

Параметры:

e - событие компонента

focusGained

public void focusGained(FocusEvent e)

Обрабатывает событие focusGained, вызывая методы focusGained у listener-a и listener-b.

Указано в:

focusGained в интерфейсе FocusListener

Параметры:

e - событие фокуса

focusLost

public void focusLost(FocusEvent e)

Обрабатывает событие focusLost, вызывая методы focusLost у listener-a и listener-b.

Указано в:

focusLost в интерфейсе FocusListener

Параметры:

e - событие фокуса

keyTyped

public void keyTyped(KeyEvent e)

Обрабатывает событие keyTyped, вызывая методы keyTyped у listener-a и listener-b.

Указано в:

keyTyped в интерфейсе KeyListener

Параметры:

e - событие клавиатуры

keyPressed

public void keyPressed(KeyEvent e)

Обрабатывает событие keyPressed, вызывая методы keyPressed у listener-a и listener-b.

Указано в:

keyPressed в интерфейсе KeyListener

Параметры:

e - событие клавиатуры

keyReleased

public void keyReleased(KeyEvent e)

Обрабатывает событие keyReleased, вызывая методы keyReleased у listener-a и listener-b.

Указано в:

keyReleased в интерфейсе KeyListener

Параметры:

e - событие клавиатуры

mouseClicked

public void mouseClicked(MouseEvent e)

Обрабатывает событие mouseClicked, вызывая методы mouseClicked у listener-a и listener-b.

Указано в:

mouseClicked в интерфейсе MouseListener

Параметры:

e - событие мыши

mousePressed

public void mousePressed(MouseEvent e)

Обрабатывает событие mousePressed, вызывая методы mousePressed у listener-a и listener-b.

Указано в:

mousePressed в интерфейсе MouseListener

Параметры:

e - событие мыши

mouseReleased

public void mouseReleased(MouseEvent e)

Обрабатывает событие mouseReleased, вызывая методы mouseReleased у listener-a и listener-b.

Указано в:

mouseReleased в интерфейсе MouseListener

Параметры:

e - событие мыши

mouseEntered

public void mouseEntered(MouseEvent e)

Обрабатывает событие mouseEntered, вызывая методы mouseEntered у listener-a и listener-b.

Указано в:

mouseEntered в интерфейсе MouseListener

Параметры:

e - событие мыши

mouseExited

public void mouseExited(MouseEvent e)

Обрабатывает событие mouseExited, вызывая методы mouseExited у listener-a и listener-b.

Указано в:

mouseExited в интерфейсе MouseListener

Параметры:

e - событие мыши

mouseDragged

public void mouseDragged(MouseEvent e)

Обрабатывает событие mouseDragged, вызывая методы mouseDragged у listener-a и listener-b.

Указано в:

mouseDragged в интерфейсе MouseMotionListener

Параметры:

e - событие мыши

mouseMoved

public void mouseMoved(MouseEvent e)

Обрабатывает событие mouseMoved, вызывая методы mouseMoved у listener-a и listener-b.

Указано в:

mouseMoved в интерфейсе MouseMotionListener

Параметры:

e - событие мыши

windowOpened

public void windowOpened(WindowEvent e)

Обрабатывает событие windowOpened, вызывая методы windowOpened у listener-a и listener-b.

Указано в:

windowOpened в интерфейсе WindowListener

Параметры:

e - событие окна

windowClosing

public void windowClosing(WindowEvent e)

Обрабатывает событие windowClosing, вызывая методы windowClosing у listener-a и listener-b.

Указано в:

windowClosing в интерфейсе WindowListener

Параметры:

e - событие окна

windowClosed

public void windowClosed(WindowEvent e)

Обрабатывает событие windowClosed, вызывая методы windowClosed у listener-a и listener-b.

Указано в:

windowClosed в интерфейсе WindowListener

Параметры:

e - событие окна

windowIconified

public void windowIconified(WindowEvent e)

Обрабатывает событие windowIconified, вызывая методы windowIconified у listener-a и listener-b.

Указано в:

windowIconified в интерфейсе WindowListener

Параметры:

e - событие окна

См. также:

Frame.setIconImage(java.awt.Image)

windowDeiconified

public void windowDeiconified(WindowEvent e)

Обрабатывает событие windowDeiconfied, вызывая методы windowDeiconified у listener-a и listener-b.

Указано в:

windowDeiconified в интерфейсе WindowListener

Параметры:

e - событие окна

windowActivated

public void windowActivated(WindowEvent e)

Обрабатывает событие windowActivated, вызывая методы windowActivated у listener-a и listener-b.

Указано в:

windowActivated в интерфейсе WindowListener

Параметры:

e - событие окна

windowDeactivated

public void windowDeactivated(WindowEvent e)

Обрабатывает событие windowDeactivated, вызывая методы windowDeactivated у listener-a и listener-b.

Указано в:

windowDeactivated в интерфейсе WindowListener

Параметры:

e - событие окна

windowStateChanged

public void windowStateChanged(WindowEvent e)

Обрабатывает событие windowStateChanged, вызывая методы windowStateChanged у listener-a и listener-b.

Указано в:

windowStateChanged в интерфейсе WindowStateListener

Параметры:

e - событие окна

С версии:

1.4

windowGainedFocus

public void windowGainedFocus(WindowEvent e)

Обрабатывает событие windowGainedFocus, вызывая методы windowGainedFocus у listener-a и listener-b.

Определено в:

windowGainedFocus в интерфейсе WindowFocusListener

Параметры:

e - событие окна

С:

1.4

windowLostFocus

public void windowLostFocus(WindowEvent e)

Обрабатывает событие windowLostFocus, вызывая методы windowLostFocus у listener-a и listener-b.

Определено в:

windowLostFocus в интерфейсе WindowFocusListener

Параметры:

e - событие окна

С:

1.4

actionPerformed

public void actionPerformed(ActionEvent e)

Обрабатывает событие actionPerformed, вызывая методы actionPerformed у listener-a и listener-b.

Определено в:

actionPerformed в интерфейсе ActionListener

Параметры:

e - событие действия

itemStateChanged

public void itemStateChanged(ItemEvent e)

Обрабатывает событие itemStateChanged, вызывая методы itemStateChanged у listener-a и listener-b.

Определено в:

itemStateChanged в интерфейсе ItemListener

Параметры:

e - событие элемента

adjustmentValueChanged

public void adjustmentValueChanged(AdjustmentEvent e)

Обрабатывает событие adjustmentValueChanged, вызывая методы adjustmentValueChanged у listener-a и listener-b.

Определено в:

adjustmentValueChanged в интерфейсе AdjustmentListener

Параметры:

e - событие изменения

textValueChanged

public void textValueChanged(TextEvent e)

Описание скопировано из интерфейса: TextListener

Вызывается, когда значение текста изменено. Код в этом методе выполняет операции, необходимые при изменении текста.

Определено в:

textValueChanged в интерфейсе TextListener

inputMethodTextChanged

public void inputMethodTextChanged(InputMethodEvent e)

Обрабатывает событие inputMethodTextChanged, вызывая методы inputMethodTextChanged у listener-a и listener-b.

Определено в:

inputMethodTextChanged в интерфейсе InputMethodListener

Параметры:

e - событие элемента

caretPositionChanged

public void caretPositionChanged(InputMethodEvent e)

Обрабатывает событие caretPositionChanged, вызывая методы caretPositionChanged у listener-a и listener-b.

Определено в:

caretPositionChanged в интерфейсе InputMethodListener

Параметры:

e - событие элемента

hierarchyChanged

public void hierarchyChanged(HierarchyEvent e)

Обрабатывает событие hierarchyChanged, вызывая методы hierarchyChanged у listener-a и listener-b.

Определено в:

hierarchyChanged в интерфейсе HierarchyListener

Параметры:

e - событие элемента

С:

1.3

См. также:

HierarchyEvent.getChangeFlags()

ancestorMoved

public void ancestorMoved(HierarchyEvent e)

Обрабатывает событие ancestorMoved, вызывая методы ancestorMoved у listener-a и listener-b.

Определено в:

ancestorMoved в интерфейсе HierarchyBoundsListener

Параметры:

e - событие элемента

С:

1.3

ancestorResized

public void ancestorResized(HierarchyEvent e)

Обрабатывает событие ancestorResized, вызывая методы ancestorResized у listener-a и listener-b.

Определено в:

ancestorResized в интерфейсе HierarchyBoundsListener

Параметры:

e - событие элемента

С:

1.3

mouseWheelMoved

public void mouseWheelMoved(MouseWheelEvent e)

Обрабатывает событие mouseWheelMoved, вызывая методы mouseWheelMoved у listener-a и listener-b.

Определено в:

mouseWheelMoved в интерфейсе MouseWheelListener

Параметры:

e - событие мыши

С:

1.4

См. также:

MouseWheelEvent

add

public static ComponentListener add(ComponentListener a,
                                    ComponentListener b)

Добавляет компонент-listener-a с компонент-listener-b и возвращает полученный мульти-слушатель.

Параметры:

a - компонент-listener-a

b - компонент-listener-b

add

public static ContainerListener add(ContainerListener a,
                                    ContainerListener b)

Добавляет контейнер-listener-a с контейнер-listener-b и возвращает полученный мульти-слушатель.

Параметры:

a - контейнер-listener-a

b - контейнер-listener-b

add

public static FocusListener add(FocusListener a,
                                FocusListener b)

Добавляет focus-listener-a с focus-listener-b и возвращает полученный мульти-слушатель.

Параметры:

a - focus-listener-a

b - focus-listener-b

add

public static KeyListener add(KeyListener a,
                              KeyListener b)

Добавляет key-listener-a с key-listener-b и возвращает полученный мульти-слушатель.

Параметры:

a - key-listener-a

b - key-listener-b

add

public static MouseListener add(MouseListener a,
                                MouseListener b)

Добавляет mouse-listener-a с mouse-listener-b и возвращает полученный мульти-слушатель.

Параметры:

a - mouse-listener-a

b - mouse-listener-b

add

public static MouseMotionListener add(MouseMotionListener a,
                                      MouseMotionListener b)

Добавляет mouse-motion-listener-a с mouse-motion-listener-b и возвращает полученный мульти-слушатель.

Параметры:

a - mouse-motion-listener-a

b - mouse-motion-listener-b

add

public static WindowListener add(WindowListener a,
                                 WindowListener b)

Добавляет window-listener-a с window-listener-b и возвращает полученный мульти-слушатель.

Параметры:

a - window-listener-a

b - window-listener-b

add

public static WindowStateListener add(WindowStateListener a,
                                      WindowStateListener b)

Добавляет window-state-listener-a с window-state-listener-b и возвращает полученный мульти-слушатель.

Параметры:

a - window-state-listener-a

b - window-state-listener-b

С:

1.4

add

public static WindowFocusListener add(WindowFocusListener a,
                                      WindowFocusListener b)

Добавляет window-focus-listener-a с window-focus-listener-b и возвращает полученный мульти-слушатель.

Параметры:

a - window-focus-listener-a

b - window-focus-listener-b

С:

1.4

add

public static ActionListener add(ActionListener a,
                                 ActionListener b)

Добавляет action-listener-a с action-listener-b и возвращает полученный мульти-слушатель.

Параметры:

a - action-listener-a

b - action-listener-b

add

public static ItemListener add(ItemListener a,
                               ItemListener b)

Добавляет item-listener-a с item-listener-b и возвращает полученный мульти-слушатель.

Параметры:

a - item-listener-a

b - item-listener-b

add

public static AdjustmentListener add(AdjustmentListener a,
                                     AdjustmentListener b)

Добавляет adjustment-listener-a с adjustment-listener-b и возвращает полученный мульти-слушатель.

Параметры:

a - adjustment-listener-a

b - adjustment-listener-b

add

public static TextListener add(TextListener a,
                               TextListener b)

add

public static InputMethodListener add(InputMethodListener a,
                                      InputMethodListener b)

Добавляет input-method-listener-a с input-method-listener-b и возвращает полученный мульти-слушатель.

Параметры:

a - input-method-listener-a

b - input-method-listener-b

add

public static HierarchyListener add(HierarchyListener a,
                                    HierarchyListener b)

Добавляет hierarchy-listener-a с hierarchy-listener-b и возвращает полученный мульти-слушатель.

Параметры:

a - hierarchy-listener-a

b - hierarchy-listener-b

С:

1.3

add

public static HierarchyBoundsListener add(HierarchyBoundsListener a,
                                          HierarchyBoundsListener b)

Добавляет hierarchy-bounds-listener-a с hierarchy-bounds-listener-b и возвращает полученный мульти-слушатель.

Параметры:

a - hierarchy-bounds-listener-a

b - hierarchy-bounds-listener-b

С:

1.3

add

public static MouseWheelListener add(MouseWheelListener a,
                                     MouseWheelListener b)

Добавляет mouse-wheel-listener-a с mouse-wheel-listener-b и возвращает полученный мульти-слушатель.

Параметры:

a - mouse-wheel-listener-a

b - mouse-wheel-listener-b

С:

1.4

remove

public static ComponentListener remove(ComponentListener l,
                                       ComponentListener oldl)

Удаляет старый компонент-listener из component-listener-l и возвращает полученный мульти-слушатель.

Параметры:

l - component-listener-l

oldl - удаляемый компонент-listener

remove

public static ContainerListener remove(ContainerListener l,
                                       ContainerListener oldl)

Удаляет старый слушатель контейнера из container-listener-l и возвращает получившийся многоадресной слушатель.

Параметры:

l - container-listener-l

oldl - удаляемый слушатель контейнера

remove

public static FocusListener remove(FocusListener l,
                                   FocusListener oldl)

Удаляет старый слушатель фокуса из focus-listener-l и возвращает получившийся многоадресной слушатель.

Параметры:

l - focus-listener-l

oldl - удаляемый слушатель фокуса

remove

public static KeyListener remove(KeyListener l,
                                 KeyListener oldl)

Удаляет старого слушателя нажатия клавиш из key-listener-l и возвращает получившийся многоадресной слушатель.

Параметры:

l - key-listener-l

oldl - удаляемый слушатель нажатия клавиш

remove

public static MouseListener remove(MouseListener l,
                                   MouseListener oldl)

Удаляет старого слушателя мыши из mouse-listener-l и возвращает получившийся многоадресной слушатель.

Параметры:

l - mouse-listener-l

oldl - удаляемый слушатель мыши

remove

public static MouseMotionListener remove(MouseMotionListener l,
                                         MouseMotionListener oldl)

Удаляет старого слушателя движения мыши из mouse-motion-listener-l и возвращает получившийся многоадресной слушатель.

Параметры:

l - mouse-motion-listener-l

oldl - удаляемый слушатель движения мыши

remove

public static WindowListener remove(WindowListener l,
                                    WindowListener oldl)

Удаляет старого слушателя окна из window-listener-l и возвращает получившийся многоадресной слушатель.

Параметры:

l - window-listener-l

oldl - удаляемый слушатель окна

remove

public static WindowStateListener remove(WindowStateListener l,
                                         WindowStateListener oldl)

Удаляет старого слушателя состояния окна из window-state-listener-l и возвращает получившийся многоадресной слушатель.

Параметры:

l - window-state-listener-l

oldl - удаляемый слушатель состояния окна

С:

1.4

remove

public static WindowFocusListener remove(WindowFocusListener l,
                                         WindowFocusListener oldl)

Удаляет старого слушателя фокуса окна из window-focus-listener-l и возвращает получившийся многоадресной слушатель.

Параметры:

l - window-focus-listener-l

oldl - удаляемый слушатель фокуса окна

С:

1.4

remove

public static ActionListener remove(ActionListener l,
                                    ActionListener oldl)

Удаляет старого слушателя действия из action-listener-l и возвращает получившийся многоадресной слушатель.

Параметры:

l - action-listener-l

oldl - удаляемый слушатель действия

remove

public static ItemListener remove(ItemListener l,
                                  ItemListener oldl)

Удаляет старого слушателя элемента из item-listener-l и возвращает получившийся многоадресной слушатель.

Параметры:

l - item-listener-l

oldl - удаляемый слушатель элемента

remove

public static AdjustmentListener remove(AdjustmentListener l,
                                        AdjustmentListener oldl)

Удаляет старого слушателя изменения из adjustment-listener-l и возвращает получившийся многоадресной слушатель.

Параметры:

l - adjustment-listener-l

oldl - удаляемый слушатель изменения

remove

public static TextListener remove(TextListener l,
                                  TextListener oldl)

remove

public static InputMethodListener remove(InputMethodListener l,
                                         InputMethodListener oldl)

Удаляет старого слушателя метода ввода из input-method-listener-l и возвращает получившийся многоадресной слушатель.

Параметры:

l - input-method-listener-l

oldl - удаляемый слушатель метода ввода

remove

public static HierarchyListener remove(HierarchyListener l,
                                       HierarchyListener oldl)

Удаляет старого слушателя иерархии из hierarchy-listener-l и возвращает получившийся многоадресной слушатель.

Параметры:

l - hierarchy-listener-l

oldl - удаляемый слушатель иерархии

С:

1.3

remove

public static HierarchyBoundsListener remove(HierarchyBoundsListener l,
                                             HierarchyBoundsListener oldl)

Удаляет старого слушателя границ иерархии из hierarchy-bounds-listener-l и возвращает получившийся многоадресной слушатель.

Параметры:

l - hierarchy-bounds-listener-l

oldl - удаляемый слушатель границ иерархии

С:

1.3

remove

public static MouseWheelListener remove(MouseWheelListener l,
                                        MouseWheelListener oldl)

Удаляет старого слушателя колеса мыши из mouse-wheel-listener-l и возвращает получившийся многоадресной слушатель.

Параметры:

l - mouse-wheel-listener-l

oldl - удаляемый слушатель колеса мыши

С:

1.4

addInternal

protected static EventListener addInternal(EventListener a,
                                           EventListener b)

Возвращает получившийся многоадресной слушатель от добавления listener-a и listener-b вместе. Если listener-a равен null, возвращает listener-b; Если listener-b равен null, возвращает listener-a. Если ни один из них не равен null, то создаётся и возвращается новый экземпляр AWTEventMulticaster, который связывает a с b.

Параметры:

a - слушатель события-a

b - слушатель события-b

removeInternal

protected static EventListener removeInternal(EventListener l,
                                              EventListener oldl)

Возвращает получившийся многоадресной слушатель после удаления старого слушателя из listener-l. Если listener-l равен старому слушателю ИЛИ listener-l равен null, возвращает null. В противном случае, если listener-l является экземпляром AWTEventMulticaster, то удаляет старый слушатель из него. В противном случае, возвращает listener l.

Параметры:

l - слушатель, из которого удаляется старое событие

oldl - удаляемый слушатель

saveInternal

protected void saveInternal(ObjectOutputStream s,
                            String k)
                     throws IOException

Исключения:

IOException

save

protected static void save(ObjectOutputStream s,
                           String k,
                           EventListener l)
                    throws IOException

Исключения:

IOException

getListeners

public static <T extends EventListener> T[] getListeners(EventListener l,
                                                         Class<T> listenerType)

Возвращает массив всех объектов, объединённых как FooListenerы, указанным java.util.EventListener. FooListenerы связываются через AWTEventMulticaster с помощью метода addFooListener. Если указан слушатель null, этот метод возвращает пустой массив. Если указанный слушатель не является экземпляром AWTEventMulticaster, этот метод возвращает массив, содержащий только указанного слушателя. Если такие слушатели не объединены, этот метод возвращает пустой массив.

Параметры:

l - указанный java.util.EventListener

listenerType - тип запрашиваемых слушателей; этот параметр должен указать интерфейс, который унаследован от java.util.EventListener

Возвращает:

массив всех объектов, объединённых как FooListenerы, указанным многоадресным слушателем, или пустой массив, если такие слушатели не объединены указанным многоадресным слушателем

Исключения:

NullPointerException - если указанный параметр listenertype имеет значение null

ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener

С:

1.4