Module java.management

软件包 javax.management

Interface DynamicMBean

All Known Subinterfaces:

DiagnosticCommandMBean ， ModelMBean

所有已知实现类：

RequiredModelMBean ， StandardEmitterMBean ， StandardMBean

public interface DynamicMBean

定义应该由动态MBean（显示动态管理界面的MBean）实现的方法。

从以下版本开始：

1.5

方法摘要

Modifier and Type	方法	描述
Object	getAttribute(String attribute)	获取动态MBean的特定属性的值。
AttributeList	getAttributes(String[] attributes)	获取动态MBean的几个属性的值。
MBeanInfo	getMBeanInfo()	使用MBeanInfo对象提供动态MBean的公开属性和动作。
Object	invoke(String actionName, Object[] params, String[] signature)	允许在动态MBean上调用操作。
void	setAttribute(Attribute attribute)	设置动态MBean的特定属性的值。
AttributeList	setAttributes(AttributeList attributes)	设置动态MBean的几个属性的值。

方法详细信息

getAttribute

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

获取动态MBean的特定属性的值。

参数

attribute - 要检索的属性的名称

结果

检索的属性的值。

异常

AttributeNotFoundException - 如果指定的属性不存在或无法检索

MBeanException - 包裹了MBean的吸气 java.lang.Exception抛出的 java.lang.Exception 。

ReflectionException - 包裹一个 java.lang.Exception在尝试调用吸气剂时抛出。

另请参见：

setAttribute(javax.management.Attribute)

setAttribute

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

设置动态MBean的特定属性的值。

参数

attribute - 要设置的属性的标识以及要设置的值。

异常

AttributeNotFoundException - 如果指定的属性不存在或无法检索

InvalidAttributeValueException - 如果指定的值对该属性无效

MBeanException - 包装由MBean的设置者抛出的 java.lang.Exception 。

ReflectionException - 在尝试调用MBean的设置器时抛出一个 java.lang.Exception 。

另请参见：

getAttribute(java.lang.String)

getAttributes

AttributeList getAttributes(String[] attributes)

获取动态MBean的几个属性的值。

参数

attributes - 要检索的属性的列表。

结果

检索的属性列表。

另请参见：

setAttributes(javax.management.AttributeList)

setAttributes

AttributeList setAttributes(AttributeList attributes)

设置动态MBean的几个属性的值。

参数

attributes - 属性列表：要设置的属性的标识以及要设置的属性值。

结果

已设置的属性列表及其新值。

另请参见：

getAttributes(java.lang.String[])

invoke

Object invoke(String actionName,
              Object[] params,
              String[] signature)
       throws MBeanException,
              ReflectionException

允许在动态MBean上调用操作。

参数

actionName - 要调用的操作的名称。

params - 包含调用操作时要设置的参数的数组。

signature - 包含动作签名的数组。 类对象将通过与用于加载调用操作的MBean相同的类加载器来加载。

结果

该操作返回的对象，表示在指定的MBean上调用操作的结果。

异常

MBeanException - 包装一个由MBean调用的方法抛出的 java.lang.Exception 。

ReflectionException - 在尝试调用该方法时抛出一个 java.lang.Exception

getMBeanInfo

MBeanInfo getMBeanInfo()

使用MBeanInfo对象提供动态MBean的公开属性和动作。

结果

MBeanInfo的实例允许检索此动态MBean公开的所有属性和操作。