站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

MBeanServerDelegate (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

JavaTM 2 Platform
Standard Ed. 5.0

javax.management
类 MBeanServerDelegate

java.lang.Object
  继承者 javax.management.MBeanServerDelegate
所有已实现的接口:
MBeanServerDelegateMBean, NotificationBroadcaster, NotificationEmitter

public class MBeanServerDelegate
extends Object
implements MBeanServerDelegateMBean, NotificationEmitter

从管理的观点表示 MBean 服务器。在 MBean 服务器中注册/注销 MBean 时,MBeanServerDelegate MBean 发出 MBeanServerNotifications。

从以下版本开始:
1.5

构造方法摘要
MBeanServerDelegate()
          创建一个 MBeanServerDelegate 对象。
 
方法摘要
 void addNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)
          向此 MBean 添加一个侦听器。
 String getImplementationName()
          返回 JMX 实现名(此产品的名称)。
 String getImplementationVendor()
          返回 JMX 实现供应商(此产品的供应商)。
 String getImplementationVersion()
          返回 JMX 实现版本(此产品的版本)。
 String getMBeanServerId()
          返回 MBean 服务器代理标识。
 MBeanNotificationInfo[] getNotificationInfo()
          返回一个数组,指示此 MBean 可能发送的每个通知的 Java 类名和通知类型。
 String getSpecificationName()
          返回此产品实现的 JMX 规范的全名。
 String getSpecificationVendor()
          返回此产品实现的 JMX 规范的供应商。
 String getSpecificationVersion()
          返回此产品实现的 JMX 规范的版本。
 void removeNotificationListener(NotificationListener listener)
          从此 MBean 移除一个侦听器。
 void removeNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)
          从此 MBean 中移除一个侦听器。
 void sendNotification(Notification notification)
          允许 MBean 服务器发送通知。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

MBeanServerDelegate

public MBeanServerDelegate()
创建一个 MBeanServerDelegate 对象。

方法详细信息

getMBeanServerId

public String getMBeanServerId()
返回 MBean 服务器代理标识。

指定者:
接口 MBeanServerDelegateMBean 中的 getMBeanServerId
返回:
标识。

getSpecificationName

public String getSpecificationName()
返回此产品实现的 JMX 规范的全名。

指定者:
接口 MBeanServerDelegateMBean 中的 getSpecificationName
返回:
规范名称。

getSpecificationVersion

public String getSpecificationVersion()
返回此产品实现的 JMX 规范的版本。

指定者:
接口 MBeanServerDelegateMBean 中的 getSpecificationVersion
返回:
规范版本。

getSpecificationVendor

public String getSpecificationVendor()
返回此产品实现的 JMX 规范的供应商。

指定者:
接口 MBeanServerDelegateMBean 中的 getSpecificationVendor
返回:
规范供应商。

getImplementationName

public String getImplementationName()
返回 JMX 实现名(此产品的名称)。

指定者:
接口 MBeanServerDelegateMBean 中的 getImplementationName
返回:
实现名。

getImplementationVersion

public String getImplementationVersion()
返回 JMX 实现版本(此产品的版本)。

指定者:
接口 MBeanServerDelegateMBean 中的 getImplementationVersion
返回:
实现版本。

getImplementationVendor

public String getImplementationVendor()
返回 JMX 实现供应商(此产品的供应商)。

指定者:
接口 MBeanServerDelegateMBean 中的 getImplementationVendor
返回:
实现供应商。

getNotificationInfo

public MBeanNotificationInfo[] getNotificationInfo()
从接口 NotificationBroadcaster 复制的描述

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

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

指定者:
接口 NotificationBroadcaster 中的 getNotificationInfo
返回:
可能的通知数组。

addNotificationListener

public void addNotificationListener(NotificationListener listener,
                                    NotificationFilter filter,
                                    Object handback)
                             throws IllegalArgumentException
从接口 NotificationBroadcaster 复制的描述
向此 MBean 添加一个侦听器。

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

removeNotificationListener

public void removeNotificationListener(NotificationListener listener,
                                       NotificationFilter filter,
                                       Object handback)
                                throws ListenerNotFoundException
从接口 NotificationEmitter 复制的描述

从此 MBean 中移除一个侦听器。该 MBean 必须有一个与给定 listenerfilterhandback 参数完全相符的侦听器。如果有多个此种侦听器,则只移除一个。

当且仅当 filterhandback 在要移除的侦听器中为 null 时,这两个参数才可以为 null。

指定者:
接口 NotificationEmitter 中的 removeNotificationListener
参数:
listener - 以前添加到此 MBean 的侦听器。
filter - 添加侦听器时所指定的过滤器。
handback - 添加侦听器时所指定的回调。
抛出:
ListenerNotFoundException - 如果侦听器未向该 MBean 注册,或者没有用给定的过滤器和回调注册它。

removeNotificationListener

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

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

sendNotification

public void sendNotification(Notification notification)
允许 MBean 服务器发送通知。如果传递的 notification 的序列号小于或等于 0,则用该委托自己的序列号替换它。

参数:
notification - 要发送的通知。

JavaTM 2 Platform
Standard Ed. 5.0

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

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