public class EventSource
extends java.lang.Object
Modifier and Type | Field and Description |
---|---|
protected java.util.concurrent.atomic.AtomicInteger |
deadListenerCount |
protected int |
deadListenerTreshold |
protected java.util.List<java.lang.Object> |
eventListeners
Storage for registered listeners and the events they
are listening to in the format
..[event_name][listener]..
|
protected boolean |
eventsEnabled
Flag to enable or disable firing of events.
|
protected java.lang.Object |
eventSource
Optional source to be used when firing event objects.
|
Constructor and Description |
---|
EventSource()
Constructs a new event source using this as the source object.
|
EventSource(java.lang.Object source)
Constructs a new event source for the given source object.
|
Modifier and Type | Method and Description |
---|---|
void |
addListener(java.lang.String eventName,
EventListener listener)
Registers the given
listener for events of the
specified eventName or as a listener for all
events in the case the eventName parameter is null |
protected void |
clearEventListeners() |
void |
fireEvent(EventObject event)
Fires the given
event using this object as source
for the call to EventListener.invoke(Object, EventObject) }
if no source was specified by setEventSource(Object) |
void |
fireEvent(EventObject event,
java.lang.Object sender)
Dispatches the given
event to all registered EventListener s
that listen to the name of this EventObject or that are registered
as 'catch all' -listeners |
void |
fireEventEDT(EventObject event) |
void |
fireEventEDT(EventObject event,
java.lang.Object sender) |
int |
getDeadListenerTreshold() |
java.lang.Object |
getEventSource() |
boolean |
isEventsEnabled() |
void |
removeEventListener(EventListener listener)
Removes the given
EventListener from all events
it was previously registered for. |
void |
removeEventListener(EventListener listener,
java.lang.String eventName)
Removes from the list of registered listeners all pairs
matching the given combination of
EventListener
and eventName . |
void |
setDeadListenerTreshold(int deadListenerTreshold) |
void |
setEventsEnabled(boolean eventsEnabled) |
void |
setEventSource(java.lang.Object value) |
protected transient java.util.List<java.lang.Object> eventListeners
protected java.lang.Object eventSource
EventSource
instance will be
used in its place.protected transient java.util.concurrent.atomic.AtomicInteger deadListenerCount
protected transient int deadListenerTreshold
protected boolean eventsEnabled
public EventSource()
public EventSource(java.lang.Object source)
public java.lang.Object getEventSource()
public void setEventSource(java.lang.Object value)
public boolean isEventsEnabled()
public void setEventsEnabled(boolean eventsEnabled)
public int getDeadListenerTreshold()
public void setDeadListenerTreshold(int deadListenerTreshold)
public void addListener(java.lang.String eventName, EventListener listener)
listener
for events of the
specified eventName
or as a listener for all
events in the case the eventName
parameter is null
eventName
- name of events to listen for or null
if
the listener is meant to receive all fired eventslistener
- the EventListener
to be registeredpublic void removeEventListener(EventListener listener)
EventListener
from all events
it was previously registered for.listener
- the EventListener
to be removedpublic void removeEventListener(EventListener listener, java.lang.String eventName)
EventListener
and eventName
. If eventName
is null
then all occurrences of the given listener
will be
removed.listener
- eventName
- public void fireEvent(EventObject event)
event
using this object as source
for the call to EventListener.invoke(Object, EventObject)
}
if no source was specified by setEventSource(Object)
event
- public void fireEventEDT(EventObject event)
public void fireEvent(EventObject event, java.lang.Object sender)
event
to all registered EventListener
s
that listen to the name of this EventObject
or that are registered
as 'catch all'
-listenersevent
- sender
- protected void clearEventListeners()
public void fireEventEDT(EventObject event, java.lang.Object sender)