javax.management
类 StandardMBean

java.lang.Object
  javax.management.StandardMBean

所有已实现的接口：

DynamicMBean, MBeanRegistration

直接已知子类：

StandardEmitterMBean

public class StandardMBean
     

      extends 
      Object
     
     

      implements 
      DynamicMBean, 
      MBeanRegistration
     

一个管理接口由 Java 接口上的反射确定的 MBean。

在 Standard MBean 的使用中，此类为“管理接口”这一概念提供了更多灵活性。直接使用 JMX 规范中介绍的 Standard MBean 模式意味着在 MBean 的实现类与其管理接口之间存在着固定的关系（即如果实现类是 Thing，则管理接口必须是 ThingMBean）。此类能够保留指定带有 Java 接口的管理接口这一便捷性，同时无需在实现与接口类之间存在任何命名关系。

通过从 MBean 中生成 DynamicMBean，此类能够选择任何由 MBean 实现的接口作为其管理接口，但前提是它必须遵守 JMX 模式（即由获取方法/设置方法等定义的属性）。

此类还提供了一些钩子，从而能够为由 DynamicMBean 接口返回的 MBeanInfo 提供自定义描述和名称。

通过使用此类，可以使用以下两种常规方法之一创建 MBean，使用任何实现类名 Impl、由任何接口 Intf 定义的管理接口（就当前 Standard MBean 而言）作为参数：

• 使用公共构造方法 StandardMBean（impl、interface）：

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

• 创建 StandardMBean 子类：

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

在任何一种情况下，类 Impl 都必须实现接口 Intf。

当然，基于实现和接口类之间的命名关系的 Standard MBean 仍然可用。

此类也可以用来构造 MXBean。用法与构造 Standard MBean 完全相同，唯一的不同之处在于，上例中的构造方法或 super(...) 调用使用的是 false 参数，而不是 true 参数。

从以下版本开始：

1.5

StandardMBean

public StandardMBean(T implementation,
                     Class<T> mbeanInterface)
              throws NotCompliantMBeanException

使用指定的 mbeanInterface 类从对象 implementation 中生成 DynamicMBean。

类型参数：

T - 允许编译器检查 implementation 是否确实实现了 mbeanInterface 描述的类。编译器只在 mbeanInterface 是 MyMBean.class 之类的类字面值时才能进行检查。

参数：

implementation - 此 MBean 的实现。

mbeanInterface - 由此 MBean 实现导出的管理接口。如果为 null，则此对象将使用标准 JMX 设计模式来确定与指定实现关联的管理接口。

抛出：

IllegalArgumentException - 如果给定的 implementation 为 null

NotCompliantMBeanException - 如果 mbeanInterface 不遵守管理接口的 JMX 设计模式，或者给定的 implementation 没有实现指定的接口。

StandardMBean

protected StandardMBean(Class<?> mbeanInterface)
                 throws NotCompliantMBeanException

使用指定的 mbeanInterface 类从 this 中生成 DynamicMBean。

调用 this（this、mbeanInterface）。此构造方法是为子类保留的。

参数：

mbeanInterface - 由此 MBean 导出的管理接口。

抛出：

NotCompliantMBeanException - 如果 mbeanInterface 不遵从管理接口的 JMX 设计模式，或者 this 没有实现指定的接口。

StandardMBean

public StandardMBean(T implementation,
                     Class<T> mbeanInterface,
                     boolean isMXBean)

使用指定的 mbeanInterface 类从对象 implementation 中生成 DynamicMBean。此构造方法可以用来生成 Standard MBean 或 MXBean。与构造方法 StandardMBean(Object, Class) 不同，它不抛出 NotCompliantMBeanException。

类型参数：

T - 允许编译器查看 implementation 是否确实实现了 mbeanInterface 描述的类。编译器只在 mbeanInterface 是 MyMBean.class 之类的类字面值时才能进行检查。

参数：

implementation - 此 MBean 的实现。

mbeanInterface - 由此 MBean 实现导出的管理接口。如果为 null，则此对象将使用标准 JMX 设计模式来确定与指定实现关联的管理接口。

isMXBean - 如果为 true，则 mbeanInterface 参数表示 MXBean 接口，得到的 MBean 是一个 MXBean。

抛出：

IllegalArgumentException - 如果给定的 implementation 为 null；或者 mbeanInterface 不遵守管理接口的 JMX 设计模式；或者给定的 implementation 没有实现指定的接口。

从以下版本开始：

1.6

StandardMBean

protected StandardMBean(Class<?> mbeanInterface,
                        boolean isMXBean)

使用指定的 mbeanInterface 类从 this 中生成 DynamicMBean。此构造方法可以用来生成 Standard MBean 或 MXBean。与构造方法 StandardMBean(Object, Class) 不同，它不抛出 NotCompliantMBeanException。

调用 this(this, mbeanInterface, isMXBean)。此构造方法是为子类保留的。

参数：

mbeanInterface - 由此 MBean 导出的管理接口。

isMXBean - 如果为 true，则 mbeanInterface 参数表示 MXBean 接口，得到的 MBean 是一个 MXBean。

抛出：

