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