compact3

javax.management

Интерфейс NotificationBroadcaster

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

ModelMBean, ModelMBeanNotificationBroadcaster, NotificationEmitter

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

CounterMonitor, GaugeMonitor, JMXConnectorServer, MBeanServerDelegate, Монитор, NotificationBroadcasterSupport, RelationService, RequiredModelMBean, RMIConnectorServer, StandardEmitterMBean, StringMonitor, Таймер

public interface NotificationBroadcaster

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

Уведомление диспетчеризирует

Когда MBean испускает уведомление, он рассматривает каждого слушателя, который был добавлен с addNotificationListener и не впоследствии удаленный с removeNotificationListener. Если фильтру предоставили того слушателя, и если фильтр isNotificationEnabled метод возвращает false, слушатель игнорируется. Иначе, слушатель handleNotification метод вызывают с уведомлением, так же как объектом handback, для которого обеспечили addNotificationListener.

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

Реализации этого интерфейса могут отличаться относительно потока, в котором вызывают методы фильтров и слушателей.

Если вызов метода фильтра или слушателя бросает Exception, тогда то исключение не должно препятствовать тому, чтобы другие слушатели были вызваны. Однако, если вызов метода бросает Error, тогда рекомендуется, чтобы обработка уведомления остановилась в той точке, и если возможно распространить Error к отправителю уведомления это должно быть сделано.

Новый код должен использовать NotificationEmitter интерфейс вместо этого.

Реализации этого интерфейса и NotificationEmitter должно быть осторожным относительно синхронизации. В частности это не хорошая идея для реализации, чтобы содержать любые блокировки, в то время как это вызывает слушателя. Чтобы иметь дело с возможностью, что список слушателей мог бы измениться, в то время как уведомление диспетчеризируется, хорошая стратегия состоит в том, чтобы использовать a CopyOnWriteArrayList для этого списка.

С тех пор:

1.5

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

Модификатор и Тип	Метод и Описание
void	addNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback) Добавляет слушатель этого MBean.
MBeanNotificationInfo[]	getNotificationInfo() Возвращает указание массива, для каждого уведомления, которое этот MBean может отправить, имя Java class уведомления и типа уведомления.
void	removeNotificationListener(NotificationListener listener) Удаляет слушателя из этого MBean.

Деталь метода

addNotificationListener

void addNotificationListener(NotificationListener listener,
                             NotificationFilter filter,
                             Object handback)
                      throws IllegalArgumentException

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

Параметры:

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

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

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

Броски:

IllegalArgumentException - Параметр слушателя является нулем.

См. Также:

removeNotificationListener(javax.management.NotificationListener)

removeNotificationListener

void removeNotificationListener(NotificationListener listener)
                         throws ListenerNotFoundException

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

Параметры:

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

Броски:

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

См. Также:

addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object), NotificationEmitter.removeNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)

getNotificationInfo

MBeanNotificationInfo[] getNotificationInfo()

Возвращает указание массива, для каждого уведомления, которое этот MBean может отправить, имя Java class уведомления и типа уведомления.

Это не недопустимо для MBean, чтобы отправить уведомления, не описанные в этом массиве. Однако, некоторые клиенты сервера MBean могут зависеть от массива, являющегося полным для их корректного функционирования.

Возвраты:

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