APIdia Launch Partner
Top Description Fields Constructors Methods
com.sun.jmx.remote.security

public abstract Class MBeanServerAccessController

extends Object
implements MBeanServerForwarder
Class Inheritance
All Implemented Interfaces
javax.management.remote.MBeanServerForwarder, javax.management.MBeanServer, javax.management.MBeanServerConnection
Known Direct Subclasses
com.sun.jmx.remote.security.MBeanServerFileAccessController
Imports
java.io.ObjectInputStream, java.util.Set, javax.management.Attribute, .AttributeList, .AttributeNotFoundException, .InstanceNotFoundException, .InstanceAlreadyExistsException, .IntrospectionException, .InvalidAttributeValueException, .ListenerNotFoundException, .MBeanException, .MBeanInfo, .MBeanRegistrationException, .MBeanServer, .NotCompliantMBeanException, .NotificationFilter, .NotificationListener, .ObjectInstance, .ObjectName, .OperationsException, .QueryExp, .ReflectionException, javax.management.loading.ClassLoaderRepository, javax.management.remote.MBeanServerForwarder

An object of this class implements the MBeanServer interface and, for each of its methods, calls an appropriate checking method and then forwards the request to a wrapped MBeanServer object. The checking method may throw a RuntimeException if the operation is not allowed; in this case the request is not forwarded to the wrapped object.

A typical use of this class is to insert it between a connector server such as the RMI connector and the MBeanServer with which the connector is associated. Requests from the connector client can then be filtered and those operations that are not allowed, or not allowed in a particular context, can be rejected by throwing a SecurityException in the corresponding check* method.

This is an abstract class, because in its implementation none of the checking methods does anything. To be useful, it must be subclassed and at least one of the checking methods overridden to do some checking. Some or all of the MBeanServer methods may also be overridden, for instance if the default checking behavior is inappropriate.

The access controller will refuse to create an MBean that is a ClassLoader.

Field Summary

Modifier and TypeField and Description
private MBeanServer
mbs

Constructor Summary

AccessConstructor and Description
public
MBeanServerAccessController()

Method Summary

Modifier and TypeMethod and Description
public void
addNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback)

Implements javax.management.MBeanServer.addNotificationListener.

Call checkRead(), then forward this method to the wrapped object.

public void
addNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback)

Implements javax.management.MBeanServer.addNotificationListener.

Call checkRead(), then forward this method to the wrapped object.

private void
checkClassLoader(Object object)

protected void
checkCreate(String className)

Check if the caller can create the named class.

protected abstract void
checkRead()

Check if the caller can do read operations.

protected void
checkUnregister(ObjectName name)

Check if the caller can unregister the named MBean.

protected abstract void
checkWrite()

Check if the caller can do write operations.

public ObjectInstance
createMBean(String className, ObjectName name)

Implements javax.management.MBeanServer.createMBean.

Call checkCreate(className), then forward this method to the wrapped object.

public ObjectInstance
createMBean(String className, ObjectName name, Object[] params, String[] signature)

Implements javax.management.MBeanServer.createMBean.

Call checkCreate(className), then forward this method to the wrapped object.

public ObjectInstance
createMBean(String className, ObjectName name, ObjectName loaderName)

Implements javax.management.MBeanServer.createMBean.

Call checkCreate(className), then forward this method to the wrapped object.

public ObjectInstance
createMBean(String className, ObjectName name, ObjectName loaderName, Object[] params, String[] signature)

Implements javax.management.MBeanServer.createMBean.

Call checkCreate(className), then forward this method to the wrapped object.

public ObjectInputStream
deserialize(ObjectName name, byte[] data)

Overrides default javax.management.MBeanServer.deserialize.

Deprecated

Call checkRead(), then forward this method to the wrapped object.

public ObjectInputStream
deserialize(String className, byte[] data)

Overrides default javax.management.MBeanServer.deserialize.

Deprecated

Call checkRead(), then forward this method to the wrapped object.

public ObjectInputStream
deserialize(String className, ObjectName loaderName, byte[] data)

Overrides default javax.management.MBeanServer.deserialize.

Deprecated

Call checkRead(), then forward this method to the wrapped object.

public Object
getAttribute(ObjectName name, String attribute)

Implements javax.management.MBeanServer.getAttribute.

