javax.management
Interface NotificationBroadcaster

All Known Subinterfaces:
ModelMBean, ModelMBeanNotificationBroadcaster
All Known Implementing Classes:
MBeanServerDelegate, NotificationBroadcasterSupport

public interface NotificationBroadcaster

Should be implemented by an MBean that emits Notifications. It allows a listener to be registered within the MBean as notification listener.

Version:
1.9
Author:
Attilio Mattiocco, Chiara Montecchio

Method Summary
 void addNotificationListener(NotificationListener listener, NotificationFilter filter, java.lang.Object handBack)
          Adds a listener to a registered MBean.
 MBeanNotificationInfo[] getNotificationInfo()
          Returns a NotificationInfo object contaning the name of the Java class of the notification and the notification types sent.
 void removeNotificationListener(NotificationListener notificationListener)
          Removes a listener from a registered MBean.
 

Method Detail

addNotificationListener

public void addNotificationListener(NotificationListener listener,
                                    NotificationFilter filter,
                                    java.lang.Object handBack)
                             throws java.lang.IllegalArgumentException
Adds a listener to a registered MBean.
Parameters:
listener - The listener object which will handle the notifications emitted by the registered MBean.
filter - The filter object. If filter is null, no filtering will be performed before handling notifications.
handback - An opaque object to be sent back to the listener when a notification is emitted. This object cannot be used by the Notification broadcaster object. It should be resent unchanged with the notification to the listener.
Throws:
java.lang.IllegalArgumentException - Listener parameter is null

removeNotificationListener

public void removeNotificationListener(NotificationListener notificationListener)
                                throws ListenerNotFoundException
Removes a listener from a registered MBean.
Parameters:
notificationListener - The registered listener object.
Throws:
ListenerNotFoundException - The listener is not registered in the MBean.

getNotificationInfo

public MBeanNotificationInfo[] getNotificationInfo()
Returns a NotificationInfo object contaning the name of the Java class of the notification and the notification types sent.