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

クラス 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

指定されたイベント 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 - ターゲットリスナー内の個々のイベント処理メソッドについて記述する 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 - リスナーインタフェースのクラス

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

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