Spec-Zone.ru › OpenJDK 24

Класс 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.

Для получения MBeanServerNotifications, необходимо зарегистрировать слушателя у 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. В частности, существует соглашение для MBean, чтобы издавать MBeanServerNotification для группы MBeans.

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

  • Его тип уведомления равен "JMX.mbean.registered.group" или "JMX.mbean.unregistered.group", что также можно записать как REGISTRATION_NOTIFICATION+ ".group" или UNREGISTRATION_NOTIFICATION+ ".group".
  • Его имя MBean — шаблон имени объекта, который выбирает множество (или надмножество) MBeans, которые регистрируются или отменяют регистрацию
  • Его данные пользователя могут необязательно быть установлены в массив имен объектов, содержащих имена всех регистрируемых или отменяющих регистрацию 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, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.management/javax/management/MBeanServerNotification.html

Spec-Zone.ru

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