public interface NotificationBroadcaster
Represents a bean that can emit notifications when events occur. Other beans can use this interface to add themselves to the list of recipients of such notifications.
Note: New classes should use
NotificationEmitter
, a subinterface of this,
in preference to using this interface directly.
Modifier and Type | Method and Description |
---|---|
void |
addNotificationListener(NotificationListener listener,
NotificationFilter filter,
Object passback)
Registers the specified listener as a new recipient of
notifications from this bean.
|
MBeanNotificationInfo[] |
getNotificationInfo()
Returns an array describing the notifications this
bean may send to its registered listeners.
|
void |
removeNotificationListener(NotificationListener listener)
Removes the specified listener from the list of recipients
of notifications from this bean.
|
void addNotificationListener(NotificationListener listener, NotificationFilter filter, Object passback) throws IllegalArgumentException
listener
- the new listener, who will receive
notifications from this broadcasting bean.filter
- a filter to determine which notifications are
delivered to the listener, or null
if no filtering is required.passback
- an object to be passed to the listener with
each notification.IllegalArgumentException
- if listener
is
null
.removeNotificationListener(NotificationListener)
MBeanNotificationInfo[] getNotificationInfo()
void removeNotificationListener(NotificationListener listener) throws ListenerNotFoundException
NotificationEmitter
.listener
- the listener to remove.ListenerNotFoundException
- if the specified listener
is not registered with this bean.addNotificationListener(NotificationListener, NotificationFilter,
java.lang.Object)