Package javax.management.openmbean

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

See: 描述

接口摘要

接口	描述
CompositeData	的 CompositeData接口指定一个特定类型的复杂开放数据对象代表复合数据结构行为。
CompositeDataView	一个java类可以实现此接口以显示它是如何被转换成一个 CompositeData MXBean框架。
OpenMBeanAttributeInfo	介绍了一个开放的MBean属性。
OpenMBeanConstructorInfo	描述了一个构造函数，一个开放的MBean。
OpenMBeanInfo	介绍了一个开放的MBean：开放MBean是公认的 getMBeanInfo()如果方法返回一个类实现了 OpenMBeanInfo接口实例等，通常 OpenMBeanInfoSupport。
OpenMBeanOperationInfo	介绍了一个开放的MBean操作。
OpenMBeanParameterInfo	介绍了一种用于在一个或多个操作或构造函数开放MBean参数。
TabularData	的 TabularData接口指定一个特定类型的复杂开放数据对象代表表格数据结构行为。

类摘要

类	描述
ArrayType<T>	的 ArrayType类是开放式类的实例描述所有开放数据值是n维数组的开放数据值。
CompositeDataInvocationHandler	一个 InvocationHandler转发到 CompositeData getter方法。
CompositeDataSupport	的 CompositeDataSupport类实现接口的类 CompositeData开放数据。
CompositeType	的 CompositeType类是开放式类的实例描述 CompositeData值类型。
OpenMBeanAttributeInfoSupport	介绍了一个开放的MBean属性。
OpenMBeanConstructorInfoSupport	描述了一个构造函数，一个开放的MBean。
OpenMBeanInfoSupport	的 OpenMBeanInfoSupport类描述了一个开放的MBean管理信息：它是 MBeanInfo的子类，它实现了 OpenMBeanInfo接口。
OpenMBeanOperationInfoSupport	介绍了一个开放的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

提供开放的数据类型和开放MBean描述符类。一个开放的MBean MBean的属性和操作参数和返回值的类型是使用较小的一组预定义的java类的建立。开放MBean操作方便的远程管理程序，不一定能获得特定于应用程序的类型，包括非java程序。

每一个MBean与MBean本身信息的MBeanInfo，及其属性、操作、施工，并通知。在一个开放的MBean，这MBeanInfo实现OpenMBeanInfo接口，通常是OpenMBeanInfoSupport实例。

返回MBeanInfo.getAttributes开放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。有两种方法来指定这些约束。无论是值直接指定为参数的一个或OpenMBeanParameterInfoSupport OpenMBeanAttributeInfoSupport构造函数，例如OpenMBeanParameterInfoSupport.OpenMBeanParameterInfoSupport( String, String, OpenType, Object, Object[])；或值在Descriptor作为参数提供一个构造函数指定。

当一个Descriptor使用，这些都是感兴趣的领域：

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

对于defaultValue，minValue，和maxValue，关联的值必须对应于openType java类型，或者是一个字符串，可以转换成该类型。转换采用静态的方法valueOf(String)如果发现；另有一个String参数构造函数如果发现；否则失败。

对于legalValues，关联的值必须是一个数组或Set，和数组或集合中的元素必须是活了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