com.sun.jdmk.remote.cascading
Class MBeanServerConnectionWrapper

java.lang.Object
  com.sun.jdmk.remote.cascading.MBeanServerConnectionWrapper

All Implemented Interfaces:

javax.management.MBeanServer, javax.management.MBeanServerConnection

public abstract class MBeanServerConnectionWrapper
extends java.lang.Object
implements javax.management.MBeanServer

An object of this class implements the MBeanServer interface and, for each of its methods forwards the request to a wrapped MBeanServerConnection object. Some methods of the MBeanServer interface do not have any equivalent in MBeanServerConnection. In that case, an UnsupportedOperationException will be thrown.

A typical use of this class is to apply a QueryExp object locally, on an MBean that resides in a remote MBeanServer. Since an MBeanServerConnection is not an MBeanServer, it cannot be passed to the setMBeanServer() method of the QueryExp object. However, this object can.

This is an abstract class, and although only getMBeanServerConnection() is declared abstract, implementing this single method will usually not be sufficient in order to substitute an instance of this class to an MBeanServer in the general case: for instance, the methods like getClassLoader(javax.management.ObjectName), getClassLoaderFor(javax.management.ObjectName) etc... which are not part of the MBeanServerConnection interface will throw an UnsupportedOperationException in their default implementation. Therefore, it would not be appropriate to pass an instance of this class to an object that expect these methods to be implemented, unless those methods have been appropriately implemented in a subclass.

Since:

Java DMK 5.1

Constructor Summary

MBeanServerConnectionWrapper()

Method Summary

