- java.lang.Object
-
- javax.swing.event.EventListenerList
-
- All Implemented Interfaces:
- Serializable
public class EventListenerList extends Object implements Serializable
A class that holds a list of EventListeners. A single instance can be used to hold all listeners (of all types) for the instance using the list. It is the responsiblity of the class using the EventListenerList to provide type-safe API (preferably conforming to the JavaBeans spec) and methods which dispatch event notification methods to appropriate Event Listeners on the list. The main benefits that this class provides are that it is relatively cheap in the case of no listeners, and it provides serialization for event-listener lists in a single place, as well as a degree of MT safety (when used correctly). 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 Object[] listeners = listenerList.getListenerList(); // Process the listeners last to first, notifying // those that are interested in this event for (int i = listeners.length-2; i>=0; i-=2) { if (listeners[i]==FooListener.class) { // Lazily create the event: if (fooEvent == null) fooEvent = new FooEvent(this); ((FooListener)listeners[i+1]).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 seeXMLEncoder
.
-
-
Field Summary
Fields Modifier and Type Field and Description protected Object[]
listenerList
-
Constructor Summary
Constructors Constructor and Description EventListenerList()
-
Method Summary
Methods Modifier and Type Method and Description <T extends EventListener>
voidadd(Class<T> t, T l)
Adds the listener as a listener of the specified type.int
getListenerCount()
Returns the total number of listeners for this listener list.int
getListenerCount(Class<?> t)
Returns the total number of listeners of the supplied type for this listener list.Object[]
getListenerList()
Passes back the event listener list as an array of ListenerType-listener pairs.<T extends EventListener>
T[]getListeners(Class<T> t)
Return an array of all the listeners of the given type.<T extends EventListener>
voidremove(Class<T> t, T l)
Removes the listener as a listener of the specified type.String
toString()
Returns a string representation of the EventListenerList.
-
-
-
Field Detail
-
listenerList
protected transient Object[] listenerList
-
-
Method Detail
-
getListenerList
public Object[] getListenerList()
Passes back the event listener list as an array of ListenerType-listener pairs. Note that for performance reasons, this implementation passes back the actual data structure in which the listener data is stored internally! This method is guaranteed to pass back a non-null array, so that no null-checking is required in fire methods. A zero-length array of Object should be returned if there are currently no listeners. WARNING!!! Absolutely NO modification of the data contained in this array should be made -- if any such manipulation is necessary, it should be done on a copy of the array returned rather than the array itself.
-
getListeners
public <T extends EventListener> T[] getListeners(Class<T> t)
Return an array of all the listeners of the given type.- Returns:
- all of the listeners of the specified type.
- Throws:
ClassCastException
- if the supplied class is not assignable to EventListener- Since:
- 1.3
-
getListenerCount
public int getListenerCount()
Returns the total number of listeners for this listener list.
-
getListenerCount
public int getListenerCount(Class<?> t)
Returns the total number of listeners of the supplied type for this listener list.
-
add
public <T extends EventListener> void add(Class<T> t, T l)
Adds the listener as a listener of the specified type.- Parameters:
t
- the type of the listener to be addedl
- the listener to be added
-
remove
public <T extends EventListener> void remove(Class<T> t, T l)
Removes the listener as a listener of the specified type.- Parameters:
t
- the type of the listener to be removedl
- the listener to be removed
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-javax/swing/event/eventlistenerlist.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.