モジュール java.desktop
パッケージ java.beans

クラスEventSetDescriptor

  • public class EventSetDescriptor
extends FeatureDescriptor
    EventSetDescriptorは、指定されたJava Beanがトリガーするイベントのグループを記述します。

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

    導入されたバージョン:
    1.1

    • コンストラクタの詳細

      • 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です。