Spec-Zone.ru › OpenJDK 17

Класс MBeanServerNotification

java.lang.Object
java.util.EventObject
javax.management.Notification
javax.management.MBeanServerNotification
Все реализуемые интерфейсы:
Serializable
public class MBeanServerNotification extends Notification
Представляет уведомление, исходящее от сервера управления MBean через MBean MBeanServerDelegate. Сервер управления MBean генерирует следующие типы уведомлений: регистрация MBean, снятие MBean с регистрации.

Для получения уведомлений MBeanServerNotification необходимо зарегистрировать слушателя в MBeanServerDelegate MBean, представляющем сервер управления MBean. Имя объекта MBeanServerDelegate — MBeanServerDelegate.DELEGATE_NAME, которое является JMImplementation:type=MBeanServerDelegate.

Следующий код выводит сообщение каждый раз, когда MBean регистрируется или снимается с регистрации на сервере управления MBean mbeanServer:

 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);
 

MBean, который не является MBeanServerDelegate, также может генерировать MBeanServerNotifications. В частности, существует соглашение о том, что MBeans генерируют MBeanServerNotification для группы MBeans.

MBeanServerNotification, отправленный для обозначения регистрации или снятия с регистрации группы MBeans, имеет следующие характеристики:

  • Его тип уведомления — "JMX.mbean.registered.group" или "JMX.mbean.unregistered.group", что также можно записать как REGISTRATION_NOTIFICATION+ ".group" или UNREGISTRATION_NOTIFICATION+ ".group".
  • Его имя MBean — шаблон имени объекта, который выбирает набор (или надмножество) MBeans, которые регистрируются или снимаются с регистрации.
  • Его данные пользователя могут необязательно содержать массив ObjectNames, содержащий имена всех MBeans, которые регистрируются или снимаются с регистрации.

MBeans, которые генерируют эти уведомления о регистрации/снятии с регистрации группы, объявляют их в своих MBeanNotificationInfo.

С:
1.5
См. также:
  • Сериализованная форма

Краткое описание полей

Модификатор и тип Поле Описание
static final String REGISTRATION_NOTIFICATION
Тип уведомления, указывающий, что MBean зарегистрирован.
static final String UNREGISTRATION_NOTIFICATION
Тип уведомления, указывающий, что MBean снят с регистрации.

Поля, объявленные в классе javax.management.Notification

source

Краткое описание конструкторов

Конструктор Описание
MBeanServerNotification(String type, Object source, long sequenceNumber, ObjectName objectName)
Создает объект MBeanServerNotification, указывающий имена объектов MBeans, которые вызвали уведомление, и указанный тип уведомления.

Краткое описание методов

Модификатор и тип Метод Описание
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, указывающий имена объектов MBeans, которые вызвали уведомление, и указанный тип уведомления.
Параметры:
type - Строка, обозначающая тип уведомления. Установите одно из этих значений: REGISTRATION_NOTIFICATION, UNREGISTRATION_NOTIFICATION.
source - Объект MBeanServerNotification, ответственный за пересылку уведомлений сервера MBean.
sequenceNumber - Номер последовательности, который можно использовать для упорядочивания полученных уведомлений.
objectName - Имя объекта MBean, вызвавшего уведомление.

Подробное описание методов

getMBeanName

public ObjectName getMBeanName()
Возвращает имя объекта MBean, вызвавшего уведомление.
Возвращает:
имя объекта MBean, вызвавшего уведомление.

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.management/javax/management/MBeanServerNotification.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API