クラスNotificationFilterSupport

java.lang.Object
javax.management.NotificationFilterSupport
すべての実装されたインタフェース:
Serializable, NotificationFilter
直系の既知のサブクラス:
MBeanServerNotificationFilter
public class NotificationFilterSupport extends Object implements NotificationFilter
NotificationFilterインタフェースの実装を提供します。 通知型属性には、フィルタリングが適用されます。

有効な通知型のリストを管理します。 ユーザーは、メソッドを利用して、必要な数の通知型を有効または無効にできます。

通知ブロードキャスタは、フィルタに登録されたリスナーに通知を送信する前に、この通知型とフィルタによって有効化されるすべての通知型を比較します。 フィルタがこの通知型を有効にする場合に限り、通知はリスナーに送信されます。

例: 

NotificationFilterSupport myFilter = new NotificationFilterSupport();
myFilter.enableType("my_example.my_type");
myBroadcaster.addListener(myListener, myFilter, null);
リスナーmyListenerは、「my_example.my_type」と等しいか、この文字列で始まる型の通知だけを受信します。

導入されたバージョン:
1.5
関連項目:

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

    コンストラクタ
    コンストラクタ
    説明
    NotificationFilterSupport()
    NotificationFilterSupportを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    disableAllTypes()
    すべての通知型を無効にします。
    void
    disableType(String prefix)
    接頭辞リストから指定された接頭辞を削除します。
    void
    enableType(String prefix)
    特定の接頭辞で始まるすべての通知型の通知をリスナーに送信します。
    Vector<String>
    getEnabledTypes()
    このフィルタ用に、すべての有効な通知型を取得します。
    boolean
    isNotificationEnabled(Notification notification)
    指定された通知をリスナーに送信する前に呼び出されます。

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

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 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()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • NotificationFilterSupport

      public NotificationFilterSupport()
      NotificationFilterSupportを構築します。

  • メソッドの詳細

    • isNotificationEnabled

      public boolean isNotificationEnabled(Notification notification)
      指定された通知をリスナーに送信する前に呼び出されます。
      このフィルタは、指定された通知の型と、有効な各型を比較します。       通知型がいずれかの有効な型に一致する場合、リスナーに通知が送信され、このメソッドはtrueを返します。
      定義:
      isNotificationEnabled、インタフェースNotificationFilter
      パラメータ:
      notification - 送信される通知。
      戻り値:
      通知をリスナーに送信する必要がある場合はtrue、それ以外の場合はfalse。

    • enableType

      public void enableType(String prefix) throws IllegalArgumentException
      特定の接頭辞で始まるすべての通知型の通知をリスナーに送信します。
      指定された接頭辞がすでに有効な通知型のリストに記載されている場合、このメソッドは何も行いません。

      例: 

      // Enables all notifications the type of which starts with "my_example" to be sent.
myFilter.enableType("my_example");
// Enables all notifications the type of which is "my_example.my_type" to be sent.
myFilter.enableType("my_example.my_type");
      次の点に注意してください。
      myFilter.enableType("my_example.*");
      は、どの通知型とも一致しません。

      パラメータ:
      prefix - 接頭辞。
      スロー:
      IllegalArgumentException - 接頭辞パラメータがnullの場合。

    • disableType

      public void disableType(String prefix)
      接頭辞リストから指定された接頭辞を削除します。
      指定された接頭辞が有効な通知型のリストにない場合、このメソッドは何も行いません。
      パラメータ:
      prefix - 接頭辞。

    • disableAllTypes

      public void disableAllTypes()
      すべての通知型を無効にします。

    • getEnabledTypes

      public Vector<String> getEnabledTypes()
      このフィルタ用に、すべての有効な通知型を取得します。
      戻り値:
      すべての有効な通知型を含むリスト。