Интерфейс NotificationBroadcaster

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

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

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

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

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

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

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

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