Call checkRead(), then forward this method to the wrapped object.

public AttributeList
getAttributes(ObjectName name, String[] attributes)

Implements javax.management.MBeanServer.getAttributes.

Call checkRead(), then forward this method to the wrapped object.

public ClassLoader
getClassLoader(ObjectName loaderName)

Implements javax.management.MBeanServer.getClassLoader.

Call checkRead(), then forward this method to the wrapped object.

public ClassLoader
getClassLoaderFor(ObjectName mbeanName)

Implements javax.management.MBeanServer.getClassLoaderFor.

Call checkRead(), then forward this method to the wrapped object.

public ClassLoaderRepository
getClassLoaderRepository()

Implements javax.management.MBeanServer.getClassLoaderRepository.

Call checkRead(), then forward this method to the wrapped object.

public String
getDefaultDomain()

Implements javax.management.MBeanServer.getDefaultDomain.

Call checkRead(), then forward this method to the wrapped object.

public String[]
getDomains()

Implements javax.management.MBeanServer.getDomains.

Call checkRead(), then forward this method to the wrapped object.

public Integer
getMBeanCount()

Implements javax.management.MBeanServer.getMBeanCount.

Call checkRead(), then forward this method to the wrapped object.

public MBeanInfo
getMBeanInfo(ObjectName name)

Implements javax.management.MBeanServer.getMBeanInfo.

Call checkRead(), then forward this method to the wrapped object.

public MBeanServer
getMBeanServer()

Implements javax.management.remote.MBeanServerForwarder.getMBeanServer.

Returns the MBeanServer object to which requests will be forwarded.

public ObjectInstance
getObjectInstance(ObjectName name)

Implements javax.management.MBeanServer.getObjectInstance.

Call checkRead(), then forward this method to the wrapped object.

public Object
instantiate(String className)

Implements javax.management.MBeanServer.instantiate.

Call checkCreate(className), then forward this method to the wrapped object.

public Object
instantiate(String className, Object[] params, String[] signature)

Implements javax.management.MBeanServer.instantiate.

Call checkCreate(className), then forward this method to the wrapped object.

public Object
instantiate(String className, ObjectName loaderName)

Implements javax.management.MBeanServer.instantiate.

Call checkCreate(className), then forward this method to the wrapped object.

public Object
instantiate(String className, ObjectName loaderName, Object[] params, String[] signature)

Implements javax.management.MBeanServer.instantiate.

Call checkCreate(className), then forward this method to the wrapped object.

public Object
invoke(ObjectName name, String operationName, Object[] params, String[] signature)

Implements javax.management.MBeanServer.invoke.

Call checkWrite(), then forward this method to the wrapped object.

public boolean
isInstanceOf(ObjectName name, String className)

Implements javax.management.MBeanServer.isInstanceOf.

Call checkRead(), then forward this method to the wrapped object.

public boolean
isRegistered(ObjectName name)

Implements javax.management.MBeanServer.isRegistered.

Call checkRead(), then forward this method to the wrapped object.

public Set<ObjectInstance>
queryMBeans(ObjectName name, QueryExp query)

Implements javax.management.MBeanServer.queryMBeans.

Call checkRead(), then forward this method to the wrapped object.

public Set<ObjectName>
queryNames(ObjectName name, QueryExp query)

Implements javax.management.MBeanServer.queryNames.

Call checkRead(), then forward this method to the wrapped object.

public ObjectInstance
registerMBean(Object object, ObjectName name)

Implements javax.management.MBeanServer.registerMBean.

Call checkWrite(), then forward this method to the wrapped object.

public void
removeNotificationListener(ObjectName name, NotificationListener listener)

Implements javax.management.MBeanServer.removeNotificationListener.

Call checkRead(), then forward this method to the wrapped object.

public void
removeNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback)

Implements javax.management.MBeanServer.removeNotificationListener.

Call checkRead(), then forward this method to the wrapped object.

public void
removeNotificationListener(ObjectName name, ObjectName listener)

Implements javax.management.MBeanServer.removeNotificationListener.

Call checkRead(), then forward this method to the wrapped object.

public void
removeNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback)

Implements javax.management.MBeanServer.removeNotificationListener.

Call checkRead(), then forward this method to the wrapped object.

