Class java.awt.AWTEventMulticaster
java.lang.Object
|
+----java.awt.AWTEventMulticaster
- public class AWTEventMulticaster
- extends Object
- implements ComponentListener, ContainerListener, FocusListener, KeyListener, MouseListener, MouseMotionListener, WindowListener, ActionListener, ItemListener, AdjustmentListener, TextListener
A class which implements efficient and thread-safe multi-cast event
dispatching for the AWT events defined in the java.awt.event package.
This class will manage an immutable structure consisting of a chain of
event listeners and will dispatch events to those listeners. Because
the structure is immutable, it is safe to use this API to add/remove
listeners during the process of an event dispatch operation.
An example of how this class could be used to implement a new
component which fires "action" events:
public myComponent extends Component {
ActionListener actionListener = null;
public void addActionListener(ActionListener l) {
actionListener = AWTEventMulticaster.add(actionListener, l);
}
public void removeActionListener(ActionListener l) {
actionListener = AWTEventMulticaster.remove(actionListener, l);
}
public void processEvent(AWTEvent e) {
// when event occurs which causes "action" semantic
if (actionListener != null) {
actionListener.actionPerformed(new ActionEvent());
}
}
Variable Index
- a
-
- b
-
Constructor Index
- AWTEventMulticaster(EventListener, EventListener)
- Creates an event multicaster instance which chains listener-a
with listener-b.
Method Index
- actionPerformed(ActionEvent)
- Handles the actionPerformed event by invoking the
actionPerformed methods on listener-a and listener-b.
- add(ActionListener, ActionListener)
- Adds action-listener-a with action-listener-b and
returns the resulting multicast listener.
- add(AdjustmentListener, AdjustmentListener)
- Adds adjustment-listener-a with adjustment-listener-b and
returns the resulting multicast listener.
- add(ComponentListener, ComponentListener)
- Adds component-listener-a with component-listener-b and
returns the resulting multicast listener.
- add(ContainerListener, ContainerListener)
- Adds container-listener-a with container-listener-b and
returns the resulting multicast listener.
- add(FocusListener, FocusListener)
- Adds focus-listener-a with focus-listener-b and
returns the resulting multicast listener.
- add(ItemListener, ItemListener)
- Adds item-listener-a with item-listener-b and
returns the resulting multicast listener.
- add(KeyListener, KeyListener)
- Adds key-listener-a with key-listener-b and
returns the resulting multicast listener.
- add(MouseListener, MouseListener)
- Adds mouse-listener-a with mouse-listener-b and
returns the resulting multicast listener.
- add(MouseMotionListener, MouseMotionListener)
- Adds mouse-motion-listener-a with mouse-motion-listener-b and
returns the resulting multicast listener.
- add(TextListener, TextListener)
-
- add(WindowListener, WindowListener)
- Adds window-listener-a with window-listener-b and
returns the resulting multicast listener.
- addInternal(EventListener, EventListener)
-
Returns the resulting multicast listener from adding listener-a
and listener-b together.
- adjustmentValueChanged(AdjustmentEvent)
- Handles the adjustmentValueChanged event by invoking the
adjustmentValueChanged methods on listener-a and listener-b.
- componentAdded(ContainerEvent)
- Handles the componentAdded container event by invoking the
componentAdded methods on listener-a and listener-b.
- componentHidden(ComponentEvent)
- Handles the componentHidden event by invoking the
componentHidden methods on listener-a and listener-b.
- componentMoved(ComponentEvent)
- Handles the componentMoved event by invoking the
componentMoved methods on listener-a and listener-b.
- componentRemoved(ContainerEvent)
- Handles the componentRemoved container event by invoking the
componentRemoved methods on listener-a and listener-b.
- componentResized(ComponentEvent)
- Handles the componentResized event by invoking the
componentResized methods on listener-a and listener-b.
- componentShown(ComponentEvent)
- Handles the componentShown event by invoking the
componentShown methods on listener-a and listener-b.
- focusGained(FocusEvent)
- Handles the focusGained event by invoking the
focusGained methods on listener-a and listener-b.
- focusLost(FocusEvent)
- Handles the focusLost event by invoking the
focusLost methods on listener-a and listener-b.
- itemStateChanged(ItemEvent)
- Handles the itemStateChanged event by invoking the
itemStateChanged methods on listener-a and listener-b.
- keyPressed(KeyEvent)
- Handles the keyPressed event by invoking the
keyPressed methods on listener-a and listener-b.
- keyReleased(KeyEvent)
- Handles the keyReleased event by invoking the
keyReleased methods on listener-a and listener-b.
- keyTyped(KeyEvent)
- Handles the keyTyped event by invoking the
keyTyped methods on listener-a and listener-b.
- mouseClicked(MouseEvent)
- Handles the mouseClicked event by invoking the
mouseClicked methods on listener-a and listener-b.
- mouseDragged(MouseEvent)
- Handles the mouseDragged event by invoking the
mouseDragged methods on listener-a and listener-b.
- mouseEntered(MouseEvent)
- Handles the mouseEntered event by invoking the
mouseEntered methods on listener-a and listener-b.
- mouseExited(MouseEvent)
- Handles the mouseExited event by invoking the
mouseExited methods on listener-a and listener-b.
- mouseMoved(MouseEvent)
- Handles the mouseMoved event by invoking the
mouseMoved methods on listener-a and listener-b.
- mousePressed(MouseEvent)
- Handles the mousePressed event by invoking the
mousePressed methods on listener-a and listener-b.
- mouseReleased(MouseEvent)
- Handles the mouseReleased event by invoking the
mouseReleased methods on listener-a and listener-b.
- remove(ActionListener, ActionListener)
- Removes the old action-listener from action-listener-l and
returns the resulting multicast listener.
- remove(AdjustmentListener, AdjustmentListener)
- Removes the old adjustment-listener from adjustment-listener-l and
returns the resulting multicast listener.
- remove(ComponentListener, ComponentListener)
- Removes the old component-listener from component-listener-l and
returns the resulting multicast listener.
- remove(ContainerListener, ContainerListener)
- Removes the old container-listener from container-listener-l and
returns the resulting multicast listener.
- remove(EventListener)
- Removes a listener from this multicaster and returns the
resulting multicast listener.
- remove(FocusListener, FocusListener)
- Removes the old focus-listener from focus-listener-l and
returns the resulting multicast listener.
- remove(ItemListener, ItemListener)
- Removes the old item-listener from item-listener-l and
returns the resulting multicast listener.
- remove(KeyListener, KeyListener)
- Removes the old key-listener from key-listener-l and
returns the resulting multicast listener.
- remove(MouseListener, MouseListener)
- Removes the old mouse-listener from mouse-listener-l and
returns the resulting multicast listener.
- remove(MouseMotionListener, MouseMotionListener)
- Removes the old mouse-motion-listener from mouse-motion-listener-l
and returns the resulting multicast listener.
- remove(TextListener, TextListener)
-
- remove(WindowListener, WindowListener)
- Removes the old window-listener from window-listener-l and
returns the resulting multicast listener.
- removeInternal(EventListener, EventListener)
-
Returns the resulting multicast listener after removing the
old listener from listener-l.
- save(ObjectOutputStream, String, EventListener)
-
- saveInternal(ObjectOutputStream, String)
-
- textValueChanged(TextEvent)
-
- windowActivated(WindowEvent)
- Handles the windowActivated event by invoking the
windowActivated methods on listener-a and listener-b.
- windowClosed(WindowEvent)
- Handles the windowClosed event by invoking the
windowClosed methods on listener-a and listener-b.
- windowClosing(WindowEvent)
- Handles the windowClosing event by invoking the
windowClosing methods on listener-a and listener-b.
- windowDeactivated(WindowEvent)
- Handles the windowDeactivated event by invoking the
windowDeactivated methods on listener-a and listener-b.
- windowDeiconified(WindowEvent)
- Handles the windowDeiconfied event by invoking the
windowDeiconified methods on listener-a and listener-b.
- windowIconified(WindowEvent)
- Handles the windowIconified event by invoking the
windowIconified methods on listener-a and listener-b.
- windowOpened(WindowEvent)
- Handles the windowOpened event by invoking the
windowOpened methods on listener-a and listener-b.
Variables
a
protected final EventListener a
b
protected final EventListener b
Constructors
AWTEventMulticaster
protected AWTEventMulticaster(EventListener a,
EventListener b)
- Creates an event multicaster instance which chains listener-a
with listener-b.
- Parameters:
- a - listener-a
- b - listener-b
Methods
remove
protected EventListener remove(EventListener oldl)
- Removes a listener from this multicaster and returns the
resulting multicast listener.
- Parameters:
- oldl - the listener to be removed
componentResized
public void componentResized(ComponentEvent e)
- Handles the componentResized event by invoking the
componentResized methods on listener-a and listener-b.
- Parameters:
- e - the component event
componentMoved
public void componentMoved(ComponentEvent e)
- Handles the componentMoved event by invoking the
componentMoved methods on listener-a and listener-b.
- Parameters:
- e - the component event
componentShown
public void componentShown(ComponentEvent e)
- Handles the componentShown event by invoking the
componentShown methods on listener-a and listener-b.
- Parameters:
- e - the component event
componentHidden
public void componentHidden(ComponentEvent e)
- Handles the componentHidden event by invoking the
componentHidden methods on listener-a and listener-b.
- Parameters:
- e - the component event
componentAdded
public void componentAdded(ContainerEvent e)
- Handles the componentAdded container event by invoking the
componentAdded methods on listener-a and listener-b.
- Parameters:
- e - the component event
componentRemoved
public void componentRemoved(ContainerEvent e)
- Handles the componentRemoved container event by invoking the
componentRemoved methods on listener-a and listener-b.
- Parameters:
- e - the component event
focusGained
public void focusGained(FocusEvent e)
- Handles the focusGained event by invoking the
focusGained methods on listener-a and listener-b.
- Parameters:
- e - the focus event
focusLost
public void focusLost(FocusEvent e)
- Handles the focusLost event by invoking the
focusLost methods on listener-a and listener-b.
- Parameters:
- e - the focus event
keyTyped
public void keyTyped(KeyEvent e)
- Handles the keyTyped event by invoking the
keyTyped methods on listener-a and listener-b.
- Parameters:
- e - the key event
keyPressed
public void keyPressed(KeyEvent e)
- Handles the keyPressed event by invoking the
keyPressed methods on listener-a and listener-b.
- Parameters:
- e - the key event
keyReleased
public void keyReleased(KeyEvent e)
- Handles the keyReleased event by invoking the
keyReleased methods on listener-a and listener-b.
- Parameters:
- e - the key event
mouseClicked
public void mouseClicked(MouseEvent e)
- Handles the mouseClicked event by invoking the
mouseClicked methods on listener-a and listener-b.
- Parameters:
- e - the mouse event
mousePressed
public void mousePressed(MouseEvent e)
- Handles the mousePressed event by invoking the
mousePressed methods on listener-a and listener-b.
- Parameters:
- e - the mouse event
mouseReleased
public void mouseReleased(MouseEvent e)
- Handles the mouseReleased event by invoking the
mouseReleased methods on listener-a and listener-b.
- Parameters:
- e - the mouse event
mouseEntered
public void mouseEntered(MouseEvent e)
- Handles the mouseEntered event by invoking the
mouseEntered methods on listener-a and listener-b.
- Parameters:
- e - the mouse event
mouseExited
public void mouseExited(MouseEvent e)
- Handles the mouseExited event by invoking the
mouseExited methods on listener-a and listener-b.
- Parameters:
- e - the mouse event
mouseDragged
public void mouseDragged(MouseEvent e)
- Handles the mouseDragged event by invoking the
mouseDragged methods on listener-a and listener-b.
- Parameters:
- e - the mouse event
mouseMoved
public void mouseMoved(MouseEvent e)
- Handles the mouseMoved event by invoking the
mouseMoved methods on listener-a and listener-b.
- Parameters:
- e - the mouse event
windowOpened
public void windowOpened(WindowEvent e)
- Handles the windowOpened event by invoking the
windowOpened methods on listener-a and listener-b.
- Parameters:
- e - the window event
windowClosing
public void windowClosing(WindowEvent e)
- Handles the windowClosing event by invoking the
windowClosing methods on listener-a and listener-b.
- Parameters:
- e - the window event
windowClosed
public void windowClosed(WindowEvent e)
- Handles the windowClosed event by invoking the
windowClosed methods on listener-a and listener-b.
- Parameters:
- e - the window event
windowIconified
public void windowIconified(WindowEvent e)
- Handles the windowIconified event by invoking the
windowIconified methods on listener-a and listener-b.
- Parameters:
- e - the window event
windowDeiconified
public void windowDeiconified(WindowEvent e)
- Handles the windowDeiconfied event by invoking the
windowDeiconified methods on listener-a and listener-b.
- Parameters:
- e - the window event
windowActivated
public void windowActivated(WindowEvent e)
- Handles the windowActivated event by invoking the
windowActivated methods on listener-a and listener-b.
- Parameters:
- e - the window event
windowDeactivated
public void windowDeactivated(WindowEvent e)
- Handles the windowDeactivated event by invoking the
windowDeactivated methods on listener-a and listener-b.
- Parameters:
- e - the window event
actionPerformed
public void actionPerformed(ActionEvent e)
- Handles the actionPerformed event by invoking the
actionPerformed methods on listener-a and listener-b.
- Parameters:
- e - the action event
itemStateChanged
public void itemStateChanged(ItemEvent e)
- Handles the itemStateChanged event by invoking the
itemStateChanged methods on listener-a and listener-b.
- Parameters:
- e - the item event
adjustmentValueChanged
public void adjustmentValueChanged(AdjustmentEvent e)
- Handles the adjustmentValueChanged event by invoking the
adjustmentValueChanged methods on listener-a and listener-b.
- Parameters:
- e - the adjustment event
textValueChanged
public void textValueChanged(TextEvent e)
add
public static ComponentListener add(ComponentListener a,
ComponentListener b)
- Adds component-listener-a with component-listener-b and
returns the resulting multicast listener.
- Parameters:
- a - component-listener-a
- b - component-listener-b
add
public static ContainerListener add(ContainerListener a,
ContainerListener b)
- Adds container-listener-a with container-listener-b and
returns the resulting multicast listener.
- Parameters:
- a - container-listener-a
- b - container-listener-b
add
public static FocusListener add(FocusListener a,
FocusListener b)
- Adds focus-listener-a with focus-listener-b and
returns the resulting multicast listener.
- Parameters:
- a - focus-listener-a
- b - focus-listener-b
add
public static KeyListener add(KeyListener a,
KeyListener b)
- Adds key-listener-a with key-listener-b and
returns the resulting multicast listener.
- Parameters:
- a - key-listener-a
- b - key-listener-b
add
public static MouseListener add(MouseListener a,
MouseListener b)
- Adds mouse-listener-a with mouse-listener-b and
returns the resulting multicast listener.
- Parameters:
- a - mouse-listener-a
- b - mouse-listener-b
add
public static MouseMotionListener add(MouseMotionListener a,
MouseMotionListener b)
- Adds mouse-motion-listener-a with mouse-motion-listener-b and
returns the resulting multicast listener.
- Parameters:
- a - mouse-motion-listener-a
- b - mouse-motion-listener-b
add
public static WindowListener add(WindowListener a,
WindowListener b)
- Adds window-listener-a with window-listener-b and
returns the resulting multicast listener.
- Parameters:
- a - window-listener-a
- b - window-listener-b
add
public static ActionListener add(ActionListener a,
ActionListener b)
- Adds action-listener-a with action-listener-b and
returns the resulting multicast listener.
- Parameters:
- a - action-listener-a
- b - action-listener-b
add
public static ItemListener add(ItemListener a,
ItemListener b)
- Adds item-listener-a with item-listener-b and
returns the resulting multicast listener.
- Parameters:
- a - item-listener-a
- b - item-listener-b
add
public static AdjustmentListener add(AdjustmentListener a,
AdjustmentListener b)
- Adds adjustment-listener-a with adjustment-listener-b and
returns the resulting multicast listener.
- Parameters:
- a - adjustment-listener-a
- b - adjustment-listener-b
add
public static TextListener add(TextListener a,
TextListener b)
remove
public static ComponentListener remove(ComponentListener l,
ComponentListener oldl)
- Removes the old component-listener from component-listener-l and
returns the resulting multicast listener.
- Parameters:
- l - component-listener-l
- oldl - the component-listener being removed
remove
public static ContainerListener remove(ContainerListener l,
ContainerListener oldl)
- Removes the old container-listener from container-listener-l and
returns the resulting multicast listener.
- Parameters:
- l - container-listener-l
- oldl - the container-listener being removed
remove
public static FocusListener remove(FocusListener l,
FocusListener oldl)
- Removes the old focus-listener from focus-listener-l and
returns the resulting multicast listener.
- Parameters:
- l - focus-listener-l
- oldl - the focus-listener being removed
remove
public static KeyListener remove(KeyListener l,
KeyListener oldl)
- Removes the old key-listener from key-listener-l and
returns the resulting multicast listener.
- Parameters:
- l - key-listener-l
- oldl - the key-listener being removed
remove
public static MouseListener remove(MouseListener l,
MouseListener oldl)
- Removes the old mouse-listener from mouse-listener-l and
returns the resulting multicast listener.
- Parameters:
- l - mouse-listener-l
- oldl - the mouse-listener being removed
remove
public static MouseMotionListener remove(MouseMotionListener l,
MouseMotionListener oldl)
- Removes the old mouse-motion-listener from mouse-motion-listener-l
and returns the resulting multicast listener.
- Parameters:
- l - mouse-motion-listener-l
- oldl - the mouse-motion-listener being removed
remove
public static WindowListener remove(WindowListener l,
WindowListener oldl)
- Removes the old window-listener from window-listener-l and
returns the resulting multicast listener.
- Parameters:
- l - window-listener-l
- oldl - the window-listener being removed
remove
public static ActionListener remove(ActionListener l,
ActionListener oldl)
- Removes the old action-listener from action-listener-l and
returns the resulting multicast listener.
- Parameters:
- l - action-listener-l
- oldl - the action-listener being removed
remove
public static ItemListener remove(ItemListener l,
ItemListener oldl)
- Removes the old item-listener from item-listener-l and
returns the resulting multicast listener.
- Parameters:
- l - item-listener-l
- oldl - the item-listener being removed
remove
public static AdjustmentListener remove(AdjustmentListener l,
AdjustmentListener oldl)
- Removes the old adjustment-listener from adjustment-listener-l and
returns the resulting multicast listener.
- Parameters:
- l - adjustment-listener-l
- oldl - the adjustment-listener being removed
remove
public static TextListener remove(TextListener l,
TextListener oldl)
addInternal
protected static EventListener addInternal(EventListener a,
EventListener b)
- Returns the resulting multicast listener from adding listener-a
and listener-b together.
If listener-a is null, it returns listener-b;
If listener-b is null, it returns listener-a
If neither are null, then it creates and returns
a new AWTEventMulticaster instance which chains a with b.
- Parameters:
- a - event listener-a
- b - event listener-b
removeInternal
protected static EventListener removeInternal(EventListener l,
EventListener oldl)
- Returns the resulting multicast listener after removing the
old listener from listener-l.
If listener-l equals the old listener OR listener-l is null,
returns null.
Else if listener-l is an instance of AWTEventMulticaster,
then it removes the old listener from it.
Else, returns listener l.
- Parameters:
- l - the listener being removed from
- oldl - the listener being removed
saveInternal
protected void saveInternal(ObjectOutputStream s,
String k) throws IOException
save
protected static void save(ObjectOutputStream s,
String k,
EventListener l) throws IOException