void	addNotificationListener(javax.management.ObjectName name, javax.management.NotificationListener listener, javax.management.NotificationFilter filter, java.lang.Object handback) Forward this method to the wrapped object.
void	addNotificationListener(javax.management.ObjectName name, javax.management.ObjectName listener, javax.management.NotificationFilter filter, java.lang.Object handback) Forward this method to the wrapped object.
javax.management.ObjectInstance	createMBean(java.lang.String className, javax.management.ObjectName name) Forward this method to the wrapped object.
javax.management.ObjectInstance	createMBean(java.lang.String className, javax.management.ObjectName name, java.lang.Object[] params, java.lang.String[] signature) Forward this method to the wrapped object.
javax.management.ObjectInstance	createMBean(java.lang.String className, javax.management.ObjectName name, javax.management.ObjectName loaderName) Forward this method to the wrapped object.
javax.management.ObjectInstance	createMBean(java.lang.String className, javax.management.ObjectName name, javax.management.ObjectName loaderName, java.lang.Object[] params, java.lang.String[] signature) Forward this method to the wrapped object.
java.io.ObjectInputStream	deserialize(javax.management.ObjectName name, byte[] data) Throws an UnsupportedOperationException.
java.io.ObjectInputStream	deserialize(java.lang.String className, byte[] data) Throws an UnsupportedOperationException.
java.io.ObjectInputStream	deserialize(java.lang.String className, javax.management.ObjectName loaderName, byte[] data) Throws an UnsupportedOperationException.
java.lang.Object	getAttribute(javax.management.ObjectName name, java.lang.String attribute) Forward this method to the wrapped object.
javax.management.AttributeList	getAttributes(javax.management.ObjectName name, java.lang.String[] attributes) Forward this method to the wrapped object.
java.lang.ClassLoader	getClassLoader(javax.management.ObjectName loaderName) Throws an UnsupportedOperationException.
java.lang.ClassLoader	getClassLoaderFor(javax.management.ObjectName mbeanName) Throws an UnsupportedOperationException.
javax.management.loading.ClassLoaderRepository	getClassLoaderRepository() Throws an UnsupportedOperationException.
java.lang.String	getDefaultDomain() Forward this method to the wrapped object.
java.lang.String[]	getDomains() Forward this method to the wrapped object.
java.lang.Integer	getMBeanCount() Forward this method to the wrapped object.
javax.management.MBeanInfo	getMBeanInfo(javax.management.ObjectName name) Forward this method to the wrapped object.
protected abstract javax.management.MBeanServerConnection	getMBeanServerConnection() Returns an MBeanServerConnection.
javax.management.ObjectInstance	getObjectInstance(javax.management.ObjectName name) Forward this method to the wrapped object.
protected java.lang.RuntimeException	handleIOException(java.io.IOException x, java.lang.String method) This method is called each time an IOException is raised when trying to forward an operation to the underlying MBeanServerConnection, as a result of calling getMBeanServerConnection() or as a result of invoking the operation on the returned connection.
java.lang.Object	instantiate(java.lang.String className) Throws an UnsupportedOperationException.
java.lang.Object	instantiate(java.lang.String className, java.lang.Object[] params, java.lang.String[] signature) Throws an UnsupportedOperationException.
java.lang.Object	instantiate(java.lang.String className, javax.management.ObjectName loaderName) Throws an UnsupportedOperationException.
java.lang.Object	instantiate(java.lang.String className, javax.management.ObjectName loaderName, java.lang.Object[] params, java.lang.String[] signature) Throws an UnsupportedOperationException.
java.lang.Object	invoke(javax.management.ObjectName name, java.lang.String operationName, java.lang.Object[] params, java.lang.String[] signature) Forward this method to the wrapped object.
boolean	isInstanceOf(javax.management.ObjectName name, java.lang.String className) Forward this method to the wrapped object.
boolean	isRegistered(javax.management.ObjectName name) Forward this method to the wrapped object.
java.util.Set	queryMBeans(javax.management.ObjectName name, javax.management.QueryExp query) Forward this method to the wrapped object.
java.util.Set	queryNames(javax.management.ObjectName name, javax.management.QueryExp query) Forward this method to the wrapped object.
javax.management.ObjectInstance	registerMBean(java.lang.Object object, javax.management.ObjectName name) Throws an UnsupportedOperationException.
void	removeNotificationListener(javax.management.ObjectName name, javax.management.NotificationListener listener) Forward this method to the wrapped object.
void	removeNotificationListener(javax.management.ObjectName name, javax.management.NotificationListener listener, javax.management.NotificationFilter filter, java.lang.Object handback) Forward this method to the wrapped object.
void	removeNotificationListener(javax.management.ObjectName name, javax.management.ObjectName listener) Forward this method to the wrapped object.
void	removeNotificationListener(javax.management.ObjectName name, javax.management.ObjectName listener, javax.management.NotificationFilter filter, java.lang.Object handback) Forward this method to the wrapped object.
void	setAttribute(javax.management.ObjectName name, javax.management.Attribute attribute) Forward this method to the wrapped object.
javax.management.AttributeList	setAttributes(javax.management.ObjectName name, javax.management.AttributeList attributes) Forward this method to the wrapped object.
void	unregisterMBean(javax.management.ObjectName name) Forward this method to the wrapped object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MBeanServerConnectionWrapper

public MBeanServerConnectionWrapper()

Method Detail

getMBeanServerConnection

protected abstract javax.management.MBeanServerConnection getMBeanServerConnection()
                                                                            throws java.io.IOException

Returns an MBeanServerConnection. This method is called each time an operation must be invoked on the underlying MBeanServerConnection.

Throws:

java.io.IOException

handleIOException

protected java.lang.RuntimeException handleIOException(java.io.IOException x,
                                                       java.lang.String method)

This method is called each time an IOException is raised when trying to forward an operation to the underlying MBeanServerConnection, as a result of calling getMBeanServerConnection() or as a result of invoking the operation on the returned connection. Subclasses may redefine this method if they need to perform any specific handling of IOException (logging etc...).

Parameters:

x - The raised IOException.

method - The name of the method in which the exception was raised. This is one of the methods of the MBeanServer interface.

Returns:

A RuntimeException that should be thrown by the caller. In this default implementation, this is an UndeclaredThrowableException wrapping x.

addNotificationListener

public void addNotificationListener(javax.management.ObjectName name,
                                    javax.management.NotificationListener listener,
                                    javax.management.NotificationFilter filter,
                                    java.lang.Object handback)
                             throws javax.management.InstanceNotFoundException

Forward this method to the wrapped object.

Specified by:

addNotificationListener in interface javax.management.MBeanServer

Specified by:

addNotificationListener in interface javax.management.MBeanServerConnection

Throws:

javax.management.InstanceNotFoundException

addNotificationListener

