javax.management
Class StandardMBean

java.lang.Object   
  javax.management.StandardMBean

All Implemented Interfaces:

DynamicMBean

public class StandardMBean
extends Object   
implements DynamicMBean   

An MBean whose management interface is determined by reflection on a Java interface.

This class brings more flexibility to the notion of Management Interface in the use of Standard MBeans. Straightforward use of the patterns for Standard MBeans described in the JMX Specification means that there is a fixed relationship between the implementation class of an MBean and its management interface (i.e., if the implementation class is Thing, the management interface must be ThingMBean). This class makes it possible to keep the convenience of specifying the management interface with a Java interface, without requiring that there be any naming relationship between the implementation and interface classes.

By making a DynamicMBean out of an MBean, this class makes it possible to select any interface implemented by the MBean as its management interface, provided that it complies with JMX patterns (i.e., attributes defined by getter/setter etc...).

This class also provides hooks that make it possible to supply custom descriptions and names for the MBeanInfo returned by the DynamicMBean interface.

Using this class, an MBean can be created with any implementation class name Impl and with a management interface defined (as for current Standard MBeans) by any interface Intf, in one of two general ways:

• Using the public constructor StandardMBean(impl,interface) :

       MBeanServer mbs;
       ...
       Impl impl = new Impl(...);
       StandardMBean mbean = new StandardMBean(impl, Intf.class);
       mbs.registerMBean(mbean, objectName);
       

• Subclassing StandardMBean:

       public class Impl extends StandardMBean implements Intf {
          public Impl() {
            super(Intf.class);
         }
         // implement methods of Intf
       }
  
       [...]
  
       MBeanServer mbs;
       ....
       Impl impl = new Impl();
       mbs.registerMBean(impl, objectName);
       

In either case, the class Impl must implement the interface Intf.

Standard MBeans based on the naming relationship between implementation and interface classes are of course still available.

Since:

1.5

Constructor Summary

protected	StandardMBean (Class mbeanInterface) Make a DynamicMBean out of this, using the specified mbeanInterface class.
	StandardMBean (Object implementation, Class mbeanInterface) Make a DynamicMBean out of the object implementation, using the specified mbeanInterface class.

Method Summary

protected void	cacheMBeanInfo (MBeanInfo info) Customization hook: cache the MBeanInfo built for this object.
Object	getAttribute (String attribute) Obtain the value of a specific attribute of the Dynamic MBean.
AttributeList	getAttributes (String [] attributes) Get the values of several attributes of the Dynamic MBean.
protected MBeanInfo	getCachedMBeanInfo () Customization hook: Return the MBeanInfo cached for this object.
protected String	getClassName (MBeanInfo info) Customization hook: Get the className that will be used in the MBeanInfo returned by this MBean.
protected MBeanConstructorInfo []	getConstructors (MBeanConstructorInfo [] ctors, Object impl) Customization hook: Get the MBeanConstructorInfo[] that will be used in the MBeanInfo returned by this MBean.
protected String	getDescription (MBeanAttributeInfo info) Customization hook: Get the description that will be used in the MBeanAttributeInfo returned by this MBean.
protected String	getDescription (MBeanConstructorInfo info) Customization hook: Get the description that will be used in the MBeanConstructorInfo returned by this MBean.
protected String	getDescription (MBeanConstructorInfo ctor, MBeanParameterInfo param, int sequence) Customization hook: Get the description that will be used for the sequence MBeanParameterInfo of the MBeanConstructorInfo returned by this MBean.
protected String	getDescription (MBeanFeatureInfo info) Customization hook: Get the description that will be used in the MBeanFeatureInfo returned by this MBean.
protected String	getDescription (MBeanInfo info) Customization hook: Get the description that will be used in the MBeanInfo returned by this MBean.
protected String	getDescription (MBeanOperationInfo info) Customization hook: Get the description that will be used in the MBeanOperationInfo returned by this MBean.
protected String	getDescription (MBeanOperationInfo op, MBeanParameterInfo param, int sequence) Customization hook: Get the description that will be used for the sequence MBeanParameterInfo of the MBeanOperationInfo returned by this MBean.
protected int	getImpact (MBeanOperationInfo info) Customization hook: Get the impact flag of the operation that will be used in the MBeanOperationInfo returned by this MBean.
Object	getImplementation () Get the implementation of this MBean.
Class	getImplementationClass () Get the class of the implementation of this MBean.
MBeanInfo	getMBeanInfo () Get the MBeanInfo for this MBean.
Class	getMBeanInterface () Get the Management Interface of this MBean.
protected String	getParameterName (MBeanConstructorInfo ctor, MBeanParameterInfo param, int sequence) Customization hook: Get the name that will be used for the sequence MBeanParameterInfo of the MBeanConstructorInfo returned by this MBean.
protected String	getParameterName (MBeanOperationInfo op, MBeanParameterInfo param, int sequence) Customization hook: Get the name that will be used for the sequence MBeanParameterInfo of the MBeanOperationInfo returned by this MBean.
Object	invoke (String actionName, Object [] params, String [] signature) Allows an action to be invoked on the Dynamic MBean.
void	setAttribute (Attribute attribute) Set the value of a specific attribute of the Dynamic MBean.
AttributeList	setAttributes (AttributeList attributes) Sets the values of several attributes of the Dynamic MBean.
void	setImplementation (Object implementation) Replace the implementation object wrapped in this object.

