Класс StandardEmitterMBean

public class StandardEmitterMBean
extends StandardMBean
implements NotificationEmitter

Класс MBean, интерфейс управления которым определяется по отражению Java-интерфейса, и который отправляет уведомления.

Следующий пример демонстрирует использование публичного конструктора StandardEmitterMBean(implementation, mbeanInterface, emitter) для создания MBean, отправляющего уведомления с любым именем класса реализации Impl, с интерфейсом управления (как для текущих Standard MBean) определённым любым интерфейсом Intf и с любой реализацией интерфейса NotificationEmitter. В примере используется класс NotificationBroadcasterSupport в качестве реализации интерфейса NotificationEmitter.

MBeanServer mbs;
     ...
     final String[] types = new String[] {"sun.disc.space","sun.disc.alarm"};
     final MBeanNotificationInfo info = new MBeanNotificationInfo(
                                          types,
                                          Notification.class.getName(),
                                          "Notification about disc info.");
     final NotificationEmitter emitter =
                    new NotificationBroadcasterSupport(info);

     final Intf impl = new Impl(...);
     final Object mbean = new StandardEmitterMBean(
                                     impl, Intf.class, emitter);
     mbs.registerMBean(mbean, objectName);

Конструкторы

StandardEmitterMBean

public StandardEmitterMBean(T implementation,
                            Class<T> mbeanInterface,
                            NotificationEmitter emitter)

Параметры:

implementation - реализация интерфейса MBean.

mbeanInterface - интерфейс Standard MBean.

emitter - объект, который будет обрабатывать уведомления.

Исключения:

IllegalArgumentException - если mbeanInterface не соответствует шаблонам проектирования JMX для интерфейсов управления, или если указанный implementation не реализует указанный интерфейс, или если emitter равно null.

StandardEmitterMBean

public StandardEmitterMBean(T implementation,
                            Class<T> mbeanInterface,
                            boolean isMXBean,
                            NotificationEmitter emitter)

Параметры:

implementation - реализация интерфейса MBean.

mbeanInterface - интерфейс Standard MBean.

isMXBean - Если true, параметр mbeanInterface задаёт интерфейс MXBean, и результат MBean является MXBean.

emitter - объект, который будет обрабатывать уведомления.

Исключения:

IllegalArgumentException - если mbeanInterface не соответствует шаблонам проектирования JMX для интерфейсов управления, или если указанный implementation не реализует указанный интерфейс, или если emitter равно null.

StandardEmitterMBean

protected StandardEmitterMBean(Class<?> mbeanInterface,
                               NotificationEmitter emitter)

Параметры:

mbeanInterface - интерфейс StandardMBean.

emitter - объект, который будет обрабатывать уведомления.

Исключения:

IllegalArgumentException - если mbeanInterface не соответствует шаблонам проектирования JMX для интерфейсов управления, или если this не реализует указанный интерфейс, или если emitter равно null.

StandardEmitterMBean

protected StandardEmitterMBean(Class<?> mbeanInterface,
                               boolean isMXBean,
                               NotificationEmitter emitter)

Параметры:

mbeanInterface - интерфейс StandardMBean.

isMXBean - Если true, параметр mbeanInterface задаёт интерфейс MXBean, и результат MBean является MXBean.

emitter - объект, который будет обрабатывать уведомления.

Исключения:

IllegalArgumentException - если mbeanInterface не соответствует шаблонам проектирования JMX для интерфейсов управления, или если this не реализует указанный интерфейс, или если emitter равно null.

Методы

removeNotificationListener

public void removeNotificationListener(NotificationListener listener)
                                throws ListenerNotFoundException

Описание скопировано из интерфейса: NotificationBroadcaster

Удаляет слушателя из этого MBean. Если слушатель был зарегистрирован с различными объектами обратной связи или фильтрами уведомлений, все записи, соответствующие слушателю, будут удалены.

Указано в:

removeNotificationListener в интерфейсе NotificationBroadcaster

Параметры:

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)

removeNotificationListener

public void removeNotificationListener(NotificationListener listener,
                                       NotificationFilter filter,
                                       Object handback)
                                throws ListenerNotFoundException

Описание скопировано из интерфейса: NotificationEmitter

Указано в:

removeNotificationListener в интерфейсе NotificationEmitter

Параметры:

listener - Слушатель, который был ранее добавлен в этот MBean.

filter - Фильтр, указанный при добавлении слушателя.

handback - Объект обратной связи, указанный при добавлении слушателя.

Исключения:

ListenerNotFoundException - Слушатель не зарегистрирован в MBean, или не зарегистрирован с указанным фильтром и объектом обратной связи.

addNotificationListener

public void addNotificationListener(NotificationListener listener,
                                    NotificationFilter filter,
                                    Object handback)

Описание скопировано из интерфейса: NotificationBroadcaster

Добавляет слушателя в этот MBean.

Указано в:

addNotificationListener в интерфейсе NotificationBroadcaster

Параметры:

listener - Объект слушателя, который будет обрабатывать уведомления, исходящие от распределителя.

filter - Объект фильтра. Если filter равен null, фильтрация уведомлений не будет выполнена.

handback - Непрозрачный объект, который будет возвращён слушателю при отправке уведомления. Этот объект не может быть использован объектом-распределителем уведомлений. Он должен быть возвращён неизменённым вместе с уведомлением слушателю.

См. также:

NotificationBroadcaster.removeNotificationListener(javax.management.NotificationListener)

getNotificationInfo

public MBeanNotificationInfo[] getNotificationInfo()

Описание скопировано из интерфейса: NotificationBroadcaster

Указано в:

getNotificationInfo в интерфейсе NotificationBroadcaster

Возвращает:

массив возможных уведомлений.

sendNotification

public void sendNotification(Notification n)

Параметры:

n - уведомление для отправки.

Исключения:

ClassCastException - если параметр emitter конструктора не был экземпляром NotificationBroadcasterSupport.