public interface

NotificationAccessController

com.sun.jmx.remote.security.NotificationAccessController

Class Overview

This interface allows to control remote access to the addNotificationListener and removeNotificationListener methods when the notification listener parameter is of type NotificationListener and also allows to control remote access to the notifications being forwarded to the interested remote listeners.

An implementation of this interface can be supplied to a JMXConnectorServer in the environment map through the com.sun.jmx.remote.notification.access.controller environment map property.

Summary

Public Methods
abstract void addNotificationListener(String connectionId, ObjectName name, Subject subject)
This method is called when a remote JMXConnector invokes the method addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object).
abstract void fetchNotification(String connectionId, ObjectName name, Notification notification, Subject subject)
This method is called before the JMXConnectorServer forwards the notification to the interested remote listener represented by the authenticated subject.
abstract void removeNotificationListener(String connectionId, ObjectName name, Subject subject)
This method is called when a remote JMXConnector invokes the method removeNotificationListener(ObjectName, NotificationListener) or the method removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object).

Public Methods

public abstract void addNotificationListener (String connectionId, ObjectName name, Subject subject)

This method is called when a remote JMXConnector invokes the method addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object).

Parameters
connectionId the connectionId of the remote client adding the listener.
name the name of the MBean where the listener is to be added.
subject the authenticated subject representing the remote client.
Throws
SecurityException if the remote client with the supplied authenticated subject does not have the rights to add a listener to the supplied MBean.

public abstract void fetchNotification (String connectionId, ObjectName name, Notification notification, Subject subject)

This method is called before the JMXConnectorServer forwards the notification to the interested remote listener represented by the authenticated subject.

Parameters
connectionId the connectionId of the remote client receiving the notification.
name the name of the MBean forwarding the notification.
notification the notification to be forwarded to the interested remote listener.
subject the authenticated subject representing the remote client.
Throws
SecurityException if the remote client with the supplied authenticated subject does not have the rights to receive the notification.

public abstract void removeNotificationListener (String connectionId, ObjectName name, Subject subject)

This method is called when a remote JMXConnector invokes the method removeNotificationListener(ObjectName, NotificationListener) or the method removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object).

Parameters
connectionId the connectionId of the remote client removing the listener.
name the name of the MBean where the listener is to be removed.
subject the authenticated subject representing the remote client.
Throws
SecurityException if the remote client with the supplied authenticated subject does not have the rights to remove a listener from the supplied MBean.