JavaTM 2 Platform
Standard Ed. 6

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()
           
 
方法摘要
 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()
方法詳細資訊

isNotificationEnabled

public boolean isNotificationEnabled(Notification notification)
向偵聽器發送指定的通知前調用。
此過濾器把指定的通知的型別和所有允許的型別相比較。如果通知型別與某個允許型別比對,則應該將該通知發送到偵聽器並且此方法返回 true

指定者:
介面 NotificationFilter 中的 isNotificationEnabled
參數:
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 - 如果 prefix 參數為 null。

disableType

public void disableType(String prefix)
從前綴列表中移除給定的前綴。
如果指定的前綴不在允許的通知型別的列表中,則此方法無效。

參數:
prefix - 前綴。

disableAllTypes

public void disableAllTypes()
禁止所有通知型別。


getEnabledTypes

public Vector<String> getEnabledTypes()
獲得此過濾器的所有允許通知型別。

返回:
包含所有允許的通知型別的列表。

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only