JavaTM Platform
Standard Ed. 6

javax.management
接口 DynamicMBean

所有已知子接口:
ModelMBean
所有已知实现类:
RequiredModelMBean, StandardEmitterMBean, StandardMBean

public interface DynamicMBean

定义了 Dynamic MBean(公开了动态管理接口的 MBean)应该实现的各个方法。

从以下版本开始:
1.5

方法摘要
 Object getAttribute(String attribute)
          获得 Dynamic MBean 的特定属性的值。
 AttributeList getAttributes(String[] attributes)
          获得 Dynamic MBean 多个属性的值。
 MBeanInfo getMBeanInfo()
          使用 MBeanInfo 对象提供该 Dynamic MBean 已公开的属性和操作。
 Object invoke(String actionName, Object[] params, String[] signature)
          允许在 Dynamic MBean 上调用某个操作。
 void setAttribute(Attribute attribute)
          设置 Dynamic MBean 的特定属性的值。
 AttributeList setAttributes(AttributeList attributes)
          设置 Dynamic MBean 多个属性的值。
 

方法详细信息

getAttribute

Object getAttribute(String attribute)
                    throws AttributeNotFoundException,
                           MBeanException,
                           ReflectionException
获得 Dynamic MBean 的特定属性的值。

参数:
attribute - 要检索的属性名
返回:
所检索属性的值。
抛出:
AttributeNotFoundException
MBeanException - 包装由 MBean 的获取方法所抛出的 java.lang.Exception
ReflectionException - 包装试图调用获取方法时所抛出的 java.lang.Exception
另请参见:
setAttribute(javax.management.Attribute)

setAttribute

void setAttribute(Attribute attribute)
                  throws AttributeNotFoundException,
                         InvalidAttributeValueException,
                         MBeanException,
                         ReflectionException
设置 Dynamic MBean 的特定属性的值。

参数:
attribute - 要设置的属性的标识及其要设置成的值。
抛出:
AttributeNotFoundException
InvalidAttributeValueException
MBeanException - 包装由 MBean 的设置方法所抛出的 java.lang.Exception
ReflectionException - 包装试图调用设置方法时所抛出的 java.lang.Exception
另请参见:
getAttribute(java.lang.String)

getAttributes

AttributeList getAttributes(String[] attributes)
获得 Dynamic MBean 多个属性的值。

参数:
attributes - 要检索的属性列表。
返回:
已检索的属性列表。
另请参见:
setAttributes(javax.management.AttributeList)

setAttributes

AttributeList setAttributes(AttributeList attributes)
设置 Dynamic MBean 多个属性的值。

参数:
attributes - 属性列表:要设置的属性的标识及其要设置成的值。
返回:
已设置的属性的列表,以及它们的新值。
另请参见:
getAttributes(java.lang.String[])

invoke

Object invoke(String actionName,
              Object[] params,
              String[] signature)
              throws MBeanException,
                     ReflectionException
允许在 Dynamic MBean 上调用某个操作。

参数:
actionName - 要调用的操作的名称。
params - 一个数组,包含调用该操作时所要设置的参数。
signature - 包含操作签名的数组。加载类对象时,使用的类加载器与加载在其上调用操作的 MBean 所用的类加载器相同。
返回:
该操作返回的对象,表示在指定 MBean 上调用该操作的结果。
抛出:
MBeanException - 包装由 MBean 上所调用的方法抛出的 java.lang.Exception
ReflectionException - 包装试图调用该方法时所抛出的 java.lang.Exception

getMBeanInfo

MBeanInfo getMBeanInfo()
使用 MBeanInfo 对象提供该 Dynamic MBean 已公开的属性和操作。

返回:
一个 MBeanInfo 实例,允许检索此 Dynamic MBean 已公开的所有属性和操作。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策