モジュール java.management
パッケージ 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
    関連項目:
    NotificationBroadcaster.addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)直列化された形式
    • コンストラクタの詳細

      • NotificationFilterSupport

        public 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​()
        このフィルタ用に、すべての有効な通知型を取得します。
        戻り値:
        すべての有効な通知型を含むリスト。