Package javax.management.j2ee
Interface ListenerRegistration
-
- All Superinterfaces:
java.io.Serializable
public interface ListenerRegistration extends java.io.Serializable
ListenerRegistration defines the methods which clients of the MEJB use to add and remove event listeners.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
addNotificationListener(javax.management.ObjectName name, javax.management.NotificationListener listener, javax.management.NotificationFilter filter, java.lang.Object handback)
Add a listener to a registered managed object.void
removeNotificationListener(javax.management.ObjectName name, javax.management.NotificationListener listener)
Remove a listener from a registered managed object.
-
-
-
Method Detail
-
addNotificationListener
void addNotificationListener(javax.management.ObjectName name, javax.management.NotificationListener listener, javax.management.NotificationFilter filter, java.lang.Object handback) throws javax.management.InstanceNotFoundException, java.rmi.RemoteException
Add a listener to a registered managed object.- Parameters:
name
- The name of the managed object on which the listener should be added.listener
- The listener object which will handle the notifications emitted by the registered managed object.filter
- The filter object. If filter is null, no filtering will be performed before handling notifications.handback
- The context to be sent to the listener when a notification is emitted.- Throws:
javax.management.InstanceNotFoundException
- The managed object name provided does not match any of the registered managed objects.java.rmi.RemoteException
- A communication exception occurred during the execution of a remote method call
-
removeNotificationListener
void removeNotificationListener(javax.management.ObjectName name, javax.management.NotificationListener listener) throws javax.management.InstanceNotFoundException, javax.management.ListenerNotFoundException, java.rmi.RemoteException
Remove a listener from a registered managed object.- Parameters:
name
- The name of the managed object on which the listener should be removed.listener
- The listener object which will handle the notifications emitted by the registered managed object. This method will remove all the information related to this listener.- Throws:
javax.management.InstanceNotFoundException
- The managed object name provided does not match any of the registered managed objects.javax.management.ListenerNotFoundException
- The listener is not registered in the managed object.java.rmi.RemoteException
- A communication exception occurred during the execution of a remote method call
-
-