All Packages  Class Hierarchy  This Package  Previous  Next  Index

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

o a
o b

Constructor Index

o AWTEventMulticaster(EventListener, EventListener)
Creates an event multicaster instance which chains listener-a with listener-b.

Method Index

o actionPerformed(ActionEvent)
Handles the actionPerformed event by invoking the actionPerformed methods on listener-a and listener-b.
o add(ActionListener, ActionListener)
Adds action-listener-a with action-listener-b and returns the resulting multicast listener.
o add(AdjustmentListener, AdjustmentListener)
Adds adjustment-listener-a with adjustment-listener-b and returns the resulting multicast listener.
o add(ComponentListener, ComponentListener)
Adds component-listener-a with component-listener-b and returns the resulting multicast listener.
o add(ContainerListener, ContainerListener)
Adds container-listener-a with container-listener-b and returns the resulting multicast listener.
o add(FocusListener, FocusListener)
Adds focus-listener-a with focus-listener-b and returns the resulting multicast listener.
o add(ItemListener, ItemListener)
Adds item-listener-a with item-listener-b and returns the resulting multicast listener.
o add(KeyListener, KeyListener)
Adds key-listener-a with key-listener-b and returns the resulting multicast listener.
o add(MouseListener, MouseListener)
Adds mouse-listener-a with mouse-listener-b and returns the resulting multicast listener.
o add(MouseMotionListener, MouseMotionListener)
Adds mouse-motion-listener-a with mouse-motion-listener-b and returns the resulting multicast listener.
o add(TextListener, TextListener)
o add(WindowListener, WindowListener)
Adds window-listener-a with window-listener-b and returns the resulting multicast listener.
o addInternal(EventListener, EventListener)
Returns the resulting multicast listener from adding listener-a and listener-b together.
o adjustmentValueChanged(AdjustmentEvent)
Handles the adjustmentValueChanged event by invoking the adjustmentValueChanged methods on listener-a and listener-b.
o componentAdded(ContainerEvent)
Handles the componentAdded container event by invoking the componentAdded methods on listener-a and listener-b.
o componentHidden(ComponentEvent)
Handles the componentHidden event by invoking the componentHidden methods on listener-a and listener-b.
o componentMoved(ComponentEvent)
Handles the componentMoved event by invoking the componentMoved methods on listener-a and listener-b.
o componentRemoved(ContainerEvent)
Handles the componentRemoved container event by invoking the componentRemoved methods on listener-a and listener-b.
o componentResized(ComponentEvent)
Handles the componentResized event by invoking the componentResized methods on listener-a and listener-b.
o componentShown(ComponentEvent)
Handles the componentShown event by invoking the componentShown methods on listener-a and listener-b.
o focusGained(FocusEvent)
Handles the focusGained event by invoking the focusGained methods on listener-a and listener-b.
o focusLost(FocusEvent)
Handles the focusLost event by invoking the focusLost methods on listener-a and listener-b.
o itemStateChanged(ItemEvent)
Handles the itemStateChanged event by invoking the itemStateChanged methods on listener-a and listener-b.
o keyPressed(KeyEvent)
Handles the keyPressed event by invoking the keyPressed methods on listener-a and listener-b.
o keyReleased(KeyEvent)
Handles the keyReleased event by invoking the keyReleased methods on listener-a and listener-b.
o keyTyped(KeyEvent)
Handles the keyTyped event by invoking the keyTyped methods on listener-a and listener-b.
o mouseClicked(MouseEvent)
Handles the mouseClicked event by invoking the mouseClicked methods on listener-a and listener-b.
o mouseDragged(MouseEvent)
Handles the mouseDragged event by invoking the mouseDragged methods on listener-a and listener-b.
o mouseEntered(MouseEvent)
Handles the mouseEntered event by invoking the mouseEntered methods on listener-a and listener-b.
o mouseExited(MouseEvent)
Handles the mouseExited event by invoking the mouseExited methods on listener-a and listener-b.
o mouseMoved(MouseEvent)
Handles the mouseMoved event by invoking the mouseMoved methods on listener-a and listener-b.
o mousePressed(MouseEvent)
Handles the mousePressed event by invoking the mousePressed methods on listener-a and listener-b.
o mouseReleased(MouseEvent)
Handles the mouseReleased event by invoking the mouseReleased methods on listener-a and listener-b.
o remove(ActionListener, ActionListener)
Removes the old action-listener from action-listener-l and returns the resulting multicast listener.
o remove(AdjustmentListener, AdjustmentListener)
Removes the old adjustment-listener from adjustment-listener-l and returns the resulting multicast listener.
o remove(ComponentListener, ComponentListener)
Removes the old component-listener from component-listener-l and returns the resulting multicast listener.
o remove(ContainerListener, ContainerListener)
Removes the old container-listener from container-listener-l and returns the resulting multicast listener.
o remove(EventListener)
Removes a listener from this multicaster and returns the resulting multicast listener.
o remove(FocusListener, FocusListener)
Removes the old focus-listener from focus-listener-l and returns the resulting multicast listener.
o remove(ItemListener, ItemListener)
Removes the old item-listener from item-listener-l and returns the resulting multicast listener.
o remove(KeyListener, KeyListener)
Removes the old key-listener from key-listener-l and returns the resulting multicast listener.
o remove(MouseListener, MouseListener)
Removes the old mouse-listener from mouse-listener-l and returns the resulting multicast listener.
o remove(MouseMotionListener, MouseMotionListener)
Removes the old mouse-motion-listener from mouse-motion-listener-l and returns the resulting multicast listener.
o remove(TextListener, TextListener)
o remove(WindowListener, WindowListener)
Removes the old window-listener from window-listener-l and returns the resulting multicast listener.
o removeInternal(EventListener, EventListener)
Returns the resulting multicast listener after removing the old listener from listener-l.
o save(ObjectOutputStream, String, EventListener)
o saveInternal(ObjectOutputStream, String)
o textValueChanged(TextEvent)
o windowActivated(WindowEvent)
Handles the windowActivated event by invoking the windowActivated methods on listener-a and listener-b.
o windowClosed(WindowEvent)
Handles the windowClosed event by invoking the windowClosed methods on listener-a and listener-b.
o windowClosing(WindowEvent)
Handles the windowClosing event by invoking the windowClosing methods on listener-a and listener-b.
o windowDeactivated(WindowEvent)
Handles the windowDeactivated event by invoking the windowDeactivated methods on listener-a and listener-b.
o windowDeiconified(WindowEvent)
Handles the windowDeiconfied event by invoking the windowDeiconified methods on listener-a and listener-b.
o windowIconified(WindowEvent)
Handles the windowIconified event by invoking the windowIconified methods on listener-a and listener-b.
o windowOpened(WindowEvent)
Handles the windowOpened event by invoking the windowOpened methods on listener-a and listener-b.

Variables

o a 
 protected final EventListener a
o b 
 protected final EventListener b

Constructors

o 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

o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o textValueChanged 
 public void textValueChanged(TextEvent e)
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o add 
 public static TextListener add(TextListener a,
                                TextListener b)
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o 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
o remove 
 public static TextListener remove(TextListener l,
                                   TextListener oldl)
o 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
o 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
o saveInternal 
 protected void saveInternal(ObjectOutputStream s,
                             String k) throws IOException
o save 
 protected static void save(ObjectOutputStream s,
                            String k,
                            EventListener l) throws IOException

All Packages  Class Hierarchy  This Package  Previous  Next  Index