public class WeakEventListenerList extends Object implements Serializable
PENDING: serialization support Usage example: Say one is defining a class that sends out FooEvents, and one wants to allow users of the class to register FooListeners and receive notification when FooEvents occur. The following should be added to the class definition:
EventListenerList listenerList = new EventListenerList(); FooEvent fooEvent = null; public void addFooListener(FooListener l) { listenerList.add(FooListener.class, l); } public void removeFooListener(FooListener l) { listenerList.remove(FooListener.class, l); } // Notify all listeners that have registered interest for // notification on this event type. The event instance // is lazily created using the parameters passed into // the fire method. protected void fireFooXXX() { // Guaranteed to return a non-null array FooListener[] listeners = listenerList.getListeners(FooListener.class); // Process the listeners last to first, notifying // those that are interested in this event for (FooListener listener: listeners) { // Lazily create the event: if (fooEvent == null) fooEvent = new FooEvent(this); listener.fooXXX(fooEvent); } } }foo should be changed to the appropriate name, and fireFooXxx to the appropriate method name. One fire method should exist for each notification method in the FooListener interface.
Warning:
Serialized objects of this class will not be compatible with
future Swing releases. The current serialization support is
appropriate for short term storage or RMI between applications running
the same version of Swing. As of 1.4, support for long term storage
of all JavaBeansTM
has been added to the java.beans
package.
Please see XMLEncoder
.
Modifier and Type | Field and Description |
---|---|
protected List<Class<? extends EventListener>> |
classes |
protected List<WeakReference<? extends EventListener>> |
weakReferences |
Constructor and Description |
---|
WeakEventListenerList() |
Modifier and Type | Method and Description |
---|---|
<T extends EventListener> |
add(Class<T> t,
T l)
Adds the listener as a listener of the specified type.
|
private <T extends EventListener> |
cleanReferences()
Returns a list of strongly referenced EventListeners.
|
private List<Class<? extends EventListener>> |
getClasses() |
Object[] |
getListenerList()
Passes back the event listener list as an array
of ListenerType-listener pairs.
|
<T extends EventListener> |
getListeners(Class<T> t)
Return an array of all the listeners of the given type.
|
private List<WeakReference<? extends EventListener>> |
getReferences() |
<T extends EventListener> |
remove(Class<T> t,
T l)
Removes the listener as a listener of the specified type.
|
protected transient List<WeakReference<? extends EventListener>> weakReferences
protected transient List<Class<? extends EventListener>> classes
public WeakEventListenerList()
public Object[] getListenerList()
private <T extends EventListener> List<T> cleanReferences()
private List<WeakReference<? extends EventListener>> getReferences()
private List<Class<? extends EventListener>> getClasses()
public <T extends EventListener> T[] getListeners(Class<T> t)
ClassCastException
- if the supplied class
is not assignable to EventListenerpublic <T extends EventListener> void add(Class<T> t, T l)
t
- the type of the listener to be addedl
- the listener to be addedpublic <T extends EventListener> void remove(Class<T> t, T l)
t
- the type of the listener to be removedl
- the listener to be removedWebARTS Library Licensed Under the GNU - General Public License. Other Libraries licensed under their respective Open Source Licenses