IllegalArgumentException - 如果 mbeanInterface 不遵从管理接口的 JMX 设计模式，或者 this 没有实现指定的接口。

从以下版本开始：

1.6

setImplementation

public void setImplementation(Object implementation)
                       throws NotCompliantMBeanException

替换包装在此对象中的实现对象。

参数：

implementation - 此 Standard MBean（或 MXBean）的新实现。 implementation 对象必须实现构造此 StandardMBean 时提供的 Standard MBean（或 MXBean）接口。

抛出：

IllegalArgumentException - 如果给定的 implementation 为 null

NotCompliantMBeanException - 如果给定的 implementation 没有实现构造时提供的 Standard MBean（或 MXBean）接口。

另请参见：

getImplementation()

getImplementation

public Object getImplementation()

获取此 Standard MBean（或 MXBean）的实现。

返回：

此 Standard MBean（或 MXBean）的实现。

另请参见：

setImplementation(java.lang.Object)

getMBeanInterface

public final Class<?> getMBeanInterface()

获取此 Standard MBean（或 MXBean）的管理接口。

返回：

此 Standard MBean（或 MXBean）的管理接口。

getImplementationClass

public Class<?> getImplementationClass()

获取此 Standard MBean（或 MXBean）的实现类。

返回：

此 Standard MBean（或 MXBean）的实现类。

getAttribute

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

从接口 DynamicMBean 复制的描述

获得 Dynamic MBean 的特定属性的值。

指定者：

接口 DynamicMBean 中的 getAttribute

参数：

attribute - 要检索的属性名

返回：

所检索属性的值。

抛出：

AttributeNotFoundException

MBeanException - 包装由 MBean 的获取方法所抛出的 java.lang.Exception。

ReflectionException - 包装试图调用获取方法时所抛出的 java.lang.Exception。

另请参见：

DynamicMBean.setAttribute(javax.management.Attribute)

setAttribute

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

从接口 DynamicMBean 复制的描述

设置 Dynamic MBean 的特定属性的值。

指定者：

接口 DynamicMBean 中的 setAttribute

参数：

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

抛出：

AttributeNotFoundException

InvalidAttributeValueException

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

ReflectionException - 包装试图调用设置方法时所抛出的 java.lang.Exception。

另请参见：

DynamicMBean.getAttribute(java.lang.String)

getAttributes

public AttributeList getAttributes(String[] attributes)

从接口 DynamicMBean 复制的描述

获得 Dynamic MBean 多个属性的值。

指定者：

接口 DynamicMBean 中的 getAttributes

参数：

attributes - 要检索的属性列表。

返回：

已检索的属性列表。

另请参见：

DynamicMBean.setAttributes(javax.management.AttributeList)

setAttributes

public AttributeList setAttributes(AttributeList attributes)

从接口 DynamicMBean 复制的描述

设置 Dynamic MBean 多个属性的值。

指定者：

接口 DynamicMBean 中的 setAttributes

参数：

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

返回：

已设置的属性的列表，以及它们的新值。

另请参见：

DynamicMBean.getAttributes(java.lang.String[])

invoke

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

从接口 DynamicMBean 复制的描述

允许在 Dynamic MBean 上调用某个操作。

指定者：

接口 DynamicMBean 中的 invoke

参数：

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

params - 一个数组，包含调用该操作时所要设置的参数。

signature - 包含操作签名的数组。加载类对象时，使用的类加载器与加载在其上调用操作的 MBean 所用的类加载器相同。

返回：

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

抛出：

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

ReflectionException - 包装试图调用该方法时所抛出的 java.lang.Exception。

getMBeanInfo

public MBeanInfo getMBeanInfo()

获取此 MBean 的 MBeanInfo。

此方法实现了 DynamicMBean.getMBeanInfo()。

此方法首先调用 getCachedMBeanInfo()，以便检索此 MBean 的缓存 MBeanInfo（如果有）。如果由 getCachedMBeanInfo() 返回的 MBeanInfo 不为 null，则将其返回。
否则，此方法将使用为此 MBean 指定的管理接口构建此 MBean 的默认 MBeanInfo。

在构建 MBeanInfo 时，此方法将调用一些自定义钩子，这些钩子使子类能够提供其自定义描述、参数名称等。
最后，它将调用 cacheMBeanInfo()，以便缓存新的 MBeanInfo。

指定者：

接口 DynamicMBean 中的 getMBeanInfo

返回：

如果不为 null，则返回缓存的该 MBean 的 MBeanInfo，如果没有缓存它，则返回新构建的 MBeanInfo。

getClassName

protected String getClassName(MBeanInfo info)

自定义钩子：获取将在由此 MBean 返回的 MBeanInfo 中使用的 className。
子类可以重定义此方法来提供其自定义类名称。默认实现返回 info.getClassName()。

参数：

info - 通过反射派生的默认 MBeanInfo。

返回：

新 MBeanInfo 的类名称。

getDescription

protected String getDescription(MBeanInfo info)

自定义钩子：获取将在由此 MBean 返回的 MBeanInfo 中使用的描述。
子类可以重定义此方法来提供其自定义 MBean 描述。默认实现返回 info.getDescription()。

