Java javax.management.modelmbean 类 ModelMBeanInfoSupport（JDK5）

所有类

javax.management.modelmbean
类 ModelMBeanInfoSupport

java.lang.Object
  javax.management.MBeanInfo
      javax.management.modelmbean.ModelMBeanInfoSupport

所有已实现的接口：

Serializable, Cloneable, ModelMBeanInfo

public class ModelMBeanInfoSupport
   
   
   
   
   
extends MBeanInfo
   
   
   
   
   
   
   
   
   
   
implements ModelMBeanInfo, Serializable
   
   
   
   
   

此类表示 ModelMBean 的元数据。描述符已被添加到元数据对象上。

Java 资源使用 MBeanServer 的 createMBean 方法来实例化 ModelMBean，以便具有可管理性。然后该资源设置 ModelMBean 实例的 ModelMBeanInfo 和 Descriptor。通过 ModelMBean 的 ModelMBeanInfo 公开的属性和操作像其他 MBean 一样可以从 MBean、连接器/适配器进行访问。通过 Descriptor，可以定义托管应用程序中的值和方法，并可以将它们映射到 ModelMBean 的属性和操作。此映射可以在文件的开发过程中定义，也可以以编程方式在运行时动态定义。

MBeanServer 中实例化的每个 ModelMBean 都是可管理的：通过连接到该 MBeanServer 的连接器/适配器可以远程访问其属性和操作。如果 Java 对象不是 JMX 兼容的 MBean，则它不能在 MBeanServer 中进行注册。通过实例化 ModelMBean，资源可保证 MBean 是有效的。 每个公共方法必须抛出 MBeanException 和 RuntimeOperationsException。这允许包装来自分布式通信（RMI、EJB 等）的异常。

从以下版本开始：

1.5

另请参见：

序列化表格

ModelMBeanInfoSupport

public ModelMBeanInfoSupport(ModelMBeanInfo mbi)

构造作为某个传入 ModelMBeanInfoSupport 副本的 ModelMBeanInfoSupport。

参数：

mbi - 正在创建的 ModelMBeanInfo 从其进行实例化的 ModelMBeanInfo 实例。

ModelMBeanInfoSupport

public ModelMBeanInfoSupport(String className,
                             String description,
                             ModelMBeanAttributeInfo[] attributes,
                             ModelMBeanConstructorInfo[] constructors,
                             ModelMBeanOperationInfo[] operations,
                             ModelMBeanNotificationInfo[] notifications)

创建带有所提供的信息、但描述符为默认描述符的 ModelMBeanInfoSupport。默认描述符为：name=mbeanName、descriptorType=mbean、displayName=ClassName、persistPolicy=never、log=F、visibility=1

参数：

className - MBean 的类名称

description - ModelMBean 的可读描述

attributes - 带有描述符的 ModelMBeanAttributeInfo 对象数组

constructors - 带有描述符的 ModelMBeanConstructorInfo 对象数组

operations - 带有描述符的 ModelMBeanOperationInfo 对象数组

notifications - 带有描述符的 ModelMBeanNotificationInfo 对象数组

ModelMBeanInfoSupport

public ModelMBeanInfoSupport(String className,
                             String description,
                             ModelMBeanAttributeInfo[] attributes,
                             ModelMBeanConstructorInfo[] constructors,
                             ModelMBeanOperationInfo[] operations,
                             ModelMBeanNotificationInfo[] notifications,
                             Descriptor mbeandescriptor)

创建带有所提供的信息和参数中所给定的描述符的 ModelMBeanInfoSupport。

参数：

className - MBean 的类名称

description - ModelMBean 的可读描述

attributes - 带有描述符的 ModelMBeanAttributeInfo 对象数组

constructors - 带有描述符的 ModelMBeanConstructorInfo 对象数组

operations - 带有描述符的 ModelMBeanOperationInfo 对象数组

notifications - 带有描述符的 ModelMBeanNotificationInfo 对象数组如果描述符为 null，则将构造默认描述符。默认描述符为：name=className、descriptorType=mbean、displayName=className、persistPolicy=never、log=F、visibility=1。如果描述符不包含所有这些字段，则将以默认值添加它们。

抛出：

