compact3

javax.management.modelmbean

Interface ModelMBeanNotificationBroadcaster

All Superinterfaces:

NotificationBroadcaster

All Known Subinterfaces:

ModelMBean

所有已知实现类：

RequiredModelMBean

public interface ModelMBeanNotificationBroadcaster
extends NotificationBroadcaster

这个接口必须由modelmbeans实施。此接口的实现必须随每个JMX代理。

java资源希望能够实例化ModelMBean MBeanServer creatembean方法的使用。资源建立了ModelMBeanInfo（描述符）为ModelMBean实例。属性和操作通过ModelMBean ModelMBeanInfo暴露可从MBean，连接器/适配器像其他MBeans。通过ModelMBeanInfo描述符，在托管的应用价值和方法可以被定义和映射到的ModelMBean属性和操作。这个映射可以定义在XML格式的文件或动态发展过程中，以编程方式在运行时。

这是每个ModelMBean MBeanServer实例化成为可控的：它的属性和操作成为远程访问连接，通过MBeanServer连接器/适配器。一个java对象不能注册MBeanServer除非是JMX兼容MBean。通过实例化一个ModelMBean，资源保证MBean是有效的。

mbeanexception和runtimeoperationsexception必须扔在每个公共方法。这使得包装从分布式通信异常（RMI、EJB、等）。这些异常没有被抛出的实现除了在规格和Javadoc描述的场景。

从以下版本开始：

一点五

方法摘要

Modifier and Type	Method and Description
void	addAttributeChangeNotificationListener(NotificationListener listener, String attributeName, Object handback) 寄存器实现了notificationlistener接口作为一个侦听器的对象。
void	removeAttributeChangeNotificationListener(NotificationListener listener, String attributeName) 删除一个attributechangenotifications从听众。
void	sendAttributeChangeNotification(Attribute oldValue, Attribute newValue) 发送一个attributechangenotification包含旧的价值，在对注册attributechangenotification ModelMBean听众属性的新值。
void	sendAttributeChangeNotification(AttributeChangeNotification notification) 发送一个attributechangenotification被传递到听众对注册attributechangenotification ModelMBean。
void	sendNotification(Notification ntfyObj) 发送通知，传递给注册通知听众在ModelMBean作为jmx.modelmbean.generic通知。
void	sendNotification(String ntfyText) 发送通知包含文本字符串，通过对注册通知听众在ModelMBean。

Methods inherited from interface javax.management.NotificationBroadcaster

addNotificationListener, getNotificationInfo, removeNotificationListener

方法详细信息

sendNotification

void sendNotification(Notification ntfyObj)
               throws MBeanException,
                      RuntimeOperationsException

发送通知，传递给注册通知听众在ModelMBean作为jmx.modelmbean.generic通知。

参数

ntfyObj的通知是通过对监听对象的handlenotification法。

异常

MBeanException套分布式通信异常。

RuntimeOperationsException包IllegalArgumentException：通过参数的通知对象是无效的。

sendNotification

void sendNotification(String ntfyText)
               throws MBeanException,
                      RuntimeOperationsException

发送通知包含文本字符串，通过对注册通知听众在ModelMBean。

参数

ntfyText -这是在通知的侦听器对象的handlenotification法通过文本。构建的通知将：键入“JMX。ModelMBean。通用的“源本ModelMBean实例序列1

异常

MBeanException套分布式通信异常。

RuntimeOperationsException包IllegalArgumentException：通知文本传入的字符串参数为空。

sendAttributeChangeNotification

void sendAttributeChangeNotification(AttributeChangeNotification notification)
                              throws MBeanException,
                                     RuntimeOperationsException

发送一个attributechangenotification被传递到听众对注册attributechangenotification ModelMBean。

参数

notification的通知是通过对监听对象的handlenotification法。

异常

MBeanException套分布式通信异常。

RuntimeOperationsException包IllegalArgumentException：通过参数的attributechangenotification对象为空。

sendAttributeChangeNotification

void sendAttributeChangeNotification(Attribute oldValue,
                                     Attribute newValue)
                              throws MBeanException,
                                     RuntimeOperationsException

发送一个attributechangenotification包含旧的价值，在对注册attributechangenotification ModelMBean听众属性的新值。

参数

oldValue -属性的原始值

newValue -属性的当前值

构建attributechangenotification将：型“JMX。属性。”源此ModelMBean实例序列1getname()属性属性的旧值。AttributeType属性的旧值的类attributeoldvalue getvalue()属性的旧值。attributenewvalue getvalue()价值。

异常

MBeanException套分布式通信异常。

RuntimeOperationsException包IllegalArgumentException：属性对象传递参数为空或两属性对象的名称的参数是不一样的。

addAttributeChangeNotificationListener

void addAttributeChangeNotificationListener(NotificationListener listener,
                                            String attributeName,
                                            Object handback)
                                     throws MBeanException,
                                            RuntimeOperationsException,
                                            IllegalArgumentException

寄存器实现了notificationlistener接口作为一个侦听器的对象。这个对象的handlenotification()”方法将被调用的时候，任何attributechangenotification发出通过或由ModelMBean。这不包括其他通知。他们必须独立注册。一个attributechangenotification将此属性生成。

参数

listener -监听器对象将处理由注册MBean发出通知。

attributeName -为ModelMBean属性名称接收更改通知。如果为空，那么所有的属性的变化会引起attributechangenotification签发。

handback的语境中被发送到通知的侦听器的通知时发出的。

异常

IllegalArgumentException -听者不能为空。

MBeanException套分布式通信异常。

RuntimeOperationsException -包装传入参数的属性名称不存在时。

另请参见：

removeAttributeChangeNotificationListener(javax.management.NotificationListener, java.lang.String)

removeAttributeChangeNotificationListener

void removeAttributeChangeNotificationListener(NotificationListener listener,
                                               String attributeName)
                                        throws MBeanException,
                                               RuntimeOperationsException,
                                               ListenerNotFoundException

删除一个attributechangenotifications从听众。

参数

listener听众的名字是处理由注册MBean发出通知。此方法将删除与此侦听器相关的所有信息。

attributeName -属性，听众不再愿意接受attributechangenotifications。如果为空，听者将删除所有attributechangenotifications。

异常

ListenerNotFoundException -听者不在MBean注册或空。

MBeanException套分布式通信异常。

RuntimeOperationsException包IllegalArgumentException如果inattributename参数不对应的属性名称。

另请参见：

addAttributeChangeNotificationListener(javax.management.NotificationListener, java.lang.String, java.lang.Object)