Класс NotificationBroadcasterSupport

Реализует интерфейс NotificationEmitter. Может использоваться в качестве суперкласса для MBean, отправляющего уведомления.

По умолчанию, модель обработки уведомлений синхронна. То есть, когда поток вызывает sendNotification, метод NotificationListener.handleNotification каждого слушателя вызывается в этом потоке. Вы можете изменить это поведение, переопределив handleNotification в подклассе или передав Executor в конструктор.

Если вызов метода фильтра или слушателя вызывает исключение Exception, то это исключение не препятствует вызову других слушателей. Однако, если вызов метода фильтра или Executor.execute или handleNotification (если Excecutor не указан) вызывает исключение Error, то это исключение передаётся вызывающему методу sendNotification.

Удаленные слушатели, добавленные с помощью JMX Remote API (см. JMXConnector), обычно не вызываются синхронно. То есть, после возврата sendNotification нет гарантии, что удалённые слушатели уже получили уведомление.

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

NotificationBroadcasterSupport

public NotificationBroadcasterSupport()

Создаёт NotificationBroadcasterSupport, где каждый слушатель вызывается потоком, отправляющим уведомление. Этот конструктор эквивалентен NotificationBroadcasterSupport(null, null).

NotificationBroadcasterSupport

public NotificationBroadcasterSupport(Executor executor)

Создаёт NotificationBroadcasterSupport, где каждый слушатель вызывается с помощью указанного Executor. При вызове sendNotification выбирается слушатель, если он был добавлен с null NotificationFilter или если isNotificationEnabled возвращает true для отправляемого уведомления. Вызов NotificationFilter.isNotificationEnabled происходит в потоке, вызвавшем sendNotification. Затем для каждого выбранного слушателя вызывается executor.execute с командой, которая вызывает метод handleNotification. Этот конструктор эквивалентен NotificationBroadcasterSupport(executor, null).

Параметры:

executor - executor, используемый методом sendNotification для отправки каждого уведомления. Если он равен null, поток, вызывающий sendNotification, вызовет метод handleNotification сам.

С:

1.6

NotificationBroadcasterSupport

public NotificationBroadcasterSupport(MBeanNotificationInfo... info)

Параметры:

info - массив, указывающий для каждого уведомления, которое может отправить данный MBean, имя Java-класса уведомления и тип уведомления. Может быть null, что эквивалентно пустому массиву.

С:

1.6

NotificationBroadcasterSupport

public NotificationBroadcasterSupport(Executor executor,
                                      MBeanNotificationInfo... info)

Параметры:

executor - executor, используемый методом sendNotification для отправки каждого уведомления. Если он равен null, поток, вызывающий sendNotification, вызовет метод handleNotification сам.

info - массив, указывающий для каждого уведомления, которое может отправить данный MBean, имя Java-класса уведомления и тип уведомления. Может быть null, что эквивалентно пустому массиву.

С:

1.6

Методы

addNotificationListener

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

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

Указано в:

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

Параметры:

listener - Слушатель для получения уведомлений.

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

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

Выбрасывает:

IllegalArgumentException - выбрасывается, если listener равен null.

См. также:

removeNotificationListener(javax.management.NotificationListener)

removeNotificationListener

public void removeNotificationListener(NotificationListener listener)
                                throws ListenerNotFoundException

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

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

Указано в:

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 - Объект handback, указанный при добавлении слушателя.

Выбрасывает:

ListenerNotFoundException - Слушатель не зарегистрирован в MBean, или он не зарегистрирован с заданным фильтром и handback.

getNotificationInfo

public MBeanNotificationInfo[] getNotificationInfo()

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

Указано в:

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

Возвращает:

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

sendNotification

public void sendNotification(Notification notification)

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

Параметры:

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

handleNotification

protected void handleNotification(NotificationListener listener,
                                  Notification notif,
                                  Object handback)

listener.handleNotification(notif, handback);

Параметры:

listener - слушатель, которому доставляется уведомление.

notif - уведомление, доставляемое слушателю.

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