Интерфейс NotificationEmitter

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

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

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

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

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

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

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

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