com.sun.jdmk
Interface NotificationRegistration

All Known Subinterfaces:

ClientNotificationHandler, MBeanInterceptor, MBeanServerInt, MBeanServerInterceptor, ProxyHandler, RemoteMBeanServer

All Known Implementing Classes:

CompatibleMBeanInterceptor, DefaultMBeanInterceptor, DefaultMBeanServerInterceptor, ForwardingMBeanServerInterceptor, GenericHttpConnectorClient, HttpConnectorClient, HttpsConnectorClient, MBeanInterceptorWrapper, MBeanServerImpl, MBeanServerInterceptorWrapper, RmiConnectorClient

public interface NotificationRegistration

This interface specifies the methods to add or to remove a notification listener to an MBean via a MBean server (remote or local).

Method Summary

void	addNotificationListener(javax.management.ObjectName name, javax.management.NotificationListener listener, javax.management.NotificationFilter filter, java.lang.Object handback) Adds a listener to a registered MBean.
void	removeNotificationListener(javax.management.ObjectName name, javax.management.NotificationListener listener) Removes a listener from a registered MBean.

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

Adds a listener to a registered MBean.

Parameters:

name - The objectname of the MBean on which the listener should be added.

listener - The listener which will handle the notifications emitted by the registered MBean.

filter - The filter used to do filtering. 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 MBean name provided does not match any of the registered MBeans.

removeNotificationListener

void removeNotificationListener(javax.management.ObjectName name,
                                javax.management.NotificationListener listener)
                                throws javax.management.InstanceNotFoundException,
                                       javax.management.ListenerNotFoundException

Removes a listener from a registered MBean. It will remove all the information related to this listener.

Parameters:

name - The objectname of the MBean on which the listener should be removed.

listener - The listener which will handle the notifications emitted by the registered MBean.

Throws:

javax.management.InstanceNotFoundException - The MBean name provided does not match any of the registered MBeans.

javax.management.ListenerNotFoundException - The listener is not registered in the MBean.