RuntimeOperationsException - 包装了传入参数中的无效描述符的 IllegalArgumentException。（有关有效 MBean 描述符的定义，请参见 getMBeanDescriptor）。

clone

public Object clone()

从类 MBeanInfo 复制的描述

返回此实例的浅表副本。通过简单地调用 super.clone() 可获得该副本，因此调用 Object.clone() 所实现的默认本机浅表复制机制。不进行任何内部字段的更深层复制。

因为此类是不可变的，所以主要针对子类使用该 clone 方法。

指定者：

接口 ModelMBeanInfo 中的 clone

覆盖：

类 MBeanInfo 中的 clone

返回：

此实例的一个克隆。

另请参见：

Cloneable

getDescriptors

public Descriptor[] getDescriptors(String inDescriptorType)
                            throws MBeanException,
                                   RuntimeOperationsException

从接口 ModelMBeanInfo 复制的描述

返回由 inDescriptorType 类型的 ModelMBeanInfo 的所有 Descriptor 组成的 Descriptor 数组。

指定者：

接口 ModelMBeanInfo 中的 getDescriptors

参数：

inDescriptorType - 必须为要返回的描述符设置的 descriptorType 字段值。必须为 "mbean"、"attribute"、"operation"、"constructor" 或 "notification"。如果它为 null 或空，则将返回所有类型。

返回：

包含 inDescriptorType 类型的 ModelMBean 的所有描述符的 Descriptor 数组。

抛出：

MBeanException - 包装一个分布式通信异常。

RuntimeOperationsException - 当参数中的 descriptorType 不是以下值之一时，包装一个 IllegalArgumentException："mbean"、"attribute"、"operation"、"constructor"、"notification"、空、 null。

另请参见：

ModelMBeanInfo.setDescriptors(javax.management.Descriptor[])

setDescriptors

public void setDescriptors(Descriptor[] inDescriptors)
                    throws MBeanException,
                           RuntimeOperationsException

从接口 ModelMBeanInfo 复制的描述

添加或替换 ModelMBeanInfo 中的描述符。

指定者：

接口 ModelMBeanInfo 中的 setDescriptors

参数：

inDescriptors - ModelMBeanInfo 中要设置的描述符。忽略列表中的 null 元素。所有描述符必须具有 name 和 descriptorType 字段。

抛出：

MBeanException - 包装一个分布式通信异常。

RuntimeOperationsException - 包装 null 或无效描述符的 IllegalArgumentException。

另请参见：

ModelMBeanInfo.getDescriptors(java.lang.String)

getDescriptor

public Descriptor getDescriptor(String inDescriptorName)
                         throws MBeanException,
                                RuntimeOperationsException

返回通过名称请求的 Descriptor。

参数：

inDescriptorName - 描述符名称。

返回：

包含具有相同名称的 ModelMBean 描述符的 Descriptor。如果未找到描述符，则返回 null。

抛出：

MBeanException - 包装了一个分布式通信异常。

RuntimeOperationsException - 包装了一个 null 名称的 IllegalArgumentException。

另请参见：

setDescriptor(javax.management.Descriptor, java.lang.String)

getDescriptor

public Descriptor getDescriptor(String inDescriptorName,
                                String inDescriptorType)
                         throws MBeanException,
                                RuntimeOperationsException

从接口 ModelMBeanInfo 复制的描述

返回通过 name 和 descriptorType 请求的 Descriptor。

指定者：

接口 ModelMBeanInfo 中的 getDescriptor

参数：

inDescriptorName - 描述符的名称。

inDescriptorType - 要请求的描述符的类型。如果它为 null 或空，就搜索所有类型。有效的类型有 'mbean'、'attribute'、'constructor'、'operation'、'notification'。此值将等于所返回的描述符中的 'descriptorType' 字段。

返回：

包含具有相同 name 和 descriptorType 的 ModelMBean 描述符的 Descriptor。如果未找到描述符，则返回 null。

抛出：

MBeanException - 包装一个分布式通信异常。

RuntimeOperationsException - 包装描述符的名称为 null 的 IllegalArgumentException，或者 null 或无效类型的 IllegalArgumentException。类型必须为 "mbean"、"attribute"、"constructor"、"operation" 或 "notification"。

另请参见：

ModelMBeanInfo.setDescriptor(javax.management.Descriptor, java.lang.String)