public void addNotificationListener(javax.management.ObjectName name,
                                    javax.management.ObjectName listener,
                                    javax.management.NotificationFilter filter,
                                    java.lang.Object handback)
                             throws javax.management.InstanceNotFoundException

Forward this method to the wrapped object.

Specified by:

addNotificationListener in interface javax.management.MBeanServer

Specified by:

addNotificationListener in interface javax.management.MBeanServerConnection

Throws:

javax.management.InstanceNotFoundException

createMBean

public javax.management.ObjectInstance createMBean(java.lang.String className,
                                                   javax.management.ObjectName name)
                                            throws javax.management.ReflectionException,
                                                   javax.management.InstanceAlreadyExistsException,
                                                   javax.management.MBeanRegistrationException,
                                                   javax.management.MBeanException,
                                                   javax.management.NotCompliantMBeanException

Forward this method to the wrapped object.

Specified by:

createMBean in interface javax.management.MBeanServer

Specified by:

createMBean in interface javax.management.MBeanServerConnection

Throws:

javax.management.ReflectionException

javax.management.InstanceAlreadyExistsException

javax.management.MBeanRegistrationException

javax.management.MBeanException

javax.management.NotCompliantMBeanException

createMBean

public javax.management.ObjectInstance createMBean(java.lang.String className,
                                                   javax.management.ObjectName name,
                                                   java.lang.Object[] params,
                                                   java.lang.String[] signature)
                                            throws javax.management.ReflectionException,
                                                   javax.management.InstanceAlreadyExistsException,
                                                   javax.management.MBeanRegistrationException,
                                                   javax.management.MBeanException,
                                                   javax.management.NotCompliantMBeanException

Forward this method to the wrapped object.

Specified by:

createMBean in interface javax.management.MBeanServer

Specified by:

createMBean in interface javax.management.MBeanServerConnection

Throws:

javax.management.ReflectionException

javax.management.InstanceAlreadyExistsException

javax.management.MBeanRegistrationException

javax.management.MBeanException

javax.management.NotCompliantMBeanException

createMBean

public javax.management.ObjectInstance createMBean(java.lang.String className,
                                                   javax.management.ObjectName name,
                                                   javax.management.ObjectName loaderName)
                                            throws javax.management.ReflectionException,
                                                   javax.management.InstanceAlreadyExistsException,
                                                   javax.management.MBeanRegistrationException,
                                                   javax.management.MBeanException,
                                                   javax.management.NotCompliantMBeanException,
                                                   javax.management.InstanceNotFoundException

Forward this method to the wrapped object.

Specified by:

createMBean in interface javax.management.MBeanServer

Specified by:

createMBean in interface javax.management.MBeanServerConnection

Throws:

javax.management.ReflectionException

javax.management.InstanceAlreadyExistsException

javax.management.MBeanRegistrationException

javax.management.MBeanException

javax.management.NotCompliantMBeanException

javax.management.InstanceNotFoundException

createMBean

public javax.management.ObjectInstance createMBean(java.lang.String className,
                                                   javax.management.ObjectName name,
                                                   javax.management.ObjectName loaderName,
                                                   java.lang.Object[] params,
                                                   java.lang.String[] signature)
                                            throws javax.management.ReflectionException,
                                                   javax.management.InstanceAlreadyExistsException,
                                                   javax.management.MBeanRegistrationException,
                                                   javax.management.MBeanException,
                                                   javax.management.NotCompliantMBeanException,
                                                   javax.management.InstanceNotFoundException

Forward this method to the wrapped object.

Specified by:

createMBean in interface javax.management.MBeanServer

Specified by:

createMBean in interface javax.management.MBeanServerConnection

Throws:

javax.management.ReflectionException

javax.management.InstanceAlreadyExistsException

javax.management.MBeanRegistrationException

javax.management.MBeanException

javax.management.NotCompliantMBeanException

javax.management.InstanceNotFoundException

deserialize

public java.io.ObjectInputStream deserialize(javax.management.ObjectName name,
                                             byte[] data)
                                      throws javax.management.InstanceNotFoundException,
                                             javax.management.OperationsException

Throws an UnsupportedOperationException. This behavior can be changed by subclasses.

Specified by:

deserialize in interface javax.management.MBeanServer

Throws:

javax.management.InstanceNotFoundException

javax.management.OperationsException

deserialize

public java.io.ObjectInputStream deserialize(java.lang.String className,
                                             byte[] data)
                                      throws javax.management.OperationsException,
                                             javax.management.ReflectionException

Throws an UnsupportedOperationException. This behavior can be changed by subclasses.

Specified by:

deserialize in interface javax.management.MBeanServer

Throws:

javax.management.OperationsException

javax.management.ReflectionException

deserialize

public java.io.ObjectInputStream deserialize(java.lang.String className,
                                             javax.management.ObjectName loaderName,
                                             byte[] data)
                                      throws javax.management.InstanceNotFoundException,
                                             javax.management.OperationsException,
                                             javax.management.ReflectionException

Throws an UnsupportedOperationException. This behavior can be changed by subclasses.

Specified by:

deserialize in interface javax.management.MBeanServer

Throws:

javax.management.InstanceNotFoundException

javax.management.OperationsException

javax.management.ReflectionException

getAttribute

public java.lang.Object getAttribute(javax.management.ObjectName name,
                                     java.lang.String attribute)
                              throws javax.management.MBeanException,
                                     javax.management.AttributeNotFoundException,
                                     javax.management.InstanceNotFoundException,
                                     javax.management.ReflectionException

Forward this method to the wrapped object.

Specified by:

getAttribute in interface javax.management.MBeanServer

Specified by:

getAttribute in interface javax.management.MBeanServerConnection

Throws:

javax.management.MBeanException

javax.management.AttributeNotFoundException

javax.management.InstanceNotFoundException

javax.management.ReflectionException

getAttributes

public javax.management.AttributeList getAttributes(javax.management.ObjectName name,
                                                    java.lang.String[] attributes)
                                             throws javax.management.InstanceNotFoundException,
                                                    javax.management.ReflectionException

Forward this method to the wrapped object.

Specified by:

getAttributes in interface javax.management.MBeanServer

Specified by:

getAttributes in interface javax.management.MBeanServerConnection

Throws:

javax.management.InstanceNotFoundException

javax.management.ReflectionException

getClassLoader

public java.lang.ClassLoader getClassLoader(javax.management.ObjectName loaderName)
                                     throws javax.management.InstanceNotFoundException

Throws an UnsupportedOperationException. This behavior can be changed by subclasses.

Specified by:

getClassLoader in interface javax.management.MBeanServer

Throws:

javax.management.InstanceNotFoundException

getClassLoaderFor

public java.lang.ClassLoader getClassLoaderFor(javax.management.ObjectName mbeanName)
                                        throws javax.management.InstanceNotFoundException

Throws an UnsupportedOperationException. This behavior can be changed by subclasses.

Specified by:

getClassLoaderFor in interface javax.management.MBeanServer

Throws:

javax.management.InstanceNotFoundException

getClassLoaderRepository

public javax.management.loading.ClassLoaderRepository getClassLoaderRepository()

Throws an UnsupportedOperationException. This behavior can be changed by subclasses.

Specified by:

getClassLoaderRepository in interface javax.management.MBeanServer

getDefaultDomain

public java.lang.String getDefaultDomain()

Forward this method to the wrapped object.

Specified by:

getDefaultDomain in interface javax.management.MBeanServer

Specified by:

getDefaultDomain in interface javax.management.MBeanServerConnection

getDomains

public java.lang.String[] getDomains()

Forward this method to the wrapped object.

Specified by:

getDomains in interface javax.management.MBeanServer

Specified by:

getDomains in interface javax.management.MBeanServerConnection

getMBeanCount

public java.lang.Integer getMBeanCount()

Forward this method to the wrapped object.

Specified by:

getMBeanCount in interface javax.management.MBeanServer

Specified by:

getMBeanCount in interface javax.management.MBeanServerConnection

getMBeanInfo

public javax.management.MBeanInfo getMBeanInfo(javax.management.ObjectName name)
                                        throws javax.management.InstanceNotFoundException,
                                               javax.management.IntrospectionException,
                                               javax.management.ReflectionException

Forward this method to the wrapped object.

Specified by:

