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。