java.beans

クラスEventSetDescriptor

java.lang.Object

java.beans.FeatureDescriptor

java.beans.EventSetDescriptor

public class EventSetDescriptor
extends FeatureDescriptor

EventSetDescriptorは、指定されたJavaBeanがトリガーするイベントのグループを記述します。

指定されたイベント・グループは、すべて単一のイベント・リスナー・インタフェース上のメソッド呼び出しとして配信されます。イベント・リスナー・オブジェクトは、イベント・ソースから提供される登録メソッドの呼出しによって登録されます。

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
EventSetDescriptor(Class<?> sourceClass, String eventSetName, Class<?> listenerType, String listenerMethodName) 指定されたイベントfredが(1) FredListenerインタフェースの単一のメソッド呼び出しとして配信される、(2) FredEvent型の単一の引数をとる、(3) FredListenerをソース・コンポーネントのaddFredListenerメソッドの呼出しで登録しremoveFredListenerメソッドの呼出しで削除する、というもっとも単純な標準設計パターンに従うものとして、EventSetDescriptorを作成します。
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, toString

クラス java.lang.Objectから継承されたメソッド

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

コンストラクタの詳細

EventSetDescriptor

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

指定されたイベントfredが(1) FredListenerインタフェースの単一のメソッド呼び出しとして配信される、(2) FredEvent型の単一の引数をとる、(3) FredListenerをソース・コンポーネントのaddFredListenerメソッドの呼出しで登録しremoveFredListenerメソッドの呼出しで削除する、というもっとも単純な標準設計パターンに従うものとして、EventSetDescriptorを作成します。

パラメータ:

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 - イベントの配信先となるターゲット・インタフェースのクラス。

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 - イベントの配信先となるターゲット・インタフェースのクラス。

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 - リスナー・インタフェースのクラス。

listenerMethods - ターゲット・リスナー内の個々のイベント処理メソッドについて記述するメソッド・オブジェクトの配列。

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 - リスナー・インタフェースのクラス。

listenerMethods - ターゲット・リスナー内の個々のイベント処理メソッドについて記述するメソッド・オブジェクトの配列。

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 - リスナー・インタフェースのクラス。

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。