类 java.beans.EvenaSetDescriptor

java.lang.Object
   |
   +----java.beans.FeatureDescriptor
           |
           +----java.beans.EventSetDescriptor

public class EventSetDescriptor

extends FeatureDescriptor

EventSetDescriptor 描述给定 Java bean 激发的一组事件。

当方法调用某单个事件监听者接口时，发送给定事件组中所有事件并通过调用事件源提供的注册方法来为某个事件监听者对象注册。

构造子索引

EventSetDescriptor(Class, String, Class, String)

该构造子假设用户按下列最简单的标准设计模式创建一个 EventSetDescriptor，其中名为“fred”的事件 (1) 作为接口 FredListener 单个方法的调用发送, (2) 有一单个的类型为 FredEvent 的参数, (3) FredListener 可以调用源组件的 addFredListener 方法来注册并调用 removeFredListener 方法删除。

EventSetDescriptor(Class, String, Class, String[], String, String)

该构造子用字符串从头开始创建一个 EventSetDescriptor。

EventSetDescriptor(String, Class, Method[], Method, Method)

该构造子用 java.lang.reflect.Method 和 java.lang.Class 对象从头开始创建一个 EventSetDesctriptor。

EventSetDescriptor(String, Class, MethodDescriptor[], Method, Method)

该构造子用 java.lang.reflect.MethodDescriptor 和 java.lang.Class 对象从头开始创建一个 EventSetDesctriptor。

方法索引

getAddListenerMethod()

getListenerMethodDescriptors()

getListenerMethods()

getListenerType()

getRemoveListenerMethod()

isInDefaultEventSet()

若事件集为“缺省设置”，则报告。

isUnicast()

通常事件源是多址发送的。

setInDefaultEventSet(boolean)

标记事件集在 (或不在)“缺省”集中。

setUnicast(boolean)

标记事件集是 (或不是) 单址发送的。

构造子

 public EventSetDescriptor(Class sourceClass,
                           String eventSetName,
                           Class listenerType,
                           String listenerMethodName) throws IntrospectionException

该构造子假设用户按下列最简单的标准设计模式创建一个 EventSetDescriptor，其中名为“fred”的事件 (1) 作为接口 FredListener 单个方法的调用发送, (2) 有一单个的类型为 FredEvent 的参数, (3) FredListener 可以调用源组件的一个 addFredListener 方法来注册并调用一个 removeFredListener 方法来删除。

参数：

sourceClass - 激发事件的类。

eventSetName - 事件的编程名，如“fred”。注意通常应以小写字符开始。

listenerType - 发送事件的目标接口。

listenerMethodName - 当事件发送至其目标接口时，调用该方法。

抛出： IntrospectionException

若内省时发生异常。

 public EventSetDescriptor(Class sourceClass,
                           String eventSetName,
                           Class listenerType,
                           String listenerMethodNames[],
                           String addListenerMethodName,
                           String removeListenerMethodName) throws IntrospectionException

该构造子用字符串从头开始创建一个 EventSetDescriptor。

参数：

sourceClass - 激发事件的类。

eventSetName - 事件集的编程名。注意通常应以小写字符开始。

listenerType - 发送事件的目标接口 Class 。

listenerMethodNames - 当事件发送至目标监听者接口时所调用方法的名字。

addListenerMethodName - 用于注册事件监听者对象的事件源上的方法的名字。

removeListenerMethodName - 用于注消事件监听者对象的事件源上的方法的名字。

抛出： IntrospectionException

若内省时发生异常。

 public EventSetDescriptor(String eventSetName,
                           Class listenerType,
                           Method listenerMethods[],
                           Method addListenerMethod,
                           Method removeListenerMethod) throws IntrospectionException

This constructor creates an EventSetDescriptor from scratch using java.lang.reflect.Method and java.lang.Class objects.

参数：

eventSetName - 事件集的编程名。

listenerType - 监听者接口的 Class 。

listenerMethods - 描述目标监听者中每个事件处理方法的 Method 对象数组。

addListenerMethod - 用于注册事件监听者对象的事件源上的方法。

removeListenerMethod - 用于注消事件监听者对象的事件源上的方法。

抛出： IntrospectionException

若内省时发生异常。

 public EventSetDescriptor(String eventSetName,
                           Class listenerType,
                           MethodDescriptor listenerMethodDescriptors[],
                           Method addListenerMethod,
                           Method removeListenerMethod) throws IntrospectionException

该构造子用 java.lang.reflect.MethodDescriptor 和 java.lang.Class 对象从头开始创建一个 EventSetDesctriptor。

参数：

eventSetName - 事件集的编程名。

listenerType - 监听者接口的 Class 。

listenerMethodDescriptors - 描述目标监听者中每个事件处理方法的 MethodDescriptor 对象数组。

addListenerMethod - 用于注册事件监听者对象的事件源上的方法。

removeListenerMethod - 用于注消事件监听者对象的事件源上的方法。

抛出： IntrospectionException

若内省时发生异常。

方法

 public Class getListenerType()

返回值：

当事件激发时，将调用目标接口的 Class 对象。

 public Method[] getListenerMethods()

返回值：

当事件激发时，将调用目标监听者接口中目标方法的 Method 对象数组。

 public MethodDescriptor[] getListenerMethodDescriptors()

返回值：

当事件激发时，将调用目标监听者接口中目标方法的 MethodDescriptor 对象数组。

 public Method getAddListenerMethod()

返回值：

在事件源注册一个监听者所使用的方法。

 public Method getRemoveListenerMethod()

返回值：

在事件源注册一个监听者所使用的方法。

 public void setUnicast(boolean unicast)

标记事件集是 (或不是) 单址发送的。

参数：

unicast - 若事件集是单址发送的，则为 true 。

 public boolean isUnicast()

通常事件源是多址发送的。然而，有一些严格单址发送异常。

返回值：

若事件集是单址发送的，则为 true ，缺省为“false”。

 public void setInDefaultEventSet(boolean inDefaultEventSet)

标记事件集在 (或不在)“缺省”集中，缺省为 true 。

参数：

unicast - 若事件集是单址发送的，则为 true 。

 public boolean isInDefaultEventSet()

若事件集为“缺省设置”，则报告。

返回值：

若事件集在“缺省集”中，则为 true ，缺省为“true”。