Интерфейс NotificationEmitter

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

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

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

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

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

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

Этот интерфейс следует использовать новому коду вместо интерфейса NotificationBroadcaster.

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