javax.swing.event

Class EventListenerList

java.lang.Object

javax.swing.event.EventListenerList

All Implemented Interfaces:

Serializable

public class EventListenerList
extends Object
implements Serializable

一个持有EventListener列表的类。 单个实例可用于使用列表来容纳所有实例的所有侦听器（所有类型的所有类型）。 使用EventListenerList的类的责任是提供类型安全的API（最好符合JavaBean规范）以及将事件通知方法分配给列表中适当的事件侦听器的方法。 这个类提供的主要好处是它在没有听众的情况下相对便宜，并且在一个地方提供了事件监听器列表的序列化，以及一定程度的MT安全性（正确使用时）。 使用示例：说一个是定义一个发送FooEvents的类，并且想要允许该类的用户注册FooListeners并在FooEvent发生时接收通知。 应将以下内容添加到类定义中：

  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应该改为适当的名称，并将fireFooXxx改为适当的方法名称。 对于FooListener接口中的每个通知方法，都应该存在一种方法。

警告：此类的序列化对象与将来的Swing版本不兼容。 当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。 从1.4开始，对所有JavaBeans的长期存储的支持已经添加到java.beans包中。 请参阅XMLEncoder 。

Field Summary

Fields

Modifier and Type	Field and Description
protected Object[]	listenerList

构造方法摘要

构造方法

Constructor and Description
EventListenerList()

方法摘要

Modifier and Type	Method and Description
<T extends EventListener> void	add(类<T> t, T l) 将侦听器添加为指定类型的侦听器。
int	getListenerCount() 返回此侦听器列表的侦听器总数。
int	getListenerCount(类<?> t) 返回此侦听器列表提供的类型的侦听器总数。
Object[]	getListenerList() 将事件侦听器列表作为ListenerType侦听器对的数组传回。
<T extends EventListener> T[]	getListeners(类<T> t) 返回给定类型的所有侦听器的数组。
<T extends EventListener> void	remove(类<T> t, T l) 将侦听器作为指定类型的侦听器删除。
String	toString() 返回EventListenerList的字符串表示形式。

Methods inherited from class java.lang.Object

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

字段详细信息

listenerList

protected transient Object[] listenerList

构造方法详细信息

EventListenerList

public EventListenerList()

方法详细信息

getListenerList

public Object[] getListenerList()

将事件侦听器列表作为ListenerType侦听器对的数组传回。 请注意，出于性能原因，此实现会回传内部存储侦听器数据的实际数据结构！ 该方法保证传回一个非空数组，以便在fire方法中不需要空检。 如果当前没有侦听器，则应返回一个零长度的Object数组。 警告！！！ 应该对此数组中包含的数据进行绝对修改 - 如果需要这样的操作，则应该在返回的数组的副本而不是数组本身上完成。

getListeners

public <T extends EventListener> T[] getListeners(类<T> t)

返回给定类型的所有侦听器的数组。

结果

指定类型的所有侦听器。

异常

ClassCastException - 如果提供的类不能分配给EventListener

从以下版本开始：

1.3

getListenerCount

public int getListenerCount()

返回此侦听器列表的侦听器总数。

getListenerCount

public int getListenerCount(类<?> t)

返回此侦听器列表提供的类型的侦听器总数。

add

public <T extends EventListener> void add(类<T> t,
                                          T l)

将侦听器添加为指定类型的侦听器。

参数

t - 要添加的侦听器的类型

l - 要添加的侦听器

remove

public <T extends EventListener> void remove(类<T> t,
                                             T l)

将侦听器作为指定类型的侦听器删除。

参数

t - 要删除的侦听器的类型

l - 要删除的侦听器

toString

public String toString()

返回EventListenerList的字符串表示形式。

重写：

toString在 Object

结果

a string representation of the object.