Интерфейс NotificationBroadcaster

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

Отправка уведомлений

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

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

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

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

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

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