EventListenerList (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 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
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

字段摘要
`protected Object[]`	`listenerList`

构造方法摘要
`EventListenerList()`

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

字段详细信息

listenerList

protected transient Object[] listenerList

构造方法详细信息