模块 java.management

软件包 javax.management

Class MBeanServerNotification

java.lang.Object

java.util.EventObject

javax.management.Notification

javax.management.MBeanServerNotification

实现的所有接口

Serializable

public class MBeanServerNotification
extends Notification

表示MBean Server通过MBeanServerDelegate MBean发出的通知。 MBean Server发出以下类型的通知：MBean注册，MBean注销。

要接收MBeanServerNotifications，您需要使用代表MBeanServer的MBeanServerDelegate MBean注册一个侦听器。 MBeanServerDelegate的ObjectName是MBeanServerDelegate.DELEGATE_NAME ，即JMImplementation:type=MBeanServerDelegate 。

每次在MBean Server mbeanServer注册或取消注册MBean时，以下代码都会打印一条消息：

  private static final NotificationListener printListener = new NotificationListener() {
     public void handleNotification(Notification n, Object handback) {
         if (!(n instanceof MBeanServerNotification)) {
             System.out.println("Ignored notification of class " + n.getClass().getName());
             return;
         }
         MBeanServerNotification mbsn = (MBeanServerNotification) n;
         String what;
         if (n.getType().equals(MBeanServerNotification.REGISTRATION_NOTIFICATION))
             what = "MBean registered";
         else if (n.getType().equals(MBeanServerNotification.UNREGISTRATION_NOTIFICATION))
             what = "MBean unregistered";
         else
             what = "Unknown type " + n.getType();
         System.out.println("Received MBean Server notification: " + what + ": " +
                 mbsn.getMBeanName());
     }
 };

 ...
     mbeanServer.addNotificationListener(
             MBeanServerDelegate.DELEGATE_NAME, printListener, null, null); 

不是MBeanServerDelegate的MBean也可以发出MBeanServerNotifications。 特别是，MBean有一个约定，即为一组MBean发出MBeanServerNotification。

发出的MBeanServerNotification表示注册或取消注册一组MBean具有以下特征：

• 其notification type是"JMX.mbean.registered.group"或"JMX.mbean.unregistered.group" ，其也可以写成REGISTRATION_NOTIFICATION + ".group"或UNREGISTRATION_NOTIFICATION + ".group" 。
• 它的MBean name是一个ObjectName模式，用于选择正在注册或未注册的MBean的集合（或超集）
• 其user data可以选择设置为一个ObjectNames数组，其中包含所有已注册或未注册的MBean的名称。

发出这些组注册/取消注册通知的MBean将在其MBeanNotificationInfo中声明它们。

从以下版本开始：

1.5

另请参见：

Serialized Form

字段汇总

字段

变量和类型	字段	描述
static String	REGISTRATION_NOTIFICATION	表示已注册MBean的通知类型。
static String	UNREGISTRATION_NOTIFICATION	表示MBean已取消注册的通知类型。

声明的属性在类 javax.management.Notification

source

构造方法摘要

构造方法

构造器	描述
MBeanServerNotification(String type, Object source, long sequenceNumber, ObjectName objectName)	创建MBeanServerNotification对象，指定导致通知的MBean的对象名称和指定的通知类型。

方法摘要

变量和类型	方法	描述
ObjectName	getMBeanName()	返回导致通知的MBean的对象名称。

声明方法的类 javax.management.Notification

getMessage, getSequenceNumber, getTimeStamp, getType, getUserData, setSequenceNumber, setSource, setTimeStamp, setUserData, toString

声明方法的类 java.util.EventObject

getSource

声明方法的类 java.lang.Object

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

字段详细信息

REGISTRATION_NOTIFICATION

public static final String REGISTRATION_NOTIFICATION

表示已注册MBean的通知类型。 值为“JMX.mbean.registered”。

另请参见：

常数字段值

UNREGISTRATION_NOTIFICATION

public static final String UNREGISTRATION_NOTIFICATION

表示MBean已取消注册的通知类型。 值为“JMX.mbean.unregistered”。

另请参见：

常数字段值

构造方法详细信息

MBeanServerNotification

public MBeanServerNotification(String type,
                               Object source,
                               long sequenceNumber,
                               ObjectName objectName)

创建MBeanServerNotification对象，指定导致通知的MBean的对象名称和指定的通知类型。

参数

type - 表示通知类型的字符串。 将它设置为一个这些值： REGISTRATION_NOTIFICATION ， UNREGISTRATION_NOTIFICATION 。

source - 负责转发MBean服务器通知的MBeanServerNotification对象。

sequenceNumber - 可用于订购收到通知的序列号。

objectName - 导致通知的MBean的对象名称。

方法详细信息

getMBeanName

public ObjectName getMBeanName()

返回导致通知的MBean的对象名称。

结果

the object name of the MBean that caused the notification.