Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

javax.management
Interface DynamicMBean  view DynamicMBean download DynamicMBean.java


public interface DynamicMBean

The DynamicMBean interface is implemented by resources that expose their definition at runtime. The implementation exposes its attributes, methods and notifications through the getMBeanInfo 55 method.

From a management point of view, the DynamicMBean behaves like any other MBean.

It is the responsibility of the implementation to ensure the MBean works as self-described. The MBeanServer makes no attempt to validate it.

Although the self-description is retrieved at runtime and is therefore dynamic, the implementation must not change it once it has been retrieved. A manager can expect the attributes, methods and notifications to remain constant. It is the implementation's responsibility to conform to this behaviour.

Version:
$Revision: 1.2 $

Method Summary
 java.lang.Object getAttribute(java.lang.String attribute)
          Returns the value of the attribute with the name matching the passed string.
 AttributeList getAttributes(java.lang.String[] attributes)
          Returns the values of the attributes with names matching the passed string array.
 MBeanInfo getMBeanInfo()
          Returns the management interface that describes this dynamic resource.
 java.lang.Object invoke(java.lang.String actionName, java.lang.Object[] params, java.lang.String[] signature)
          Invokes a resource operation.
 void setAttribute(Attribute attribute)
          Sets the value of an attribute.
 AttributeList setAttributes(AttributeList attributes)
          Sets the values of the attributes passed as an AttributeList of name and new value pairs.
 

Method Detail

getAttribute

public java.lang.Object getAttribute(java.lang.String attribute)
                              throws AttributeNotFoundException,
                                     MBeanException,
                                     ReflectionException
Returns the value of the attribute with the name matching the passed string.


setAttribute

public void setAttribute(Attribute attribute)
                  throws AttributeNotFoundException,
                         InvalidAttributeValueException,
                         MBeanException,
                         ReflectionException
Sets the value of an attribute. The attribute and new value are passed in the name value pair Attribute.


getAttributes

public AttributeList getAttributes(java.lang.String[] attributes)
Returns the values of the attributes with names matching the passed string array.


setAttributes

public AttributeList setAttributes(AttributeList attributes)
Sets the values of the attributes passed as an AttributeList of name and new value pairs.


invoke

public java.lang.Object invoke(java.lang.String actionName,
                               java.lang.Object[] params,
                               java.lang.String[] signature)
                        throws MBeanException,
                               ReflectionException
Invokes a resource operation.


getMBeanInfo

public MBeanInfo getMBeanInfo()
Returns the management interface that describes this dynamic resource. It is the responsibility of the implementation to make sure the description is accurate.