クラスEventSetDescriptor

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

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

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

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

    コンストラクタ
    コンストラクタ
    説明
    EventSetDescriptor(Class<?> sourceClass, String eventSetName, Class<?> listenerType, String listenerMethodName)
    EventSetDescriptorを作成します。これは、指定されたイベント"fred"が、インタフェースFredListenerの単一のメソッドに対するコールとして配信される(1)である、最も単純な標準設計パターンに従っていることを前提としています。(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, MethodDescriptor[] listenerMethodDescriptors, Method addListenerMethod, Method removeListenerMethod)
    java.lang.reflect.MethodDescriptorおよびjava.lang.Classオブジェクトを使用して、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を作成します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    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)
    イベント・セットをユニキャスト、または非ユニキャストとしてマークします。

    クラスで宣言されたメソッド FeatureDescriptor

    attributeNames, getDisplayName, getName, getShortDescription, getValue, isExpert, isHidden, isPreferred, setDisplayName, setExpert, setHidden, setName, setPreferred, setShortDescription, setValue, toString
    修飾子と型
    メソッド
    説明
    Enumeration<String>
    attributeNames()
    この機能のロケールに依存しない名前の列挙を取得します。
    String
    getDisplayName()
    この機能のローカライズされた表示名を取得します。
    String
    getName()
    この機能のプログラム名を取得します。
    String
    getShortDescription()
    この機能の短い説明を取得します。
    Object
    getValue(String attributeName)
    この機能を使用して名前付きの属性を取得します。
    boolean
    isExpert()
    「エキスパート」フラグは、上級者向けの機能を一般ユーザー向けの機能と区別するために使用されます。
    boolean
    isHidden()
    「隠し」フラグは、ツールだけで使用され、ユーザーには提供されない機能を識別するために使用されます。
    boolean
    isPreferred()
    「優先」フラグは、ユーザーへ表示する特に重要である機能を識別するために使用されます。
    void
    setDisplayName(String displayName)
    この機能のローカライズされた表示名を設定します。
    void
    setExpert(boolean expert)
    「エキスパート」フラグは、上級者向けの機能を一般ユーザー向けの機能と区別するために使用されます。
    void
    setHidden(boolean hidden)
    「隠し」フラグは、ツールだけで使用され、ユーザーには提供されない機能を識別するために使用されます。
    void
    setName(String name)
    この機能のプログラム名を設定します。
    void
    setPreferred(boolean preferred)
    「優先」フラグは、ユーザーへ表示する特に重要である機能を識別するために使用されます。
    void
    setShortDescription(String text)
    短い説明的な文字列を機能と関連付けることができます。
    void
    setValue(String attributeName, Object value)
    名前付きの属性をこの機能と関連付けます。
    String
    toString()
    オブジェクトの文字列表現を返します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • EventSetDescriptor

      public EventSetDescriptor(Class<?> sourceClass, String eventSetName, Class<?> listenerType, String listenerMethodName) throws IntrospectionException
      EventSetDescriptorを作成します。これは、指定されたイベント"fred"が、インタフェースFredListenerの単一のメソッドに対するコールとして配信される(1)である、最も単純な標準設計パターンに従っていることを前提としています。(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 - イベントの配信先となるターゲット・インタフェースのクラス。
      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()
      イベント・セットが「デフォルト」セット内にあるかどうかを報告します。
      戻り値:
      イベント・セットが"default"セットにある場合はtrue。 デフォルトはtrueです。