compact3

Package javax.management.openmbean

提供打开的数据类型和Open MBean描述符类。

See: 描述

接口摘要

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

类摘要

类	描述
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类是开放式类，其实例描述了既不是数组也不是CompositeData值的所有打开数据值，也不是TabularData值。
TabularDataSupport	TabularDataSupport类是 开放数据类，它实现了 TabularData和 Map接口，内部基于散列映射数据结构。
TabularType	TabularType类是开放类，其实例描述了TabularData值的类型。

异常摘要

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

Package javax.management.openmbean Description

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

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

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

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

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

Default values and constraints

在开放MBean，属性和参数可以具有默认值和/或与它们在相关联的约束OpenMBeanAttributeInfo或OpenMBeanParameterInfo 。 有两种方法来指定这些约束。 这些值直接指定为OpenMBeanAttributeInfoSupport或OpenMBeanParameterInfoSupport之一的构造函数的OpenMBeanParameterInfoSupport ，例如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