public void
setAttribute(ObjectName name, Attribute attribute)

Implements javax.management.MBeanServer.setAttribute.

Call checkWrite(), then forward this method to the wrapped object.

public AttributeList
setAttributes(ObjectName name, AttributeList attributes)

Implements javax.management.MBeanServer.setAttributes.

Call checkWrite(), then forward this method to the wrapped object.

public void
setMBeanServer(MBeanServer mbs)

Implements javax.management.remote.MBeanServerForwarder.setMBeanServer.

Sets the MBeanServer object to which requests will be forwarded after treatment by this object.

public void
unregisterMBean(ObjectName name)

Implements javax.management.MBeanServer.unregisterMBean.

Call checkUnregister(), then forward this method to the wrapped object.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

mbsback to summary
private MBeanServer mbs

Constructor Detail

MBeanServerAccessControllerback to summary
public MBeanServerAccessController()

Method Detail

addNotificationListenerback to summary
public void addNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback) throws InstanceNotFoundException

Implements javax.management.MBeanServer.addNotificationListener.

Call checkRead(), then forward this method to the wrapped object.

Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.addNotificationListener.

The MBean name provided does not match any of the registered MBeans.

addNotificationListenerback to summary
public void addNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback) throws InstanceNotFoundException

Implements javax.management.MBeanServer.addNotificationListener.

Call checkRead(), then forward this method to the wrapped object.

Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.addNotificationListener.

The MBean name of the notification listener or of the notification broadcaster does not match any of the registered MBeans.

checkClassLoaderback to summary
private void checkClassLoader(Object object)
checkCreateback to summary
protected void checkCreate(String className)

Check if the caller can create the named class. The default implementation of this method calls checkWrite().

checkReadback to summary
protected abstract void checkRead()

Check if the caller can do read operations. This method does nothing if so, otherwise throws SecurityException.

checkUnregisterback to summary
protected void checkUnregister(ObjectName name)

Check if the caller can unregister the named MBean. The default implementation of this method calls checkWrite().

checkWriteback to summary
protected abstract void checkWrite()

Check if the caller can do write operations. This method does nothing if so, otherwise throws SecurityException.

createMBeanback to summary
public ObjectInstance createMBean(String className, ObjectName name) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException

Implements javax.management.MBeanServer.createMBean.

Call checkCreate(className), then forward this method to the wrapped object.

Exceptions
ReflectionException:

Doc from javax.management.MBeanServerConnection.createMBean.

Wraps a java.lang.ClassNotFoundException or a java.lang.Exception that occurred when trying to invoke the MBean's constructor.

InstanceAlreadyExistsException:

Doc from javax.management.MBeanServerConnection.createMBean.

The MBean is already under the control of the MBean server.

MBeanRegistrationException:

Doc from javax.management.MBeanServerConnection.createMBean.

The preRegister (MBeanRegistration interface) method of the MBean has thrown an exception. The MBean will not be registered.

MBeanException:

Doc from javax.management.MBeanServerConnection.createMBean.

The constructor of the MBean has thrown an exception

NotCompliantMBeanException:

Doc from javax.management.MBeanServerConnection.createMBean.

This class is not a JMX compliant MBean

createMBeanback to summary
public ObjectInstance createMBean(String className, ObjectName name, Object[] params, String[] signature) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException

Implements javax.management.MBeanServer.createMBean.

Call checkCreate(className), then forward this method to the wrapped object.

Exceptions
ReflectionException:

Doc from javax.management.MBeanServerConnection.createMBean.

Wraps a java.lang.ClassNotFoundException or a java.lang.Exception that occurred when trying to invoke the MBean's constructor.

InstanceAlreadyExistsException:

Doc from javax.management.MBeanServerConnection.createMBean.

The MBean is already under the control of the MBean server.

MBeanRegistrationException:

Doc from javax.management.MBeanServerConnection.createMBean.

The preRegister (MBeanRegistration interface) method of the MBean has thrown an exception. The MBean will not be registered.

MBeanException:

Doc from javax.management.MBeanServerConnection.createMBean.

The constructor of the MBean has thrown an exception

NotCompliantMBeanException:

Doc from javax.management.MBeanServerConnection.createMBean.

This class is not a JMX compliant MBean

