Interface ListenerRegistration

All Superinterfaces:
Serializable

public interface ListenerRegistration extends Serializable
ListenerRegistration defines the methods which clients of the MEJB use to add and remove event listeners.
  • Method Details

    • addNotificationListener

      void addNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback) throws InstanceNotFoundException, 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:
      InstanceNotFoundException - The managed object name provided does not match any of the registered managed objects.
      RemoteException - A communication exception occurred during the execution of a remote method call
    • removeNotificationListener

      void removeNotificationListener(ObjectName name, NotificationListener listener) throws InstanceNotFoundException, ListenerNotFoundException, 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:
      InstanceNotFoundException - The managed object name provided does not match any of the registered managed objects.
      ListenerNotFoundException - The listener is not registered in the managed object.
      RemoteException - A communication exception occurred during the execution of a remote method call