Интерфейс NotificationBroadcaster

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

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

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

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

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

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

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

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