org.exoplatform.container.jmx
Class AbstractDynamicMBean

java.lang.Object
  org.exoplatform.container.jmx.AbstractDynamicMBean

All Implemented Interfaces:

DynamicMBean

Direct Known Subclasses:

ExoContainerMBean

public abstract class AbstractDynamicMBean
extends Object
implements DynamicMBean

Constructor Summary

protected

AbstractDynamicMBean() Only subclasses can create a new instance of an AbstractDynamicMBean.

Method Summary

protected MBeanAttributeInfo[]	createMBeanAttributeInfo() To be overridden to return metadata information about manageable attributes.
protected MBeanConstructorInfo[]	createMBeanConstructorInfo() To be overridden to return metadata information about manageable constructors.
protected MBeanInfo	createMBeanInfo() Creates the MBeanInfo for this instance, calling in succession factory methods that the user can override.
protected MBeanNotificationInfo[]	createMBeanNotificationInfo() To be overridden to return metadata information about manageable notifications.
protected MBeanOperationInfo[]	createMBeanOperationInfo() To be overridden to return metadata information about manageable operations.
protected Method	findMethod(Class cls, String name, Class[] params) Returns the (public) method with the given name and signature on the given class.
Object	getAttribute(String attribute) Returns the value of the manageable attribute, as specified by the DynamicMBean interface.
AttributeList	getAttributes(String[] attributes) Returns the manageable attributes, as specified by the DynamicMBean interface.
protected String	getMBeanClassName() To be overridden to return metadata information about the class name of this MBean; by default returns this class' name.
protected String	getMBeanDescription() To be overridden to return metadata information about the description of this MBean.
MBeanInfo	getMBeanInfo() Returns the MBeaInfo, as specified by the DynamicMBean interface; the default implementation caches the value returned by createMBeanInfo() (that is thus called only once).
protected Object	getResource() Returns the resource object on which invoke attribute's getters, attribute's setters and operation's methods
protected Object	invoke(Object resource, String name, Class[] params, Object[] args) Looks up the method to call on given resource and invokes it.
protected Object	invoke(String name, Class[] params, Object[] args) Deprecated. Replaced by invoke(Object,String,Class[],Object[]). The resource passed is the resource as set by setResource(java.lang.Object) or - if it is null - 'this' instance. This method is deprecated because it is not thread safe.
Object	invoke(String method, Object[] arguments, String[] params) Returns the value of the manageable operation as specified by the DynamicMBean interface
protected Object	invokeMethod(Method method, Object resource, Object[] args) Invokes the given method on the given resource object with the given arguments.
void	setAttribute(Attribute attribute) Sets the value of the manageable attribute, as specified by the DynamicMBean interface.
AttributeList	setAttributes(AttributeList attributes) Sets the manageable attributes, as specified by the DynamicMBean interface.
protected void	setMBeanInfo(MBeanInfo info) Sets the MBeanInfo object cached by this instance.
void	setResource(Object resource) Specifies the resource object on which invoke attribute's getters, attribute's setters and operation's methods.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractDynamicMBean

protected AbstractDynamicMBean()

Only subclasses can create a new instance of an AbstractDynamicMBean.

See Also:

createMBeanConstructorInfo()

Method Detail

getAttribute

public Object getAttribute(String attribute)
                    throws AttributeNotFoundException,
                           MBeanException,
                           ReflectionException

Returns the value of the manageable attribute, as specified by the DynamicMBean interface.

Specified by:

getAttribute in interface DynamicMBean

Throws:

AttributeNotFoundException

MBeanException

ReflectionException

See Also:

createMBeanAttributeInfo()

getAttributes

public AttributeList getAttributes(String[] attributes)

Returns the manageable attributes, as specified by the DynamicMBean interface.

Specified by:

getAttributes in interface DynamicMBean

getMBeanInfo

public MBeanInfo getMBeanInfo()

Returns the MBeaInfo, as specified by the DynamicMBean interface; the default implementation caches the value returned by createMBeanInfo() (that is thus called only once).

Specified by:

getMBeanInfo in interface DynamicMBean

See Also:

createMBeanInfo(), setMBeanInfo(javax.management.MBeanInfo)

invoke

public Object invoke(String method,
                     Object[] arguments,
                     String[] params)
              throws MBeanException,
                     ReflectionException

Returns the value of the manageable operation as specified by the DynamicMBean interface

Specified by:

invoke in interface DynamicMBean

Throws:

MBeanException

ReflectionException

See Also:

