Интерфейс NotificationEmitter

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

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

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

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

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

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

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

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