Интерфейс NotificationBroadcaster

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

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

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

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

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

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

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

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