JavaTM 2 Platform
Standard Ed. 5.0

javax.management
接口 NotificationBroadcaster

所有已知子接口:
ModelMBean, ModelMBeanNotificationBroadcaster, NotificationEmitter
所有已知实现类:
CounterMonitor, GaugeMonitor, JMXConnectorServer, MBeanServerDelegate, Monitor, NotificationBroadcasterSupport, RelationService, RequiredModelMBean, RMIConnectorServer, StringMonitor, Timer

public interface NotificationBroadcaster

发出 Notifications 的 MBean 所实现的接口。它允许某个侦听器向该 MBean 注册为通知侦听器。

新的代码应该使用 NotificationEmitter 接口。

从以下版本开始:
1.5

方法摘要
 void addNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)
          向此 MBean 添加一个侦听器。
 MBeanNotificationInfo[] getNotificationInfo()
          返回一个数组,指示此 MBean 可能发送的每个通知的 Java 类名和通知类型。
 void removeNotificationListener(NotificationListener listener)
          从此 MBean 移除一个侦听器。
 

方法详细信息

addNotificationListener

void addNotificationListener(NotificationListener listener,
                             NotificationFilter filter,
                             Object handback)
                             throws IllegalArgumentException
向此 MBean 添加一个侦听器。

参数:
listener - 将处理广播者所发出的通知的侦听器对象。
filter - 过滤器对象。如果 filter 为 null,则处理通知前不执行过滤。
handback - 发出通知时要发送到侦听器的不透明对象。Notification 广播者对象不能使用此对象。应该不作更改并带有通知的情况下将其重新发送到侦听器。
抛出:
IllegalArgumentException - 如果 Listener 参数为 null。
另请参见:
removeNotificationListener(javax.management.NotificationListener)

removeNotificationListener

void removeNotificationListener(NotificationListener listener)
                                throws ListenerNotFoundException
从此 MBean 移除一个侦听器。如果已向不同的回调对象或通知过滤器注册了该侦听器,则移除与该侦听器有关的所有项。

参数:
listener - 以前添加到此 MBean 的侦听器。
抛出:
ListenerNotFoundException - 如果该侦听器未向 MBean 注册。
另请参见:
addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object), NotificationEmitter.removeNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)

getNotificationInfo

MBeanNotificationInfo[] getNotificationInfo()

返回一个数组,指示此 MBean 可能发送的每个通知的 Java 类名和通知类型。

MBean 发送此数组中未描述的通知是合法的。但是,某些 MBean 服务器的客户端要想正常运行,可能要依赖于完整的数组。

返回:
可能的通知数组。

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策