Интерфейс NotificationEmitter

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

Рассылка уведомлений

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

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

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

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

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

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