createMBeanOperationInfo()

setAttribute

public void setAttribute(Attribute attribute)
                  throws AttributeNotFoundException,
                         InvalidAttributeValueException,
                         MBeanException,
                         ReflectionException

Sets the value of the manageable attribute, as specified by the DynamicMBean interface.

Specified by:

setAttribute in interface DynamicMBean

Throws:

AttributeNotFoundException

InvalidAttributeValueException

MBeanException

ReflectionException

See Also:

createMBeanAttributeInfo()

setAttributes

public AttributeList setAttributes(AttributeList attributes)

Sets the manageable attributes, as specified by the DynamicMBean interface.

Specified by:

setAttributes in interface DynamicMBean

invoke

protected Object invoke(String name,
                        Class[] params,
                        Object[] args)
                 throws InvalidAttributeValueException,
                        MBeanException,
                        ReflectionException

Deprecated. Replaced by invoke(Object,String,Class[],Object[]).
The resource passed is the resource as set by setResource(java.lang.Object) or - if it is null - 'this' instance.
This method is deprecated because it is not thread safe.

Throws:

InvalidAttributeValueException

MBeanException

ReflectionException

invoke

protected Object invoke(Object resource,
                        String name,
                        Class[] params,
                        Object[] args)
                 throws InvalidAttributeValueException,
                        MBeanException,
                        ReflectionException

Looks up the method to call on given resource and invokes it. The default implementation requires that the methods that implement attribute and operation behavior on the resource object are public, but it is possible to override this behavior, and call also private methods.

Throws:

InvalidAttributeValueException

MBeanException

ReflectionException

See Also:

findMethod(java.lang.Class, java.lang.String, java.lang.Class[]), invokeMethod(java.lang.reflect.Method, java.lang.Object, java.lang.Object[])

findMethod

protected Method findMethod(Class cls,
                            String name,
                            Class[] params)
                     throws NoSuchMethodException

Returns the (public) method with the given name and signature on the given class.
Override to return non-public methods, or to map methods to other classes, or to map methods with different signatures

Throws:

NoSuchMethodException

See Also:

invoke(String, Class[], Object[]), invokeMethod(java.lang.reflect.Method, java.lang.Object, java.lang.Object[])

invokeMethod

protected Object invokeMethod(Method method,
                              Object resource,
                              Object[] args)
                       throws IllegalAccessException,
                              IllegalArgumentException,
                              InvocationTargetException

Invokes the given method on the given resource object with the given arguments.
Override to map methods to other objects, or to map methods with different arguments

Throws:

IllegalAccessException

IllegalArgumentException

InvocationTargetException

See Also:

invoke(String, Class[], Object[]), findMethod(java.lang.Class, java.lang.String, java.lang.Class[])

getResource

protected Object getResource()

Returns the resource object on which invoke attribute's getters, attribute's setters and operation's methods

See Also:

setResource(java.lang.Object)

setResource

public void setResource(Object resource)

Specifies the resource object on which invoke attribute's getters, attribute's setters and operation's methods.

See Also:

getResource()

setMBeanInfo

protected void setMBeanInfo(MBeanInfo info)

Sets the MBeanInfo object cached by this instance.
The given MBeanInfo is not cloned.

See Also:

getMBeanInfo()

createMBeanInfo

protected MBeanInfo createMBeanInfo()

Creates the MBeanInfo for this instance, calling in succession factory methods that the user can override. Information to create MBeanInfo are taken calling the following methods:

• createMBeanAttributeInfo()
• createMBeanConstructorInfo()
• createMBeanOperationInfo()
• createMBeanNotificationInfo()
• getMBeanClassName()
• getMBeanDescription()

createMBeanAttributeInfo

protected MBeanAttributeInfo[] createMBeanAttributeInfo()

To be overridden to return metadata information about manageable attributes.

createMBeanConstructorInfo

protected MBeanConstructorInfo[] createMBeanConstructorInfo()

To be overridden to return metadata information about manageable constructors.

createMBeanOperationInfo

protected MBeanOperationInfo[] createMBeanOperationInfo()

To be overridden to return metadata information about manageable operations.

createMBeanNotificationInfo

protected MBeanNotificationInfo[] createMBeanNotificationInfo()

To be overridden to return metadata information about manageable notifications.

getMBeanClassName

protected String getMBeanClassName()

To be overridden to return metadata information about the class name of this MBean; by default returns this class' name.

getMBeanDescription

protected String getMBeanDescription()

To be overridden to return metadata information about the description of this MBean.