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元数据信息实例无法构造时,抛出此检查的异常,因为一个或多个有效性约束不被满足。