getMBeanInfo in interface javax.management.MBeanServer

Specified by:

getMBeanInfo in interface javax.management.MBeanServerConnection

Throws:

javax.management.InstanceNotFoundException

javax.management.IntrospectionException

javax.management.ReflectionException

getObjectInstance

public javax.management.ObjectInstance getObjectInstance(javax.management.ObjectName name)
                                                  throws javax.management.InstanceNotFoundException

Forward this method to the wrapped object.

Specified by:

getObjectInstance in interface javax.management.MBeanServer

Specified by:

getObjectInstance in interface javax.management.MBeanServerConnection

Throws:

javax.management.InstanceNotFoundException

instantiate

public java.lang.Object instantiate(java.lang.String className)
                             throws javax.management.ReflectionException,
                                    javax.management.MBeanException

Throws an UnsupportedOperationException. This behavior can be changed by subclasses.

Specified by:

instantiate in interface javax.management.MBeanServer

Throws:

javax.management.ReflectionException

javax.management.MBeanException

instantiate

public java.lang.Object instantiate(java.lang.String className,
                                    java.lang.Object[] params,
                                    java.lang.String[] signature)
                             throws javax.management.ReflectionException,
                                    javax.management.MBeanException

Throws an UnsupportedOperationException. This behavior can be changed by subclasses.

Specified by:

instantiate in interface javax.management.MBeanServer

Throws:

javax.management.ReflectionException

javax.management.MBeanException

instantiate

public java.lang.Object instantiate(java.lang.String className,
                                    javax.management.ObjectName loaderName)
                             throws javax.management.ReflectionException,
                                    javax.management.MBeanException,
                                    javax.management.InstanceNotFoundException

Throws an UnsupportedOperationException. This behavior can be changed by subclasses.

Specified by:

instantiate in interface javax.management.MBeanServer

Throws:

javax.management.ReflectionException

javax.management.MBeanException

javax.management.InstanceNotFoundException

instantiate

public java.lang.Object instantiate(java.lang.String className,
                                    javax.management.ObjectName loaderName,
                                    java.lang.Object[] params,
                                    java.lang.String[] signature)
                             throws javax.management.ReflectionException,
                                    javax.management.MBeanException,
                                    javax.management.InstanceNotFoundException

Throws an UnsupportedOperationException. This behavior can be changed by subclasses.

Specified by:

instantiate in interface javax.management.MBeanServer

Throws:

javax.management.ReflectionException

javax.management.MBeanException

javax.management.InstanceNotFoundException

invoke

public java.lang.Object invoke(javax.management.ObjectName name,
                               java.lang.String operationName,
                               java.lang.Object[] params,
                               java.lang.String[] signature)
                        throws javax.management.InstanceNotFoundException,
                               javax.management.MBeanException,
                               javax.management.ReflectionException

Forward this method to the wrapped object.

Specified by:

invoke in interface javax.management.MBeanServer

Specified by:

invoke in interface javax.management.MBeanServerConnection

Throws:

javax.management.InstanceNotFoundException

javax.management.MBeanException

javax.management.ReflectionException

isInstanceOf

public boolean isInstanceOf(javax.management.ObjectName name,
                            java.lang.String className)
                     throws javax.management.InstanceNotFoundException

Forward this method to the wrapped object.

Specified by:

isInstanceOf in interface javax.management.MBeanServer

Specified by:

isInstanceOf in interface javax.management.MBeanServerConnection

Throws:

javax.management.InstanceNotFoundException

isRegistered

public boolean isRegistered(javax.management.ObjectName name)

Forward this method to the wrapped object.

Specified by:

isRegistered in interface javax.management.MBeanServer

Specified by:

isRegistered in interface javax.management.MBeanServerConnection

queryMBeans

public java.util.Set queryMBeans(javax.management.ObjectName name,
                                 javax.management.QueryExp query)

Forward this method to the wrapped object. If an IOException is raised, returns an empty Set.

Specified by:

queryMBeans in interface javax.management.MBeanServer

Specified by:

queryMBeans in interface javax.management.MBeanServerConnection

queryNames

public java.util.Set queryNames(javax.management.ObjectName name,
                                javax.management.QueryExp query)

Forward this method to the wrapped object. If an IOException is raised, returns an empty Set.

