EventListenerList

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 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

构造方法详细信息

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

返回：: 该对象的字符串表示形式。

概述