Module java.management

Package javax.management.openmbean

提供打开的数据类型和Open MBean描述符类。 一个开放的MBean是一个MBean，其中使用一小组预定义Java类构建了属性类型和操作参数和返回值。 开放的MBeans可以帮助远程管理程序进行操作，这些程序不一定能够访问特定于应用程序的类型，包括非Java程序。

每个MBean都有一个MBeanInfo，其中包含有关MBean本身及其属性，操作，构造函数和通知的信息。 在一个开放的MBean中，这个MBeanInfo实现了OpenMBeanInfo接口，通常是OpenMBeanInfoSupport的一个实例。

270474331011369为Open MBean返回的属性信息是实现OpenMBeanAttributeInfo的对象数组，通常是OpenMBeanAttributeInfoSupport的实例。 除了关于属性的通常信息之外， OpenMBeanAttributeInfo规定了属性的OpenType 。 可能的OpenType值是预定义的，这是确保远程管理员了解它们的。

类似的说明适用于操作和构造函数的参数类型以及操作的返回类型。

有一个属性的Java语言类型之间的区别，通过返回的getType() ，其OpenType ，通过返回的getOpenType() 。 例如，如果Java语言类型为java.lang.String ，则OpenType将为SimpleType.String 。 如果Java语言类型为CompositeData ，则OpenType将是一个CompositeType ，描述了该属性的CompositeData实例中的项目。

Default values and constraints

在打开的MBean中，属性和参数可以具有与它们相关联的默认值和/或约束，如OpenMBeanAttributeInfo或OpenMBeanParameterInfo 。 有两种方法来指定这些约束。 这些值直接指定为OpenMBeanAttributeInfoSupport或OpenMBeanParameterInfoSupport之一的构造函数的参数，例如OpenMBeanParameterInfoSupport( String, String, OpenType, Object, Object[]) ; 或者在给出的值中指定一个Descriptor作为其中一个构造函数的参数。

当使用Descriptor ，感兴趣的领域是：

• defaultValue定义getDefaultValue()返回的值;
• minValue定义getMinValue()返回的值;
• maxValue定义getMaxValue()返回的值;
• legalValues定义了由getLegalValues()返回的值。

为defaultValue ， minValue ，和maxValue ，相关联的值必须是对应于该Java类型的openType ，或者是能够被转换成类型的字符串。 转换使用静态方法valueOf(String)如果找到一个; 否则，如果一个构造函数有一个String参数，如果它找到一个; 否则失败。

对于legalValues ，关联值必须是数组或Set ，并且阵列或集合的元素必须按defaultValue等所述进行defaultValue 。

以下条件必须符合以下条件：

• 值必须是适当的类型，或者是可以转换为适当类型的字符串，如上所述;
• 如果存在legalValues ，则不得存在minValue或maxValue ;
• 如果defaultValue存在，则它必须满足定义的约束legalValues ， minValue ，或maxValue当任何这些也存在;
• 如果minValue和maxValue都存在，则minValue不能大于maxValue 。

从以下版本开始：

1.5

另请参见：

Java Platform documentation on JMX technology, in particular the JMX Specification, version 1.4

接口摘要

接口	描述
CompositeData	CompositeData接口指定了表示 复合数据结构的特定类型的复杂 开放数据对象的行为。
CompositeDataView	一个Java类可以实现这个接口来指示它是如何被MXBean框架转换成 CompositeData的。
OpenMBeanAttributeInfo	描述一个打开的MBean的属性。
OpenMBeanConstructorInfo	描述一个开放MBean的构造函数。
OpenMBeanInfo	描述一个开放的MBean：如果一个开放的MBean的getMBeanInfo()方法返回一个实现OpenMBeanInfo接口的类的实例，通常是OpenMBeanInfoSupport ，那么它就被识别 。
OpenMBeanOperationInfo	描述一个Open MBean的操作。
OpenMBeanParameterInfo	描述在开放MBean的一个或多个操作或构造函数中使用的参数。
TabularData	TabularData接口指定了表示 表格数据结构的特定类型的复杂 开放数据对象的行为。

类摘要

Class	描述
ArrayType<T>	所述 ArrayType类是 开放类型类，其实例描述了作为 开放数据值的n维阵列所有 打开的 数据值。
CompositeDataInvocationHandler	一个InvocationHandler ，将getter方法转发到一个CompositeData 。
CompositeDataSupport	CompositeDataSupport类是实现 CompositeData接口的 开放数据类。
CompositeType	CompositeType类是开放类，其实例描述了CompositeData值的类型。
OpenMBeanAttributeInfoSupport	描述一个打开的MBean的属性。
OpenMBeanConstructorInfoSupport	描述一个开放MBean的构造函数。
OpenMBeanInfoSupport	OpenMBeanInfoSupport类描述了一个开放的MBean的管理信息：它是一个MBeanInfo的子类，它实现了OpenMBeanInfo接口。
OpenMBeanOperationInfoSupport	描述一个Open MBean的操作。
OpenMBeanParameterInfoSupport	描述在开放MBean的一个或多个操作或构造函数中使用的参数。
OpenType<T>	OpenType类是描述开放数据值的实际 开放类型的所有类的父抽象类。
SimpleType<T>	SimpleType类是开放类，它的实例描述了不是数组的所有打开的数据值，也不包含 27075433343265的值。
TabularDataSupport	TabularDataSupport类是 开放数据类，它实现了 TabularData和 Map接口，内部基于哈希映射数据结构。
TabularType	TabularType类是开放类，其实例描述了TabularData值的类型。

异常摘要

异常	描述
InvalidKeyException	抛出此运行时异常以指示预期为 复合数据的项名称或 表格数据的行索引的方法参数无效。
InvalidOpenTypeException	抛出此运行时异常以指示 打开的类型的 打开数据值不是预期的。
KeyAlreadyExistsException	抛出此运行时异常以指示要添加到 表格数据实例的行的索引已被用于引用此 表格数据实例中的另一行。
OpenDataException	当 打开类型 ， 打开数据或 打开的MBean元数据信息实例无法构造时，抛出此检查的异常，因为一个或多个有效性约束不被满足。