createMBeanback to summary
public ObjectInstance createMBean(String className, ObjectName name, ObjectName loaderName) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, InstanceNotFoundException

Implements javax.management.MBeanServer.createMBean.

Call checkCreate(className), then forward this method to the wrapped object.

Exceptions
ReflectionException:

Doc from javax.management.MBeanServerConnection.createMBean.

Wraps a java.lang.ClassNotFoundException or a java.lang.Exception that occurred when trying to invoke the MBean's constructor.

InstanceAlreadyExistsException:

Doc from javax.management.MBeanServerConnection.createMBean.

The MBean is already under the control of the MBean server.

MBeanRegistrationException:

Doc from javax.management.MBeanServerConnection.createMBean.

The preRegister (MBeanRegistration interface) method of the MBean has thrown an exception. The MBean will not be registered.

MBeanException:

Doc from javax.management.MBeanServerConnection.createMBean.

The constructor of the MBean has thrown an exception

NotCompliantMBeanException:

Doc from javax.management.MBeanServerConnection.createMBean.

This class is not a JMX compliant MBean

InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.createMBean.

The specified class loader is not registered in the MBean server.

createMBeanback to summary
public ObjectInstance createMBean(String className, ObjectName name, ObjectName loaderName, Object[] params, String[] signature) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, InstanceNotFoundException

Implements javax.management.MBeanServer.createMBean.

Call checkCreate(className), then forward this method to the wrapped object.

Exceptions
ReflectionException:

Doc from javax.management.MBeanServerConnection.createMBean.

Wraps a java.lang.ClassNotFoundException or a java.lang.Exception that occurred when trying to invoke the MBean's constructor.

InstanceAlreadyExistsException:

Doc from javax.management.MBeanServerConnection.createMBean.

The MBean is already under the control of the MBean server.

MBeanRegistrationException:

Doc from javax.management.MBeanServerConnection.createMBean.

The preRegister (MBeanRegistration interface) method of the MBean has thrown an exception. The MBean will not be registered.

MBeanException:

Doc from javax.management.MBeanServerConnection.createMBean.

The constructor of the MBean has thrown an exception

NotCompliantMBeanException:

Doc from javax.management.MBeanServerConnection.createMBean.

This class is not a JMX compliant MBean

InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.createMBean.

The specified class loader is not registered in the MBean server.

deserializeback to summary
public ObjectInputStream deserialize(ObjectName name, byte[] data) throws InstanceNotFoundException, OperationsException

Overrides default javax.management.MBeanServer.deserialize.

Deprecated

Call checkRead(), then forward this method to the wrapped object.

Annotations
@Deprecated
Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServer.deserialize.

The MBean specified is not found.

OperationsException:

Doc from javax.management.MBeanServer.deserialize.

Any of the usual Input/Output related exceptions.

deserializeback to summary
public ObjectInputStream deserialize(String className, byte[] data) throws OperationsException, ReflectionException

Overrides default javax.management.MBeanServer.deserialize.

Deprecated

Call checkRead(), then forward this method to the wrapped object.

Annotations
@Deprecated
Exceptions
OperationsException:

Doc from javax.management.MBeanServer.deserialize.

Any of the usual Input/Output related exceptions.

ReflectionException:

Doc from javax.management.MBeanServer.deserialize.

The specified class could not be loaded by the class loader repository

deserializeback to summary
public ObjectInputStream deserialize(String className, ObjectName loaderName, byte[] data) throws InstanceNotFoundException, OperationsException, ReflectionException

Overrides default javax.management.MBeanServer.deserialize.

Deprecated

Call checkRead(), then forward this method to the wrapped object.

Annotations
@Deprecated
Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServer.deserialize.

The specified class loader MBean is not found.

OperationsException:

Doc from javax.management.MBeanServer.deserialize.

Any of the usual Input/Output related exceptions.

ReflectionException:

Doc from javax.management.MBeanServer.deserialize.

The specified class could not be loaded by the specified class loader.

getAttributeback to summary
public Object getAttribute(ObjectName name, String attribute) throws MBeanException, AttributeNotFoundException, InstanceNotFoundException, ReflectionException

Implements javax.management.MBeanServer.getAttribute.

Call checkRead(), then forward this method to the wrapped object.

Exceptions
MBeanException:

Doc from javax.management.MBeanServerConnection.getAttribute.

Wraps an exception thrown by the MBean's getter.

AttributeNotFoundException:

Doc from javax.management.MBeanServerConnection.getAttribute.

The attribute specified is not accessible in the MBean.

InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.getAttribute.

The MBean specified is not registered in the MBean server.

ReflectionException:

Doc from javax.management.MBeanServerConnection.getAttribute.

Wraps a java.lang.Exception thrown when trying to invoke the setter.

getAttributesback to summary
public AttributeList getAttributes(ObjectName name, String[] attributes) throws InstanceNotFoundException, ReflectionException

Implements javax.management.MBeanServer.getAttributes.

Call checkRead(), then forward this method to the wrapped object.

Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.getAttributes.

The MBean specified is not registered in the MBean server.

ReflectionException:

Doc from javax.management.MBeanServerConnection.getAttributes.

An exception occurred when trying to invoke the getAttributes method of a Dynamic MBean.

getClassLoaderback to summary
public ClassLoader getClassLoader(ObjectName loaderName) throws InstanceNotFoundException

Implements javax.management.MBeanServer.getClassLoader.

Call checkRead(), then forward this method to the wrapped object.

Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServer.getClassLoader.

if the named ClassLoader is not found.

getClassLoaderForback to summary
public ClassLoader getClassLoaderFor(ObjectName mbeanName) throws InstanceNotFoundException

Implements javax.management.MBeanServer.getClassLoaderFor.

Call checkRead(), then forward this method to the wrapped object.

Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServer.getClassLoaderFor.

if the named MBean is not found.

getClassLoaderRepositoryback to summary
public ClassLoaderRepository getClassLoaderRepository()

Implements javax.management.MBeanServer.getClassLoaderRepository.

Call checkRead(), then forward this method to the wrapped object.

getDefaultDomainback to summary
public String getDefaultDomain()

Implements javax.management.MBeanServer.getDefaultDomain.

Call checkRead(), then forward this method to the wrapped object.

getDomainsback to summary
public String[] getDomains()

Implements javax.management.MBeanServer.getDomains.

Call checkRead(), then forward this method to the wrapped object.

getMBeanCountback to summary
public Integer getMBeanCount()

Implements javax.management.MBeanServer.getMBeanCount.

Call checkRead(), then forward this method to the wrapped object.

getMBeanInfoback to summary
public MBeanInfo getMBeanInfo(ObjectName name) throws InstanceNotFoundException, IntrospectionException, ReflectionException

Implements javax.management.MBeanServer.getMBeanInfo.

Call checkRead(), then forward this method to the wrapped object.

Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.getMBeanInfo.

The MBean specified was not found.

IntrospectionException:

Doc from javax.management.MBeanServerConnection.getMBeanInfo.

An exception occurred during introspection.

ReflectionException:

Doc from javax.management.MBeanServerConnection.getMBeanInfo.

An exception occurred when trying to invoke the getMBeanInfo of a Dynamic MBean.

getMBeanServerback to summary
public MBeanServer getMBeanServer()

Implements javax.management.remote.MBeanServerForwarder.getMBeanServer.

Doc from javax.management.remote.MBeanServerForwarder.getMBeanServer.

Returns the MBeanServer object to which requests will be forwarded.

getObjectInstanceback to summary
public ObjectInstance getObjectInstance(ObjectName name) throws InstanceNotFoundException

Implements javax.management.MBeanServer.getObjectInstance.

Call checkRead(), then forward this method to the wrapped object.

Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.getObjectInstance.

The MBean specified is not registered in the MBean server.

instantiateback to summary
public Object instantiate(String className) throws ReflectionException, MBeanException

Implements javax.management.MBeanServer.instantiate.

Call checkCreate(className), then forward this method to the wrapped object.

Exceptions
ReflectionException:

Doc from javax.management.MBeanServer.instantiate.

Wraps a java.lang.ClassNotFoundException or the java.lang.Exception that occurred when trying to invoke the object's constructor.

MBeanException:

Doc from javax.management.MBeanServer.instantiate.

The constructor of the object has thrown an exception

instantiateback to summary
public Object instantiate(String className, Object[] params, String[] signature) throws ReflectionException, MBeanException

Implements javax.management.MBeanServer.instantiate.

