モジュール java.management

パッケージ javax.management

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

関連項目:

• NotificationBroadcaster.addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)
• 直列化された形式

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

コンストラクタ

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

メソッドのサマリー

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

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

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()

このフィルタ用に、すべての有効な通知型を取得します。

戻り値:

すべての有効な通知型を含むリスト。