Specified by:

queryNames in interface javax.management.MBeanServer

Specified by:

queryNames in interface javax.management.MBeanServerConnection

registerMBean

public javax.management.ObjectInstance registerMBean(java.lang.Object object,
                                                     javax.management.ObjectName name)
                                              throws javax.management.InstanceAlreadyExistsException,
                                                     javax.management.MBeanRegistrationException,
                                                     javax.management.NotCompliantMBeanException

Throws an UnsupportedOperationException. This behavior can be changed by subclasses.

Specified by:

registerMBean in interface javax.management.MBeanServer

Throws:

javax.management.InstanceAlreadyExistsException

javax.management.MBeanRegistrationException

javax.management.NotCompliantMBeanException

removeNotificationListener

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

Forward this method to the wrapped object.

Specified by:

removeNotificationListener in interface javax.management.MBeanServer

Specified by:

removeNotificationListener in interface javax.management.MBeanServerConnection

Throws:

javax.management.InstanceNotFoundException

javax.management.ListenerNotFoundException

removeNotificationListener

public void removeNotificationListener(javax.management.ObjectName name,
                                       javax.management.NotificationListener listener,
                                       javax.management.NotificationFilter filter,
                                       java.lang.Object handback)
                                throws javax.management.InstanceNotFoundException,
                                       javax.management.ListenerNotFoundException

Forward this method to the wrapped object.

Specified by:

removeNotificationListener in interface javax.management.MBeanServer

Specified by:

removeNotificationListener in interface javax.management.MBeanServerConnection

Throws:

javax.management.InstanceNotFoundException

javax.management.ListenerNotFoundException

removeNotificationListener

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

Forward this method to the wrapped object.

Specified by:

removeNotificationListener in interface javax.management.MBeanServer

Specified by:

removeNotificationListener in interface javax.management.MBeanServerConnection

Throws:

javax.management.InstanceNotFoundException

javax.management.ListenerNotFoundException

removeNotificationListener

public void removeNotificationListener(javax.management.ObjectName name,
                                       javax.management.ObjectName listener,
                                       javax.management.NotificationFilter filter,
                                       java.lang.Object handback)
                                throws javax.management.InstanceNotFoundException,
                                       javax.management.ListenerNotFoundException

Forward this method to the wrapped object.

Specified by:

removeNotificationListener in interface javax.management.MBeanServer

Specified by:

removeNotificationListener in interface javax.management.MBeanServerConnection

Throws:

javax.management.InstanceNotFoundException

javax.management.ListenerNotFoundException

setAttribute

public void setAttribute(javax.management.ObjectName name,
                         javax.management.Attribute attribute)
                  throws javax.management.InstanceNotFoundException,
                         javax.management.AttributeNotFoundException,
                         javax.management.InvalidAttributeValueException,
                         javax.management.MBeanException,
                         javax.management.ReflectionException

Forward this method to the wrapped object.

Specified by:

setAttribute in interface javax.management.MBeanServer

Specified by:

setAttribute in interface javax.management.MBeanServerConnection

Throws:

javax.management.InstanceNotFoundException

javax.management.AttributeNotFoundException

javax.management.InvalidAttributeValueException

javax.management.MBeanException

javax.management.ReflectionException

setAttributes

public javax.management.AttributeList setAttributes(javax.management.ObjectName name,
                                                    javax.management.AttributeList attributes)
                                             throws javax.management.InstanceNotFoundException,
                                                    javax.management.ReflectionException

Forward this method to the wrapped object.

Specified by:

setAttributes in interface javax.management.MBeanServer

Specified by:

setAttributes in interface javax.management.MBeanServerConnection

Throws:

javax.management.InstanceNotFoundException

javax.management.ReflectionException

unregisterMBean

public void unregisterMBean(javax.management.ObjectName name)
                     throws javax.management.InstanceNotFoundException,
                            javax.management.MBeanRegistrationException

Forward this method to the wrapped object.

Specified by:

unregisterMBean in interface javax.management.MBeanServer

Specified by:

unregisterMBean in interface javax.management.MBeanServerConnection

Throws:

javax.management.InstanceNotFoundException

javax.management.MBeanRegistrationException