軟體套件 javax.management.openmbean

提供開放資料型別和 Open MBean 描述符類別。

請參見：
描述

介面摘要

CompositeData	CompositeData 介面指定表示復合資料 結構的複雜開放資料 物件的特定型別的行為。
CompositeDataView	Java 類別可以實作此介面，以指示如何通過 MXBean 框架將其轉換為 CompositeData。
OpenMBeanAttributeInfo	描述 open MBean 的屬性。
OpenMBeanConstructorInfo	描述 Open MBean 的建構子。
OpenMBeanInfo	描述一個 Open MBean：Open MBean 的識別方式為，如果 Open MBean 的 getMBeanInfo() 方法返回實作 OpenMBeanInfo 介面（通常為 OpenMBeanInfoSupport）的類別的實例，則可識別 Open MBean。
OpenMBeanOperationInfo	描述 Open MBean 的操作。
OpenMBeanParameterInfo	描述用於 open MBean 的一個或多個操作或建構子的參數。
TabularData	TabularData 介面指定特定型別的複雜開放資料 物件的行為，該物件表示了表格資料 結構。

類別摘要

ArrayType<T>	ArrayType 類別是一種開放型別 類別，其實例描述了作為開放資料 值的 n 維陣列的所有開放資料 值。
CompositeDataInvocationHandler	將獲取方法轉發給 CompositeData 的 InvocationHandler。
CompositeDataSupport	CompositeDataSupport 類別是實作 CompositeData 介面的開放資料 類別。
CompositeType	CompositeType 類別是開放型別 類別，它的實例描述了 CompositeData 值的型別。
OpenMBeanAttributeInfoSupport	描述 open MBean 的一個屬性。
OpenMBeanConstructorInfoSupport	描述 Open MBean 的建構子。
OpenMBeanInfoSupport	OpenMBeanInfoSupport 類別描述 open MBean 的管理資訊：它是 MBeanInfo 的子類別，並且實作了 OpenMBeanInfo 介面。
OpenMBeanOperationInfoSupport	描述 Open MBean 的一個操作。
OpenMBeanParameterInfoSupport	描述用於 open MBean 的一個或多個操作或建構子的參數。
OpenType<T>	OpenType 類別是全部類別的父抽象類別，它描述開放資料值的實際開放型別。
SimpleType<T>	SimpleType 類別是開放型別 類別，其實例描述所有開放資料 值，這些值既不是陣列，也不是 CompositeData 值，更不是 TabularData 值。
TabularDataSupport	TabularDataSupport 類別是實作 TabularData 和 Map 介面的開放資料 類別，並且在內部它是基於雜湊映射資料結構的。
TabularType	TabularType 類別是開放型別 類別，它的實例描述了 TabularData 值的型別。

異常摘要

InvalidKeyException	當方法參數作為復合資料 的項名稱或表格資料 的行索引時，如果其無效，則拋出此運行時異常。
InvalidOpenTypeException	當開放資料 值的開放型別 不是期望的型別時，拋出此運行時異常。
KeyAlreadyExistsException	當添加到表格資料 實例的行索引已用於參考此表格資料 實例中的另一行時，拋出此運行時異常。
OpenDataException	因為無法滿足一個或多個有效性約束，所以無法建構開放型別、開放資料 或 open MBean 元資料資訊 實例時，拋出此經過檢查的異常。

軟體套件 javax.management.openmbean 的描述

提供開放資料型別和 Open MBean 描述符類別。Open MBean 是一種 MBean，其中的屬性和操作參數的型別和返回值是使用預定義的 Java 類別的小集合建構的。Open MBeans 通過遠端管理程序簡化了操作，無需存取特定於應用程序的型別（包括非 Java 程序）。

每個 MBean 都有一個 MBeanInfo，它包含關於 MBean 本身、其屬性、操作、建構子和通知的資訊。在 Open MBean 中，此 MBeanInfo 實作 OpenMBeanInfo 介面，通常通過作為 OpenMBeanInfoSupport 的實例來實作。

由 MBeanInfo.getAttributes 為 Open MBean 返回的屬性資訊是實作 OpenMBeanAttributeInfo 的物件的陣列，通常為 OpenMBeanAttributeInfoSupport 的實例。除關於屬性的一般資訊外，OpenMBeanAttributeInfo 還指定屬性的 OpenType。可能的 OpenType 值是預定義的，這可以確保遠端管理人員能夠理解它們。

類似的註釋可應用於操作和建構子的參數型別，以及操作的返回型別。

getType() 返回的屬性的 Java 語言型別和 getOpenType() 返回的 OpenType 之間存在差別。例如，如果 Java 語言型別為 java.lang.String，則 OpenType 將為 SimpleType.String。如果 Java 語言型別為 CompositeData，則 OpenType 將為 CompositeType，它描述屬性的 CompositeData 實例中的項。

預設值和約束條件

在 Open MBean 中，屬性和參數可以在 OpenMBeanAttributeInfo 或 OpenMBeanParameterInfo 中擁有預設值和/或與之相關的約束條件。有兩種指定這些約束條件的方法。一種是將值直接指定為 OpenMBeanAttributeInfoSupport 或 OpenMBeanParameterInfoSupport 的建構子的一個參數，例如，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，並且陣列或 set 的元素必須能夠根據對 defaultValue 等的描述進行轉換。

對於這些欄位必須滿足以下約束條件：

• 如上所述，值必須是恰當型別，或者是可以轉換為恰當型別的字元串；
• 如果存在 legalValues，則無須存在 minValue 和 maxValue；
• 如果 defaultValue 存在，則當 legalValues、minValue 或 maxValue 也存在時 defaultValue 必須滿足它們所定義的約束條件。
• 如果 minValue 和 maxValue 都存在，則 minValue 不得大於 maxValue。

從以下版本開始：

1.5

另請參見：

Java SE 6 Platform documentation on JMX technology， 特別是 JMX Specification, version 1.4