JavaTM 2 Platform
Standard Ed. 5.0

javax.swing.event
类 EventListenerList

java.lang.Object
  继承者 javax.swing.event.EventListenerList
所有已实现的接口:
Serializable

public class EventListenerList
extends Object
implements Serializable

保存 EventListener 列表的类。单个实例可用来保存使用列表的实例的所有侦听器(所有类型)。该类的责任是使用 EventListenerList 提供类型安全的 API(最好遵守 JavaBeans 规范)和方法,这些方法将事件通知方法指派给列表上适当的 Event Listener。 此类的主要优点是,在没有侦听器的情况下,它相对廉价一些,它在单个地方为事件侦听器提供序列化,同时还提供某种程度的 MT 安全(在正确使用时)。 用例:假定正在定义发送 FooEvent 的类,并希望允许该类的用户注册 FooListener 并在发生 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 接口中的每个通知方法都应该有一个 fire 方法。

警告:此类的序列化对象将与以后的 Swing 版本不兼容。当前的序列化支持适用于短期存储或运行相同 Swing 版本的应用程序之间的 RMI。从 1.4 版本开始,已在 java.beans 包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 XMLEncoder


字段摘要
protected  Object[] listenerList
           
 
构造方法摘要
EventListenerList()
           
 
方法摘要
<T extends EventListener>
void
add(Class<T> t, T l)
          将侦听器作为指定类型的侦听器进行添加。
 int getListenerCount()
          返回此侦听器列表中侦听器的总数。
 int getListenerCount(Class<?> t)
          返回此侦听器列表中所提供类型的侦听器的总数。
 Object[] getListenerList()
          将事件侦听器列表以 ListenerType 侦听器对数组的形式传回。
<T extends EventListener>
T[]
getListeners(Class<T> t)
          返回给定类型的所有侦听器组成的数组。
<T extends EventListener>
void
remove(Class<T> t, T l)
          将侦听器作为指定类型的侦听器进行移除。
 String toString()
          返回此 EventListenerList 的字符串表示形式。
 
从类 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 侦听器对数组的形式传回。注意,出于性能方面的原因,此实现传回实际数据结构,侦听器数据就内部存储在该结构中!此方法可保证传回的是一个非 null 数组,因此不需要在 fire 方法中进行 null 检验。如果当前没有侦听器,则应返回零长度的 Object 数组。 警告!!!绝对“不”能对包含在此数组中的数据进行修改,如果必须进行这类操作,则应在返回数组的副本而非数组本身上进行操作。


getListeners

public <T extends EventListener> T[] getListeners(Class<T> t)
返回给定类型的所有侦听器组成的数组。

返回:
指定类型的所有侦听器。
抛出:
ClassCastException - 如果所提供的类不能分配给 EventListener
从以下版本开始:
1.3

getListenerCount

public int getListenerCount()
返回此侦听器列表中侦听器的总数。


getListenerCount

public int getListenerCount(Class<?> t)
返回此侦听器列表中所提供类型的侦听器的总数。


add

public <T extends EventListener> void add(Class<T> t,
                                          T l)
将侦听器作为指定类型的侦听器进行添加。

参数:
t - 要添加的侦听器的类型
l - 要添加的侦听器

remove

public <T extends EventListener> void remove(Class<T> t,
                                             T l)
将侦听器作为指定类型的侦听器进行移除。

参数:
t - 要移除的侦听器的类型
l - 要移除的侦听器

toString

public String toString()
返回此 EventListenerList 的字符串表示形式。

覆盖:
Object 中的 toString
返回:
该对象的字符串表示形式。

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策