Call checkCreate(className), then forward this method to the wrapped object.

Exceptions
ReflectionException:

Doc from javax.management.MBeanServer.instantiate.

Wraps a java.lang.ClassNotFoundException or the java.lang.Exception that occurred when trying to invoke the object's constructor.

MBeanException:

Doc from javax.management.MBeanServer.instantiate.

The constructor of the object has thrown an exception

instantiateback to summary
public Object instantiate(String className, ObjectName loaderName) throws ReflectionException, MBeanException, InstanceNotFoundException

Implements javax.management.MBeanServer.instantiate.

Call checkCreate(className), then forward this method to the wrapped object.

Exceptions
ReflectionException:

Doc from javax.management.MBeanServer.instantiate.

Wraps a java.lang.ClassNotFoundException or the java.lang.Exception that occurred when trying to invoke the object's constructor.

MBeanException:

Doc from javax.management.MBeanServer.instantiate.

The constructor of the object has thrown an exception.

InstanceNotFoundException:

Doc from javax.management.MBeanServer.instantiate.

The specified class loader is not registered in the MBeanServer.

instantiateback to summary
public Object instantiate(String className, ObjectName loaderName, Object[] params, String[] signature) throws ReflectionException, MBeanException, InstanceNotFoundException

Implements javax.management.MBeanServer.instantiate.

Call checkCreate(className), then forward this method to the wrapped object.

Exceptions
ReflectionException:

Doc from javax.management.MBeanServer.instantiate.

Wraps a java.lang.ClassNotFoundException or the java.lang.Exception that occurred when trying to invoke the object's constructor.

MBeanException:

Doc from javax.management.MBeanServer.instantiate.

The constructor of the object has thrown an exception

InstanceNotFoundException:

Doc from javax.management.MBeanServer.instantiate.

The specified class loader is not registered in the MBean server.

invokeback to summary
public Object invoke(ObjectName name, String operationName, Object[] params, String[] signature) throws InstanceNotFoundException, MBeanException, ReflectionException

Implements javax.management.MBeanServer.invoke.

Call checkWrite(), then forward this method to the wrapped object.

Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.invoke.

The MBean specified is not registered in the MBean server.

MBeanException:

Doc from javax.management.MBeanServerConnection.invoke.

Wraps an exception thrown by the MBean's invoked method.

ReflectionException:

Doc from javax.management.MBeanServerConnection.invoke.

Wraps a java.lang.Exception thrown while trying to invoke the method.

isInstanceOfback to summary
public boolean isInstanceOf(ObjectName name, String className) throws InstanceNotFoundException

Implements javax.management.MBeanServer.isInstanceOf.

Call checkRead(), then forward this method to the wrapped object.

Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.isInstanceOf.

The MBean specified is not registered in the MBean server.

isRegisteredback to summary
public boolean isRegistered(ObjectName name)

Implements javax.management.MBeanServer.isRegistered.

Call checkRead(), then forward this method to the wrapped object.

queryMBeansback to summary
public Set<ObjectInstance> queryMBeans(ObjectName name, QueryExp query)

Implements javax.management.MBeanServer.queryMBeans.

Call checkRead(), then forward this method to the wrapped object.

queryNamesback to summary
public Set<ObjectName> queryNames(ObjectName name, QueryExp query)

Implements javax.management.MBeanServer.queryNames.

Call checkRead(), then forward this method to the wrapped object.

registerMBeanback to summary
public ObjectInstance registerMBean(Object object, ObjectName name) throws InstanceAlreadyExistsException, MBeanRegistrationException, NotCompliantMBeanException

Implements javax.management.MBeanServer.registerMBean.

Call checkWrite(), then forward this method to the wrapped object.

Exceptions
InstanceAlreadyExistsException:

Doc from javax.management.MBeanServer.registerMBean.

The MBean is already under the control of the MBean server.

MBeanRegistrationException:

Doc from javax.management.MBeanServer.registerMBean.

The preRegister (MBeanRegistration interface) method of the MBean has thrown an exception. The MBean will not be registered.

NotCompliantMBeanException:

Doc from javax.management.MBeanServer.registerMBean.

This object is not a JMX compliant MBean

removeNotificationListenerback to summary
public void removeNotificationListener(ObjectName name, NotificationListener listener) throws InstanceNotFoundException, ListenerNotFoundException

