|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.awt.AWTEventMulticaster
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. However, event listeners added during the process of an event dispatch operation will not be notified of the event currently being dispatched. 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 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());
}
}
}
Field Summary | |
protected EventListener |
a
|
protected EventListener |
b
|
Constructor Summary | |
protected |
AWTEventMulticaster(EventListener a,
EventListener b)
Creates an event multicaster instance which chains listener-a with listener-b. |
Method Summary | |
void |
actionPerformed(ActionEvent e)
Handles the actionPerformed event by invoking the actionPerformed methods on listener-a and listener-b. |
static ActionListener |
add(ActionListener a,
ActionListener b)
Adds action-listener-a with action-listener-b and returns the resulting multicast listener. |
static AdjustmentListener |
add(AdjustmentListener a,
AdjustmentListener b)
Adds adjustment-listener-a with adjustment-listener-b and returns the resulting multicast listener. |
static ComponentListener |
add(ComponentListener a,
ComponentListener b)
Adds component-listener-a with component-listener-b and returns the resulting multicast listener. |
static ContainerListener |
add(ContainerListener a,
ContainerListener b)
Adds container-listener-a with container-listener-b and returns the resulting multicast listener. |
static FocusListener |
add(FocusListener a,
FocusListener b)
Adds focus-listener-a with focus-listener-b and returns the resulting multicast listener. |
static HierarchyBoundsListener |
add(HierarchyBoundsListener a,
HierarchyBoundsListener b)
Adds hierarchy-bounds-listener-a with hierarchy-bounds-listener-b and returns the resulting multicast listener. |
static HierarchyListener |
add(HierarchyListener a,
HierarchyListener b)
Adds hierarchy-listener-a with hierarchy-listener-b and returns the resulting multicast listener. |
static InputMethodListener |
add(InputMethodListener a,
InputMethodListener b)
Adds input-method-listener-a with input-method-listener-b and returns the resulting multicast listener. |
static ItemListener |
add(ItemListener a,
ItemListener b)
Adds item-listener-a with item-listener-b and returns the resulting multicast listener. |
static KeyListener |
add(KeyListener a,
KeyListener b)
Adds key-listener-a with key-listener-b and returns the resulting multicast listener. |
static MouseListener |
add(MouseListener a,
MouseListener b)
Adds mouse-listener-a with mouse-listener-b and returns the resulting multicast listener. |
static MouseMotionListener |
add(MouseMotionListener a,
MouseMotionListener b)
Adds mouse-motion-listener-a with mouse-motion-listener-b and returns the resulting multicast listener. |
static MouseWheelListener |
add(MouseWheelListener a,
MouseWheelListener b)
Adds mouse-wheel-listener-a with mouse-wheel-listener-b and returns the resulting multicast listener. |
static TextListener |
add(TextListener a,
TextListener b)
|
static WindowFocusListener |
add(WindowFocusListener a,
WindowFocusListener b)
Adds window-focus-listener-a with window-focus-listener-b and returns the resulting multicast listener. |
static WindowListener |
add(WindowListener a,
WindowListener b)
Adds window-listener-a with window-listener-b and returns the resulting multicast listener. |
static WindowStateListener |
add(WindowStateListener a,
WindowStateListener b)
Adds window-state-listener-a with window-state-listener-b and returns the resulting multicast listener. |
protected static EventListener |
addInternal(EventListener a,
EventListener b)
Returns the resulting multicast listener from adding listener-a and listener-b together. |
void |
adjustmentValueChanged(AdjustmentEvent e)
Handles the adjustmentValueChanged event by invoking the adjustmentValueChanged methods on listener-a and listener-b. |
void |
ancestorMoved(HierarchyEvent e)
Handles the ancestorMoved event by invoking the ancestorMoved methods on listener-a and listener-b. |
void |
ancestorResized(HierarchyEvent e)
Handles the ancestorResized event by invoking the ancestorResized methods on listener-a and listener-b. |
void |
caretPositionChanged(InputMethodEvent e)
Handles the caretPositionChanged event by invoking the caretPositionChanged methods on listener-a and listener-b. |
void |
componentAdded(ContainerEvent e)
Handles the componentAdded container event by invoking the componentAdded methods on listener-a and listener-b. |
void |
componentHidden(ComponentEvent e)
Handles the componentHidden event by invoking the componentHidden methods on listener-a and listener-b. |
void |
componentMoved(ComponentEvent e)
Handles the componentMoved event by invoking the componentMoved methods on listener-a and listener-b. |
void |
componentRemoved(ContainerEvent e)
Handles the componentRemoved container event by invoking the componentRemoved methods on listener-a and listener-b. |
void |
componentResized(ComponentEvent e)
Handles the componentResized event by invoking the componentResized methods on listener-a and listener-b. |
void |
componentShown(ComponentEvent e)
Handles the componentShown event by invoking the componentShown methods on listener-a and listener-b. |
void |
focusGained(FocusEvent e)
Handles the focusGained event by invoking the focusGained methods on listener-a and listener-b. |
void |
focusLost(FocusEvent e)
Handles the focusLost event by invoking the focusLost methods on listener-a and listener-b. |
private static int |
getListenerCount(EventListener l,
Class listenerType)
|
static EventListener[] |
getListeners(EventListener l,
Class listenerType)
Returns an array of all the objects chained as FooListener s by the specified
java.util.EventListener .
|
void |
hierarchyChanged(HierarchyEvent e)
Handles the hierarchyChanged event by invoking the hierarchyChanged methods on listener-a and listener-b. |
void |
inputMethodTextChanged(InputMethodEvent e)
Handles the inputMethodTextChanged event by invoking the inputMethodTextChanged methods on listener-a and listener-b. |
void |
itemStateChanged(ItemEvent e)
Handles the itemStateChanged event by invoking the itemStateChanged methods on listener-a and listener-b. |
void |
keyPressed(KeyEvent e)
Handles the keyPressed event by invoking the keyPressed methods on listener-a and listener-b. |
void |
keyReleased(KeyEvent e)
Handles the keyReleased event by invoking the keyReleased methods on listener-a and listener-b. |
void |
keyTyped(KeyEvent e)
Handles the keyTyped event by invoking the keyTyped methods on listener-a and listener-b. |
void |
mouseClicked(MouseEvent e)
Handles the mouseClicked event by invoking the mouseClicked methods on listener-a and listener-b. |
void |
mouseDragged(MouseEvent e)
Handles the mouseDragged event by invoking the mouseDragged methods on listener-a and listener-b. |
void |
mouseEntered(MouseEvent e)
Handles the mouseEntered event by invoking the mouseEntered methods on listener-a and listener-b. |
void |
mouseExited(MouseEvent e)
Handles the mouseExited event by invoking the mouseExited methods on listener-a and listener-b. |
void |
mouseMoved(MouseEvent e)
Handles the mouseMoved event by invoking the mouseMoved methods on listener-a and listener-b. |
void |
mousePressed(MouseEvent e)
Handles the mousePressed event by invoking the mousePressed methods on listener-a and listener-b. |
void |
mouseReleased(MouseEvent e)
Handles the mouseReleased event by invoking the mouseReleased methods on listener-a and listener-b. |
void |
mouseWheelMoved(MouseWheelEvent e)
Handles the mouseWheelMoved event by invoking the mouseWheelMoved methods on listener-a and listener-b. |
private static int |
populateListenerArray(EventListener[] a,
EventListener l,
int index)
|
static ActionListener |
remove(ActionListener l,
ActionListener oldl)
Removes the old action-listener from action-listener-l and returns the resulting multicast listener. |
static AdjustmentListener |
remove(AdjustmentListener l,
AdjustmentListener oldl)
Removes the old adjustment-listener from adjustment-listener-l and returns the resulting multicast listener. |
static ComponentListener |
remove(ComponentListener l,
ComponentListener oldl)
Removes the old component-listener from component-listener-l and returns the resulting multicast listener. |
static ContainerListener |
remove(ContainerListener l,
ContainerListener oldl)
Removes the old container-listener from container-listener-l and returns the resulting multicast listener. |
protected EventListener |
remove(EventListener oldl)
Removes a listener from this multicaster and returns the resulting multicast listener. |
static FocusListener |
remove(FocusListener l,
FocusListener oldl)
Removes the old focus-listener from focus-listener-l and returns the resulting multicast listener. |
static HierarchyBoundsListener |
remove(HierarchyBoundsListener l,
HierarchyBoundsListener oldl)
Removes the old hierarchy-bounds-listener from hierarchy-bounds-listener-l and returns the resulting multicast listener. |
static HierarchyListener |
remove(HierarchyListener l,
HierarchyListener oldl)
Removes the old hierarchy-listener from hierarchy-listener-l and returns the resulting multicast listener. |
static InputMethodListener |
remove(InputMethodListener l,
InputMethodListener oldl)
Removes the old input-method-listener from input-method-listener-l and returns the resulting multicast listener. |
static ItemListener |
remove(ItemListener l,
ItemListener oldl)
Removes the old item-listener from item-listener-l and returns the resulting multicast listener. |
static KeyListener |
remove(KeyListener l,
KeyListener oldl)
Removes the old key-listener from key-listener-l and returns the resulting multicast listener. |
static MouseListener |
remove(MouseListener l,
MouseListener oldl)
Removes the old mouse-listener from mouse-listener-l and returns the resulting multicast listener. |
static MouseMotionListener |
remove(MouseMotionListener l,
MouseMotionListener oldl)
Removes the old mouse-motion-listener from mouse-motion-listener-l and returns the resulting multicast listener. |
static MouseWheelListener |
remove(MouseWheelListener l,
MouseWheelListener oldl)
Removes the old mouse-wheel-listener from mouse-wheel-listener-l and returns the resulting multicast listener. |
static TextListener |
remove(TextListener l,
TextListener oldl)
|
static WindowFocusListener |
remove(WindowFocusListener l,
WindowFocusListener oldl)
Removes the old window-focus-listener from window-focus-listener-l and returns the resulting multicast listener. |
static WindowListener |
remove(WindowListener l,
WindowListener oldl)
Removes the old window-listener from window-listener-l and returns the resulting multicast listener. |
static WindowStateListener |
remove(WindowStateListener l,
WindowStateListener oldl)
Removes the old window-state-listener from window-state-listener-l and returns the resulting multicast listener. |
protected static EventListener |
removeInternal(EventListener l,
EventListener oldl)
Returns the resulting multicast listener after removing the old listener from listener-l. |
protected static void |
save(ObjectOutputStream s,
String k,
EventListener l)
|
protected void |
saveInternal(ObjectOutputStream s,
String k)
|
void |
textValueChanged(TextEvent e)
Invoked when the value of the text has changed. |
void |
windowActivated(WindowEvent e)
Handles the windowActivated event by invoking the windowActivated methods on listener-a and listener-b. |
void |
windowClosed(WindowEvent e)
Handles the windowClosed event by invoking the windowClosed methods on listener-a and listener-b. |
void |
windowClosing(WindowEvent e)
Handles the windowClosing event by invoking the windowClosing methods on listener-a and listener-b. |
void |
windowDeactivated(WindowEvent e)
Handles the windowDeactivated event by invoking the windowDeactivated methods on listener-a and listener-b. |
void |
windowDeiconified(WindowEvent e)
Handles the windowDeiconfied event by invoking the windowDeiconified methods on listener-a and listener-b. |
void |
windowGainedFocus(WindowEvent e)
Handles the windowGainedFocus event by invoking the windowGainedFocus methods on listener-a and listener-b. |
void |
windowIconified(WindowEvent e)
Handles the windowIconified event by invoking the windowIconified methods on listener-a and listener-b. |
void |
windowLostFocus(WindowEvent e)
Handles the windowLostFocus event by invoking the windowLostFocus methods on listener-a and listener-b. |
void |
windowOpened(WindowEvent e)
Handles the windowOpened event by invoking the windowOpened methods on listener-a and listener-b. |
void |
windowStateChanged(WindowEvent e)
Handles the windowStateChanged event by invoking the windowStateChanged methods on listener-a and listener-b. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
protected final EventListener a
protected final EventListener b
Constructor Detail |
protected AWTEventMulticaster(EventListener a, EventListener b)
a
and b
should not be null
, though implementations may vary in
choosing whether or not to throw NullPointerException
in that case.
a
- listener-ab
- listener-bMethod Detail |
protected EventListener remove(EventListener oldl)
oldl
- the listener to be removedpublic void componentResized(ComponentEvent e)
componentResized
in interface ComponentListener
e
- the component eventpublic void componentMoved(ComponentEvent e)
componentMoved
in interface ComponentListener
e
- the component eventpublic void componentShown(ComponentEvent e)
componentShown
in interface ComponentListener
e
- the component eventpublic void componentHidden(ComponentEvent e)
componentHidden
in interface ComponentListener
e
- the component eventpublic void componentAdded(ContainerEvent e)
componentAdded
in interface ContainerListener
e
- the component eventpublic void componentRemoved(ContainerEvent e)
componentRemoved
in interface ContainerListener
e
- the component eventpublic void focusGained(FocusEvent e)
focusGained
in interface FocusListener
e
- the focus eventpublic void focusLost(FocusEvent e)
focusLost
in interface FocusListener
e
- the focus eventpublic void keyTyped(KeyEvent e)
keyTyped
in interface KeyListener
e
- the key eventpublic void keyPressed(KeyEvent e)
keyPressed
in interface KeyListener
e
- the key eventpublic void keyReleased(KeyEvent e)
keyReleased
in interface KeyListener
e
- the key eventpublic void mouseClicked(MouseEvent e)
mouseClicked
in interface MouseListener
e
- the mouse eventpublic void mousePressed(MouseEvent e)
mousePressed
in interface MouseListener
e
- the mouse eventpublic void mouseReleased(MouseEvent e)
mouseReleased
in interface MouseListener
e
- the mouse eventpublic void mouseEntered(MouseEvent e)
mouseEntered
in interface MouseListener
e
- the mouse eventpublic void mouseExited(MouseEvent e)
mouseExited
in interface MouseListener
e
- the mouse eventpublic void mouseDragged(MouseEvent e)
mouseDragged
in interface MouseMotionListener
e
- the mouse eventpublic void mouseMoved(MouseEvent e)
mouseMoved
in interface MouseMotionListener
e
- the mouse eventpublic void windowOpened(WindowEvent e)
windowOpened
in interface WindowListener
e
- the window eventpublic void windowClosing(WindowEvent e)
windowClosing
in interface WindowListener
e
- the window eventpublic void windowClosed(WindowEvent e)
windowClosed
in interface WindowListener
e
- the window eventpublic void windowIconified(WindowEvent e)
windowIconified
in interface WindowListener
e
- the window eventFrame.setIconImage(java.awt.Image)
public void windowDeiconified(WindowEvent e)
windowDeiconified
in interface WindowListener
e
- the window eventpublic void windowActivated(WindowEvent e)
windowActivated
in interface WindowListener
e
- the window eventpublic void windowDeactivated(WindowEvent e)
windowDeactivated
in interface WindowListener
e
- the window eventpublic void windowStateChanged(WindowEvent e)
windowStateChanged
in interface WindowStateListener
e
- the window eventpublic void windowGainedFocus(WindowEvent e)
windowGainedFocus
in interface WindowFocusListener
e
- the window eventpublic void windowLostFocus(WindowEvent e)
windowLostFocus
in interface WindowFocusListener
e
- the window eventpublic void actionPerformed(ActionEvent e)
actionPerformed
in interface ActionListener
e
- the action eventpublic void itemStateChanged(ItemEvent e)
itemStateChanged
in interface ItemListener
e
- the item eventpublic void adjustmentValueChanged(AdjustmentEvent e)
adjustmentValueChanged
in interface AdjustmentListener
e
- the adjustment eventpublic void textValueChanged(TextEvent e)
TextListener
textValueChanged
in interface TextListener
public void inputMethodTextChanged(InputMethodEvent e)
inputMethodTextChanged
in interface InputMethodListener
e
- the item eventpublic void caretPositionChanged(InputMethodEvent e)
caretPositionChanged
in interface InputMethodListener
e
- the item eventpublic void hierarchyChanged(HierarchyEvent e)
hierarchyChanged
in interface HierarchyListener
e
- the item eventHierarchyEvent.getChangeFlags()
public void ancestorMoved(HierarchyEvent e)
ancestorMoved
in interface HierarchyBoundsListener
e
- the item eventpublic void ancestorResized(HierarchyEvent e)
ancestorResized
in interface HierarchyBoundsListener
e
- the item eventpublic void mouseWheelMoved(MouseWheelEvent e)
mouseWheelMoved
in interface MouseWheelListener
e
- the mouse eventMouseWheelEvent
public static ComponentListener add(ComponentListener a, ComponentListener b)
a
- component-listener-ab
- component-listener-bpublic static ContainerListener add(ContainerListener a, ContainerListener b)
a
- container-listener-ab
- container-listener-bpublic static FocusListener add(FocusListener a, FocusListener b)
a
- focus-listener-ab
- focus-listener-bpublic static KeyListener add(KeyListener a, KeyListener b)
a
- key-listener-ab
- key-listener-bpublic static MouseListener add(MouseListener a, MouseListener b)
a
- mouse-listener-ab
- mouse-listener-bpublic static MouseMotionListener add(MouseMotionListener a, MouseMotionListener b)
a
- mouse-motion-listener-ab
- mouse-motion-listener-bpublic static WindowListener add(WindowListener a, WindowListener b)
a
- window-listener-ab
- window-listener-bpublic static WindowStateListener add(WindowStateListener a, WindowStateListener b)
a
- window-state-listener-ab
- window-state-listener-bpublic static WindowFocusListener add(WindowFocusListener a, WindowFocusListener b)
a
- window-focus-listener-ab
- window-focus-listener-bpublic static ActionListener add(ActionListener a, ActionListener b)
a
- action-listener-ab
- action-listener-bpublic static ItemListener add(ItemListener a, ItemListener b)
a
- item-listener-ab
- item-listener-bpublic static AdjustmentListener add(AdjustmentListener a, AdjustmentListener b)
a
- adjustment-listener-ab
- adjustment-listener-bpublic static TextListener add(TextListener a, TextListener b)
public static InputMethodListener add(InputMethodListener a, InputMethodListener b)
a
- input-method-listener-ab
- input-method-listener-bpublic static HierarchyListener add(HierarchyListener a, HierarchyListener b)
a
- hierarchy-listener-ab
- hierarchy-listener-bpublic static HierarchyBoundsListener add(HierarchyBoundsListener a, HierarchyBoundsListener b)
a
- hierarchy-bounds-listener-ab
- hierarchy-bounds-listener-bpublic static MouseWheelListener add(MouseWheelListener a, MouseWheelListener b)
a
- mouse-wheel-listener-ab
- mouse-wheel-listener-bpublic static ComponentListener remove(ComponentListener l, ComponentListener oldl)
l
- component-listener-loldl
- the component-listener being removedpublic static ContainerListener remove(ContainerListener l, ContainerListener oldl)
l
- container-listener-loldl
- the container-listener being removedpublic static FocusListener remove(FocusListener l, FocusListener oldl)
l
- focus-listener-loldl
- the focus-listener being removedpublic static KeyListener remove(KeyListener l, KeyListener oldl)
l
- key-listener-loldl
- the key-listener being removedpublic static MouseListener remove(MouseListener l, MouseListener oldl)
l
- mouse-listener-loldl
- the mouse-listener being removedpublic static MouseMotionListener remove(MouseMotionListener l, MouseMotionListener oldl)
l
- mouse-motion-listener-loldl
- the mouse-motion-listener being removedpublic static WindowListener remove(WindowListener l, WindowListener oldl)
l
- window-listener-loldl
- the window-listener being removedpublic static WindowStateListener remove(WindowStateListener l, WindowStateListener oldl)
l
- window-state-listener-loldl
- the window-state-listener being removedpublic static WindowFocusListener remove(WindowFocusListener l, WindowFocusListener oldl)
l
- window-focus-listener-loldl
- the window-focus-listener being removedpublic static ActionListener remove(ActionListener l, ActionListener oldl)
l
- action-listener-loldl
- the action-listener being removedpublic static ItemListener remove(ItemListener l, ItemListener oldl)
l
- item-listener-loldl
- the item-listener being removedpublic static AdjustmentListener remove(AdjustmentListener l, AdjustmentListener oldl)
l
- adjustment-listener-loldl
- the adjustment-listener being removedpublic static TextListener remove(TextListener l, TextListener oldl)
public static InputMethodListener remove(InputMethodListener l, InputMethodListener oldl)
l
- input-method-listener-loldl
- the input-method-listener being removedpublic static HierarchyListener remove(HierarchyListener l, HierarchyListener oldl)
l
- hierarchy-listener-loldl
- the hierarchy-listener being removedpublic static HierarchyBoundsListener remove(HierarchyBoundsListener l, HierarchyBoundsListener oldl)
l
- hierarchy-bounds-listener-loldl
- the hierarchy-bounds-listener being removedpublic static MouseWheelListener remove(MouseWheelListener l, MouseWheelListener oldl)
l
- mouse-wheel-listener-loldl
- the mouse-wheel-listener being removedprotected static EventListener addInternal(EventListener a, EventListener b)
a
- event listener-ab
- event listener-bprotected static EventListener removeInternal(EventListener l, EventListener oldl)
l
- the listener being removed fromoldl
- the listener being removedprotected void saveInternal(ObjectOutputStream s, String k) throws IOException
IOException
protected static void save(ObjectOutputStream s, String k, EventListener l) throws IOException
IOException
private static int getListenerCount(EventListener l, Class listenerType)
private static int populateListenerArray(EventListener[] a, EventListener l, int index)
public static EventListener[] getListeners(EventListener l, Class listenerType)
FooListener
s by the specified
java.util.EventListener
.
FooListener
s are chained by the
AWTEventMulticaster
using the
addFooListener
method.
If a null
listener is specified, this method returns an
empty array. If the specified listener is not an instance of
AWTEventMulticaster
, this method returns an array which
contains only the specified listener. If no such listeners are chanined,
this method returns an empty array.
l
- the specified java.util.EventListener
listenerType
- the type of listeners requested; this parameter
should specify an interface that descends from
java.util.EventListener
FooListener
s by the specified multicast
listener, or an empty array if no such listeners have been
chained by the specified multicast listener
ClassCastException
- if listenerType
doesn't specify a class or interface that implements
java.util.EventListener
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |