compact3

javax.management.modelmbean

Интерфейс ModelMBeanNotificationBroadcaster

Все Суперинтерфейсы:

NotificationBroadcaster

Все Известные Подынтерфейсы:

ModelMBean

Все Известные Классы с реализацией:

RequiredModelMBean

public interface ModelMBeanNotificationBroadcaster
extends NotificationBroadcaster

Этот интерфейс должен быть реализован ModelMBeans. Реализация этого интерфейса должна быть поставлена с каждым Агентом JMX.

Ресурсы Java, желающие быть управляемыми, инстанцируют ModelMBean, используя createMBean метод MBeanServer. Ресурс тогда устанавливает ModelMBeanInfo (с Дескрипторами) для экземпляра ModelMBean. Атрибуты и операции, представленные через ModelMBeanInfo для ModelMBean, доступны от MBeans, соединителей/адаптеров как другой MBeans. Через Дескрипторы ModelMBeanInfo значения и методы в управляемом приложении могут быть определены и отображены на атрибуты и операции ModelMBean. Это отображение может быть определено во время разработки в XML отформатированный файл или динамически и программно во времени выполнения.

Каждый ModelMBean, который инстанцируют в MBeanServer, становится управляемым: его атрибуты и операции становятся удаленно доступными через соединители/адаптеры, соединенные с тем MBeanServer. Объект Java не может быть зарегистрирован в MBeanServer, если это не совместимый MBean JMX. Инстанцируя ModelMBean, ресурсам гарантируют это, MBean допустим.

MBeanException и RuntimeOperationsException должны быть брошены в каждый открытый метод. Это учитывает переносящиеся исключения из распределенной связи (RMI, EJB, и т.д.). Эти исключения не должны быть выданы реализацией кроме в сценариях, описанных в спецификации и javadoc.

С тех пор:

1.5

Сводка метода

Модификатор и Тип	Метод и Описание
void	addAttributeChangeNotificationListener(NotificationListener listener, String attributeName, Object handback) Регистрирует объект, который реализует интерфейс NotificationListener как слушателя.
void	removeAttributeChangeNotificationListener(NotificationListener listener, String attributeName) Удаляет слушателя для attributeChangeNotifications из RequiredModelMBean.
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.

Методы, наследованные от интерфейса 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.generic" источник эта последовательность экземпляра 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 - Текущая стоимость для Атрибута

 The constructed attributeChangeNotification will be:
   type        "jmx.attribute.change"
   source      this ModelMBean instance
   sequence    1
   attributeName oldValue.getName()
   attributeType oldValue's class
   attributeOldValue oldValue.getValue()
   attributeNewValue newValue.getValue()
 

Броски:

MBeanException - Обертывает распределенное коммуникационное Исключение.

RuntimeOperationsException - Обертывает IllegalArgumentException: объект Атрибута, который передают в параметре, является нулем, или имена двух объектов Атрибута в параметре не являются тем же самым.

addAttributeChangeNotificationListener

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

Регистрирует объект, который реализует интерфейс NotificationListener как слушателя. Этот объект 'handleNotification ()' метод будет вызван, когда любой attributeChangeNotification будет выпущен через или ModelMBean. Это не включает другие Уведомления. Они должны быть зарегистрированы для независимо. AttributeChangeNotification будет сгенерирован для этого attributeName.

Параметры:

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

attributeName - Имя ModelMBean приписывает, для которого можно получить уведомления об изменении. Если ноль, тогда все изменения атрибута заставят attributeChangeNotification быть выпущенным.

handback - Контекст, который будет отправлен слушателю с уведомлением, когда уведомление испускается.

Броски:

IllegalArgumentException - Слушатель не может быть нулем.

MBeanException - Обертывает распределенное коммуникационное Исключение.

RuntimeOperationsException - Обертывает IllegalArgumentException, название атрибута, которое передают в параметре, не существует.

См. Также:

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

removeAttributeChangeNotificationListener

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

Удаляет слушателя для attributeChangeNotifications из RequiredModelMBean.

Параметры:

listener - Имя слушателя, которое обрабатывало уведомления, испускаемые зарегистрированным MBean. Этот метод удалит всю информацию, связанную с этим слушателем.

attributeName - Атрибут, для которого слушатель больше не хочет получить attributeChangeNotifications. Если нуль слушатель будет удален для всего attributeChangeNotifications.

Броски:

ListenerNotFoundException - Слушатель не регистрируется в MBean или является нулем.

MBeanException - Обертывает распределенное коммуникационное Исключение.

RuntimeOperationsException - Обертывает IllegalArgumentException, Если inAttributeName параметр не соответствует названию атрибута.

См. Также:

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