Methods inherited from class java.lang.Object

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

Constructor Detail

StandardMBean

public StandardMBean(Object    implementation,
                     Class    mbeanInterface)
              throws NotCompliantMBeanException   

Make a DynamicMBean out of the object implementation, using the specified mbeanInterface class.

Parameters:

implementation - The implementation of this MBean.

mbeanInterface - The Management Interface exported by this MBean's implementation. If null, then this object will use standard JMX design pattern to determine the management interface associated with the given implementation.

Throws:

IllegalArgumentException - if the given implementation is null.

NotCompliantMBeanException - if the mbeanInterface does not follow JMX design patterns for Management Interfaces, or if the given implementation does not implement the specified interface.

StandardMBean

protected StandardMBean(Class    mbeanInterface)
                 throws NotCompliantMBeanException   

Make a DynamicMBean out of this, using the specified mbeanInterface class.

Call this(this,mbeanInterface) . This constructor is reserved to subclasses.

Parameters:

mbeanInterface - The Management Interface exported by this MBean.

Throws:

NotCompliantMBeanException - if the mbeanInterface does not follow JMX design patterns for Management Interfaces, or if this does not implement the specified interface.

Method Detail

setImplementation

public void setImplementation(Object    implementation)
                       throws NotCompliantMBeanException   

Replace the implementation object wrapped in this object.

Parameters:

implementation - The new implementation of this MBean. The implementation object must implement the MBean interface that was supplied when this StandardMBean was constructed.

Throws:

IllegalArgumentException - if the given implementation is null.

NotCompliantMBeanException - if the given implementation does not implement the MBean interface that was supplied at construction.

See Also:

getImplementation()

getImplementation

public Object    getImplementation()

Get the implementation of this MBean.

Returns:

The implementation of this MBean.

See Also:

setImplementation(java.lang.Object)

getMBeanInterface

public final Class    getMBeanInterface()

Get the Management Interface of this MBean.

Returns:

The management interface of this MBean.

getImplementationClass

public Class    getImplementationClass()

Get the class of the implementation of this MBean.

Returns:

The class of the implementation of this MBean.

getAttribute

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

Description copied from interface: DynamicMBean

Obtain the value of a specific attribute of the Dynamic MBean.

Specified by:

getAttribute in interface DynamicMBean

Parameters:

attribute - The name of the attribute to be retrieved

Returns:

The value of the attribute retrieved.

Throws:

AttributeNotFoundException

MBeanException - Wraps a java.lang.Exception thrown by the MBean's getter.

ReflectionException - Wraps a java.lang.Exception thrown while trying to invoke the getter.

See Also:

DynamicMBean.setAttribute(javax.management.Attribute)

setAttribute

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

Description copied from interface: DynamicMBean

Set the value of a specific attribute of the Dynamic MBean.

Specified by:

setAttribute in interface DynamicMBean

Parameters:

attribute - The identification of the attribute to be set and the value it is to be set to.

Throws:

AttributeNotFoundException

InvalidAttributeValueException

MBeanException - Wraps a java.lang.Exception thrown by the MBean's setter.

ReflectionException - Wraps a java.lang.Exception thrown while trying to invoke the MBean's setter.

See Also:

DynamicMBean.getAttribute(java.lang.String)

getAttributes

public AttributeList    getAttributes(String   [] attributes)

Description copied from interface: DynamicMBean

Get the values of several attributes of the Dynamic MBean.

Specified by:

getAttributes in interface DynamicMBean

Parameters:

attributes - A list of the attributes to be retrieved.

Returns:

The list of attributes retrieved.

See Also:

DynamicMBean.setAttributes(javax.management.AttributeList)

setAttributes

public AttributeList