Интерфейс NotificationEmitter

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

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

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

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

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

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

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

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