javax.swing.event

Class EventListenerList

java.lang.Object

javax.swing.event.EventListenerList

All Implemented Interfaces:

Serializable

public class EventListenerList
extends Object
implements Serializable

一个类，有一列事件。一个实例可以用来保存使用列表的实例的所有侦听器（所有类型的）。这是责任的类使用eventlistenerlist提供类型安全的API（最好符合JavaBeans规范）和方法，事件通知的方式适当的事件侦听器列表。该类提供的主要优点是，它是相对便宜的情况下，没有听众，它提供序列化的事件监听列表在一个单一的地方，以及一个机器翻译的安全性（使用正确）。举例：说一个是定义一个类，发出fooevents，和一个想让类的使用者登记foolisteners和fooevents发生时接收通知。下面要添加到类的定义：

eventlistenerlist listenerlist =新eventlistenerlist()；fooevent fooevent = null；公共无效addfoolistener（foolistener L）{listenerlist添加（FooListener.class，L）；}公共无效removefoolistener（foolistener L）{listenerlist删除（FooListener.class，L）；}/ /通知所有的听众，有注册的兴趣此事件类型的通知。事件实例/ /是懒洋洋地创建使用传入的参数/火法。protected void firefooxxx() {/保证返回一个非空数组对象[ ] = listenerlist getlistenerlist()听众；/处理最后一个第一次的听众，通知那些对这个事件感兴趣的人为（int i = listeners.length-2；我> = 0；I = 2）{如果（听众[我] = = foolistener。类）{/ /懒洋洋地创建事件：如果（fooevent = = null）fooevent =新fooevent（本）；（（foolistener）听众[我+ 1 ]）。fooxxx（fooevent）；}}}

foo应改为相应的名称，并firefooxxx到适当的方法名称。一个火法应该存在于每一个通知方法在foolistener接口。

警告：序列化该类的对象与以后的Swing版本不兼容。当前的序列化支持适用于短期贮藏或RMI运行相同Swing版本的应用程序之间。为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

Field Detail

listenerList

protected transient Object[] listenerList

Constructor Detail

EventListenerList

public EventListenerList()

方法详细信息

getListenerList

public Object[] getListenerList()

传送回事件监听器列表作为listenertype听众对数组。请注意，为了性能原因，此实现通过返回侦听器数据存储在内部的实际数据结构！该方法保证将非空数组传递给非空数组，以便在火灾方法中不需要进行空检查。如果当前没有侦听器，则应返回一零个长度的对象数组。警告！！！绝对没有修改这个数组中包含的数据应该是-如果任何这样的操作是必要的，它应该在一个数组的副本，而不是数组本身。

getListeners

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

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

结果

指定类型的所有侦听器。

异常

ClassCastException -如果提供的类是不可转让的事件侦听器

从以下版本开始：

一点三

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

结果

对象的字符串表示形式。