参数：

info - 通过反射派生的默认 MBeanInfo。

返回：

对新 MBeanInfo 的描述。

getDescription

protected String getDescription(MBeanFeatureInfo info)

自定义钩子：获取将在由此 MBean 返回的 MBeanFeatureInfo 中使用的描述。

子类可以重定义此方法来提供其自定义描述。默认实现返回 info.getDescription()。

此方法将由 getDescription(MBeanAttributeInfo)、getDescription(MBeanOperationInfo)、getDescription(MBeanConstructorInfo) 调用。

参数：

info - 通过反射派生的默认 MBeanFeatureInfo。

返回：

对给定 MBeanFeatureInfo 的描述。

getDescription

protected String getDescription(MBeanAttributeInfo info)

自定义钩子：获取将在由此 MBean 返回的 MBeanAttributeInfo 中使用的描述。

子类可以重定义此方法来提供其自定义描述。默认实现返回 getDescription((MBeanFeatureInfo) info)。

参数：

info - 通过反射派生的默认 MBeanAttributeInfo。

返回：

对给定 MBeanAttributeInfo 的描述。

getDescription

protected String getDescription(MBeanConstructorInfo info)

自定义钩子：获取将在由此 MBean 返回的 MBeanConstructorInfo 中使用的描述。
子类可以重定义此方法来提供其自定义描述。默认实现返回 getDescription((MBeanFeatureInfo) info)。

参数：

info - 通过反射派生的默认 MBeanConstructorInfo。

返回：

对给定 MBeanConstructorInfo 的描述。

getDescription

protected String getDescription(MBeanConstructorInfo ctor,
                                MBeanParameterInfo param,
                                int sequence)

自定义钩子：获取将用于由此 MBean 返回的 MBeanConstructorInfo 的第 sequence 个 BeanParameterInfo 的描述。
子类可以重定义此方法来提供其自定义描述。默认实现返回 param.getDescription()。

参数：

ctor - 通过反射派生的默认 MBeanConstructorInfo。

param - 通过反射派生的默认 MBeanParameterInfo。

sequence - 要考虑的参数序列号（"0" 是第一个参数，"1" 是第二个参数，依此类推）。

返回：

对给定 MBeanParameterInfo 的描述。

getParameterName

protected String getParameterName(MBeanConstructorInfo ctor,
                                  MBeanParameterInfo param,
                                  int sequence)

自定义钩子：获取将用于由此 MBean 返回的 MBeanConstructorInfo 的第 sequence 个 BeanParameterInfo 的名称。
子类可以重定义此方法来提供其自定义参数名称。默认实现返回 param.getName()。

参数：

ctor - 通过反射派生的默认 MBeanConstructorInfo。

param - 通过反射派生的默认 MBeanParameterInfo。

sequence - 要考虑的参数序列号（"0" 是第一个参数，"1" 是第二个参数，依此类推）。

返回：

给定 MBeanParameterInfo 的名称。

getDescription

protected String getDescription(MBeanOperationInfo info)

自定义钩子：获取将在由此 MBean 返回的 MBeanOperationInfo 中使用的描述。
子类可以重定义此方法来提供其自定义描述。默认实现返回 getDescription((MBeanFeatureInfo) info)。

参数：

info - 通过反射派生的默认 MBeanOperationInfo。

返回：

对给定 MBeanOperationInfo 的描述。

getImpact

protected int getImpact(MBeanOperationInfo info)

自定义钩子：获取将在由此 MBean 返回的 MBeanOperationInfo 中使用的操作的 impact 标志。
子类可重定义此方法来提供其自定义 impact 标志。默认实现返回 info.getImpact()。

参数：

info - 通过反射派生的默认 MBeanOperationInfo。

返回：

给定 MBeanOperationInfo 的 impact 标志。

getParameterName

protected String getParameterName(MBeanOperationInfo op,
                                  MBeanParameterInfo param,
                                  int sequence)

自定义钩子：获取将用于由此 MBean 返回的 MBeanOperationInfo 的第 sequence 个 MBeanParameterInfo 的名称。
子类可以重定义此方法来提供其自定义参数名称。默认实现返回 param.getName()。

参数：

op - 通过反射派生的默认 MBeanOperationInfo。

param - 通过反射派生的默认 MBeanParameterInfo。

sequence - 要考虑的参数序列号（"0" 是第一个参数，"1" 是第二个参数，依此类推）。

返回：

将用于给定 MBeanParameterInfo 的名称。

getDescription

protected String getDescription(MBeanOperationInfo op,
                                MBeanParameterInfo param,
                                int sequence)

自定义钩子：获取将用于由此 MBean 返回的 MBeanOperationInfo 的第 sequence 个 MBeanParameterInfo 的描述。
子类可以重定义此方法来提供其自定义描述。默认实现返回 param.getDescription()。

参数：

op - 通过反射派生的默认 MBeanOperationInfo。

param - 通过反射派生的默认 MBeanParameterInfo。

sequence - 要考虑的参数序列号（"0" 是第一个参数，"1" 是第二个参数，依此类推）。

返回：

对给定 MBeanParameterInfo 的描述。

getConstructors

protected