Implements javax.management.MBeanServer.removeNotificationListener.

Call checkRead(), then forward this method to the wrapped object.

Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.removeNotificationListener.

The MBean name provided does not match any of the registered MBeans.

ListenerNotFoundException:

Doc from javax.management.MBeanServerConnection.removeNotificationListener.

The listener is not registered in the MBean.

removeNotificationListenerback to summary
public void removeNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback) throws InstanceNotFoundException, ListenerNotFoundException

Implements javax.management.MBeanServer.removeNotificationListener.

Call checkRead(), then forward this method to the wrapped object.

Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.removeNotificationListener.

The MBean name provided does not match any of the registered MBeans.

ListenerNotFoundException:

Doc from javax.management.MBeanServerConnection.removeNotificationListener.

The listener is not registered in the MBean, or it is not registered with the given filter and handback.

removeNotificationListenerback to summary
public void removeNotificationListener(ObjectName name, ObjectName listener) throws InstanceNotFoundException, ListenerNotFoundException

Implements javax.management.MBeanServer.removeNotificationListener.

Call checkRead(), then forward this method to the wrapped object.

Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.removeNotificationListener.

The MBean name provided does not match any of the registered MBeans.

ListenerNotFoundException:

Doc from javax.management.MBeanServerConnection.removeNotificationListener.

The listener is not registered in the MBean.

removeNotificationListenerback to summary
public void removeNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback) throws InstanceNotFoundException, ListenerNotFoundException

Implements javax.management.MBeanServer.removeNotificationListener.

Call checkRead(), then forward this method to the wrapped object.

Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.removeNotificationListener.

The MBean name provided does not match any of the registered MBeans.

ListenerNotFoundException:

Doc from javax.management.MBeanServerConnection.removeNotificationListener.

The listener is not registered in the MBean, or it is not registered with the given filter and handback.

setAttributeback to summary
public void setAttribute(ObjectName name, Attribute attribute) throws InstanceNotFoundException, AttributeNotFoundException, InvalidAttributeValueException, MBeanException, ReflectionException

Implements javax.management.MBeanServer.setAttribute.

Call checkWrite(), then forward this method to the wrapped object.

Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.setAttribute.

The MBean specified is not registered in the MBean server.

AttributeNotFoundException:

Doc from javax.management.MBeanServerConnection.setAttribute.

The attribute specified is not accessible in the MBean.

InvalidAttributeValueException:

Doc from javax.management.MBeanServerConnection.setAttribute.

The value specified for the attribute is not valid.

MBeanException:

Doc from javax.management.MBeanServerConnection.setAttribute.

Wraps an exception thrown by the MBean's setter.

ReflectionException:

Doc from javax.management.MBeanServerConnection.setAttribute.

Wraps a java.lang.Exception thrown when trying to invoke the setter.

setAttributesback to summary
public AttributeList setAttributes(ObjectName name, AttributeList attributes) throws InstanceNotFoundException, ReflectionException

Implements javax.management.MBeanServer.setAttributes.

Call checkWrite(), then forward this method to the wrapped object.

Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.setAttributes.

The MBean specified is not registered in the MBean server.

ReflectionException:

Doc from javax.management.MBeanServerConnection.setAttributes.

An exception occurred when trying to invoke the getAttributes method of a Dynamic MBean.

setMBeanServerback to summary
public void setMBeanServer(MBeanServer mbs)

Implements javax.management.remote.MBeanServerForwarder.setMBeanServer.

Doc from javax.management.remote.MBeanServerForwarder.setMBeanServer.

Sets the MBeanServer object to which requests will be forwarded after treatment by this object.

unregisterMBeanback to summary
public void unregisterMBean(ObjectName name) throws InstanceNotFoundException, MBeanRegistrationException

Implements javax.management.MBeanServer.unregisterMBean.

Call checkUnregister(), then forward this method to the wrapped object.

Exceptions
InstanceNotFoundException:

Doc from javax.management.MBeanServerConnection.unregisterMBean.

The MBean specified is not registered in the MBean server.

MBeanRegistrationException:

Doc from javax.management.MBeanServerConnection.unregisterMBean.

The preDeregister (MBeanRegistration interface) method of the MBean has thrown an exception.