java.beans
类 EventSetDescriptor

java.lang.Object
  java.beans.FeatureDescriptor
      java.beans.EventSetDescriptor

public class EventSetDescriptor
extends FeatureDescriptor

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

给定的事件组都是作为方法调用在单个事件侦听器接口上传递的，事件侦听器对象可以通过调用事件源提供的注册方法进行注册。

构造方法摘要

EventSetDescriptor(Class<?> sourceClass, String eventSetName, Class<?> listenerType, String listenerMethodName)
假定按照最简单的标准设计模式创建 EventSetDescriptor，其中指定事件 "fred" 是 (1) 作为接口 FredListener 的单个方法上的调用传递的；(2) 它有一个 FredEvent 类型的参数；(3) 其中 FredListener 可以通过调用源组件的 addFredListener 方法注册，并通过调用 removeFredListener 方法移除。

EventSetDescriptor(Class<?> sourceClass, String eventSetName, Class<?> listenerType, String[] listenerMethodNames, String addListenerMethodName, String removeListenerMethodName)
使用字符串名称从头开始创建 EventSetDescriptor。

EventSetDescriptor(Class<?> sourceClass, String eventSetName, Class<?> listenerType, String[] listenerMethodNames, String addListenerMethodName, String removeListenerMethodName, String getListenerMethodName)
此构造方法使用字符串名称从头开始创建 EventSetDescriptor。

EventSetDescriptor(String eventSetName, Class<?> listenerType, Method[] listenerMethods, Method addListenerMethod, Method removeListenerMethod)
使用 java.lang.reflect.Method 和 java.lang.Class 对象从头开始创建 EventSetDescriptor。

EventSetDescriptor(String eventSetName, Class<?> listenerType, Method[] listenerMethods, Method addListenerMethod, Method removeListenerMethod, Method getListenerMethod)
此构造方法使用 java.lang.reflect.Method 和 java.lang.Class 对象从头开始创建 EventSetDescriptor。

EventSetDescriptor(String eventSetName, Class<?> listenerType, MethodDescriptor[] listenerMethodDescriptors, Method addListenerMethod, Method removeListenerMethod)
使用 java.lang.reflect.MethodDescriptor 和 java.lang.Class 对象从头开始创建 EventSetDescriptor。

方法摘要

Method	getAddListenerMethod() 获得用来添加事件侦听器的方法。
Method	getGetListenerMethod() 获得用来访问已注册事件侦听器的方法。
MethodDescriptor[]	getListenerMethodDescriptors() 获得目标侦听器接口的 MethodDescriptor。
Method[]	getListenerMethods() 获得目标侦听器接口的方法。
Class<?>	getListenerType() 获得目标接口的 Class 对象。
Method	getRemoveListenerMethod() 获得用来移除事件侦听器的方法。
boolean	isInDefaultEventSet() 报告事件集是否在“默认”集合中。
boolean	isUnicast() 通常事件源是多播的。
void	setInDefaultEventSet(boolean inDefaultEventSet) 将事件集标记为“默认”集合（或非默认集合）。
void	setUnicast(boolean unicast) 将事件集标记为单播（或非单播）。

从类 java.beans.FeatureDescriptor 继承的方法

attributeNames, getDisplayName, getName, getShortDescription, getValue, isExpert, isHidden, isPreferred, setDisplayName, setExpert, setHidden, setName, setPreferred, setShortDescription, setValue

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

EventSetDescriptor

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 - 如果在内省期间发生异常。

EventSetDescriptor

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 - 如果在内省期间发生异常。

EventSetDescriptor

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

此构造方法使用字符串名称从头开始创建 EventSetDescriptor。

参数：

sourceClass - 激发事件的类。

eventSetName - 事件集的编程名称。注意，此参数通常应该以小写字母开头。

listenerType - 事件将被传递到的目标接口的 Class。

listenerMethodNames - 事件传递到其目标侦听器接口时调用的方法的名称。

