OpenJDK 27 · com.sun.jmx.remote.security.NotificationAccessController

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.

Method Summary

Modifier and Type	Method and Description
public void	addNotificationListener(String the `connectionId` of the remote client adding the listener. connectionId, ObjectName the name of the MBean where the listener is to be added. name, Subject the authenticated subject representing the remote client. subject) This method is called when a remote `javax.management.remote.JMXConnector` invokes the method `javax.management.MBeanServerConnection#addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)`.
public void	fetchNotification(String the `connectionId` of the remote client receiving the notification. connectionId, ObjectName the name of the MBean forwarding the notification. name, Notification the notification to be forwarded to the interested remote listener. notification, Subject the authenticated subject representing the remote client. subject) This method is called before the `javax.management.remote.JMXConnectorServer` forwards the notification to the interested remote listener represented by the authenticated subject.
public void	removeNotificationListener(String the `connectionId` of the remote client removing the listener. connectionId, ObjectName the name of the MBean where the listener is to be removed. name, Subject the authenticated subject representing the remote client. subject) This method is called when a remote `javax.management.remote.JMXConnector` invokes the method `javax.management.MBeanServerConnection#removeNotificationListener(ObjectName, NotificationListener)` or the method `javax.management.MBeanServerConnection#removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)`.

Method Detail

addNotificationListener back to summary

addNotificationListener	back to summary
public void addNotificationListener(String connectionId, ObjectName name, Subject subject) throws SecurityException This method is called when a remote `javax.management.remote.JMXConnector` invokes the method `javax.management.MBeanServerConnection#addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)`. Parameters connectionId:String the `connectionId` of the remote client adding the listener. name:ObjectName the name of the MBean where the listener is to be added. subject:Subject the authenticated subject representing the remote client. Exceptions SecurityException: if the remote client with the supplied authenticated subject does not have the rights to add a listener to the supplied MBean.

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

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

Parameters

connectionId:String: the connectionId of the remote client adding the listener.
name:ObjectName: the name of the MBean where the listener is to be added.
subject:Subject: the authenticated subject representing the remote client.

Exceptions

SecurityException:: if the remote client with the supplied authenticated subject does not have the rights to add a listener to the supplied MBean.

fetchNotification back to summary

fetchNotification	back to summary
public void fetchNotification(String connectionId, ObjectName name, Notification notification, Subject subject) throws SecurityException This method is called before the `javax.management.remote.JMXConnectorServer` forwards the notification to the interested remote listener represented by the authenticated subject. Parameters connectionId:String the `connectionId` of the remote client receiving the notification. name:ObjectName the name of the MBean forwarding the notification. notification:Notification the notification to be forwarded to the interested remote listener. subject:Subject the authenticated subject representing the remote client. Exceptions SecurityException: if the remote client with the supplied authenticated subject does not have the rights to receive the notification.

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

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

Parameters

connectionId:String: the connectionId of the remote client receiving the notification.
name:ObjectName: the name of the MBean forwarding the notification.
notification:Notification: the notification to be forwarded to the interested remote listener.
subject:Subject: the authenticated subject representing the remote client.

Exceptions

SecurityException:: if the remote client with the supplied authenticated subject does not have the rights to receive the notification.

removeNotificationListener back to summary

removeNotificationListener	back to summary
public void removeNotificationListener(String connectionId, ObjectName name, Subject subject) throws SecurityException This method is called when a remote `javax.management.remote.JMXConnector` invokes the method `javax.management.MBeanServerConnection#removeNotificationListener(ObjectName, NotificationListener)` or the method `javax.management.MBeanServerConnection#removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)`. Parameters connectionId:String the `connectionId` of the remote client removing the listener. name:ObjectName the name of the MBean where the listener is to be removed. subject:Subject the authenticated subject representing the remote client. Exceptions SecurityException: if the remote client with the supplied authenticated subject does not have the rights to remove a listener from the supplied MBean.

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

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

Parameters

connectionId:String: the connectionId of the remote client removing the listener.
name:ObjectName: the name of the MBean where the listener is to be removed.
subject:Subject: the authenticated subject representing the remote client.

Exceptions

SecurityException:: if the remote client with the supplied authenticated subject does not have the rights to remove a listener from the supplied MBean.

public Interface NotificationAccessController

Method Summary

Method Detail