Интерфейс NotificationBroadcaster

public interface NotificationBroadcaster

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

Распространение уведомлений

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

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

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

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

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

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

Методы

addNotificationListener

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

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

Параметры:

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

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

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

Исключения:

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

См. также:

removeNotificationListener(javax.management.NotificationListener)

removeNotificationListener

void removeNotificationListener(NotificationListener listener)
                         throws ListenerNotFoundException

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

Параметры:

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

Возвращает:

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