addListenerMethodName - 可用来注册事件侦听器对象的事件源上的方法名称。

removeListenerMethodName - 可用来取消注册事件侦听器对象的事件源上的方法名称。

getListenerMethodName - 可用来访问事件侦听器对象数组的事件源上的方法。

抛出：

IntrospectionException - 如果在内省期间发生异常。

从以下版本开始：

1.4

EventSetDescriptor

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

使用 java.lang.reflect.Method 和 java.lang.Class 对象从头开始创建 EventSetDescriptor。

参数：

eventSetName - 事件集的编程名称。

listenerType - 侦听器接口的 Class。

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

addListenerMethod - 可用来注册事件侦听器对象的事件源上的方法。

removeListenerMethod - 可用来取消注册事件侦听器对象的事件源上的方法。

抛出：

IntrospectionException - 如果在内省期间发生异常。

EventSetDescriptor

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

此构造方法使用 java.lang.reflect.Method 和 java.lang.Class 对象从头开始创建 EventSetDescriptor。

参数：

eventSetName - 事件集的编程名称。

listenerType - 侦听器接口的 Class。

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

addListenerMethod - 可用来注册事件侦听器对象的事件源上的方法。

removeListenerMethod - 可用来取消注册事件侦听器对象的事件源上的方法。

getListenerMethod - 可用来访问事件侦听器对象数组的事件源上的方法。

抛出：

IntrospectionException - 如果在内省期间发生异常。

从以下版本开始：

1.4

EventSetDescriptor

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

使用 java.lang.reflect.MethodDescriptor 和 java.lang.Class 对象从头开始创建 EventSetDescriptor。

参数：

eventSetName - 事件集的编程名称。

listenerType - 侦听器接口的 Class。

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

addListenerMethod - 可用来注册事件侦听器对象的事件源上的方法。

removeListenerMethod - 可用来取消注册事件侦听器对象的事件源上的方法。

抛出：

IntrospectionException - 如果在内省期间发生异常。

方法详细信息

getListenerType

public Class<?> getListenerType()

获得目标接口的 Class 对象。

返回：

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

getListenerMethods

public Method[] getListenerMethods()

获得目标侦听器接口的方法。

返回：

激发事件时将调用的目标侦听器接口中目标方法的 Method 对象数组。

getListenerMethodDescriptors

public MethodDescriptor[] getListenerMethodDescriptors()

获得目标侦听器接口的 MethodDescriptor。

返回：

激发事件时将调用的目标侦听器接口中目标方法的 MethodDescriptor 对象数组。

getAddListenerMethod

public Method getAddListenerMethod()

获得用来添加事件侦听器的方法。

返回：

用来在事件源注册侦听器的方法。

getRemoveListenerMethod

public Method getRemoveListenerMethod()

获得用来移除事件侦听器的方法。

返回：

用来在事件源移除侦听器的方法。

getGetListenerMethod

public Method getGetListenerMethod()

获得用来访问已注册事件侦听器的方法。

返回：

用来访问事件源处的侦听器数组的方法，如果不存在侦听器，则返回 null。

从以下版本开始：

1.4

setUnicast

public void setUnicast(boolean unicast)

将事件集标记为单播（或非单播）。

参数：

unicast - 如果事件集是单播的，则该参数为 true。

isUnicast

public boolean isUnicast()

通常事件源是多播的。不过也有是严格单播的一些例外。

返回：

如果事件集是单播的，则返回 true。默认值为 false。

setInDefaultEventSet

public void setInDefaultEventSet(boolean inDefaultEventSet)

将事件集标记为“默认”集合（或非默认集合）。默认情况下，该值为 true。

参数：

inDefaultEventSet - 如果事件集在“默认”集合中，则该参数为 true，否则为 false

isInDefaultEventSet

public boolean isInDefaultEventSet()

报告事件集是否在“默认”集合中。

返回：

如果事件集在“默认”集合中，则返回 true。默认值为 true。