dsto.dfc.util
Class EventListenerList

java.lang.Object
  dsto.dfc.util.EventListenerList

public class EventListenerList
extends Object

A generic list of event listeners.

Version:

$Revision: 1.18 $

Author:

mpp

Constructor Summary

EventListenerList()

Method Summary

void	addFirstListener(Object listener) Add listener to the front of the list, so it will get events before all other current listeners.
void	addListener(Object listener)
void	fireEvent(Class listenerClass, String eventType, EventObject event) Fire an event of a given type.
void	fireEvent(String eventType, EventObject event) Fire an event of a given type.
int	getEventNestingLevel() Get the current nesting level of the event chain.
Collection	getListeners()
boolean	hasListeners()
void	removeListener(Object listener)
int	size() Return the number of listeners in the list.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EventListenerList

public EventListenerList()

Method Detail

addListener

public void addListener(Object listener)

addFirstListener

public void addFirstListener(Object listener)

Add listener to the front of the list, so it will get events before all other current listeners. Since depending on listener order is usually a dodgy practice (and someone else could always use this call), use at your own risk.

removeListener

public void removeListener(Object listener)

hasListeners

public boolean hasListeners()

getListeners

public Collection getListeners()

size

public int size()

Return the number of listeners in the list.

getEventNestingLevel

public int getEventNestingLevel()

Get the current nesting level of the event chain. This can be used to determine whether a recursive or nested event is triggered by an event listener. Level == 0 when no event is being fired, level == 1 when an event is initially being fired, level > 1 for nested events.

fireEvent

public void fireEvent(String eventType,
                      EventObject event)

Fire an event of a given type. The type of listener interface is derived from the event class name.

Parameters:

eventType - The name of the method on the listener class eg "propertyChanged" or "mouseDown".

event - The event object to pass to listeners. The listener interface is derived from the event's class name: eg MouseEvent => MouseListener.

See Also:

fireEvent(Class, String, EventObject)

fireEvent

public void fireEvent(Class listenerClass,
                      String eventType,
                      EventObject event)

Fire an event of a given type.

Parameters:

listenerClass - The event listener interface class (eg PropertyChangeListener.class).

eventType - The name of the method on the listener class eg "propertyChanged" or "mouseDown".

event - The event object to pass to listeners.

See Also:

fireEvent(String, EventObject)