javax.management.openmbean
類別 OpenMBeanAttributeInfoSupport

java.lang.Object
  javax.management.MBeanFeatureInfo
      javax.management.MBeanAttributeInfo
          javax.management.openmbean.OpenMBeanAttributeInfoSupport

所有已實作的介面：

Serializable, Cloneable, DescriptorRead, OpenMBeanAttributeInfo, OpenMBeanParameterInfo

public class OpenMBeanAttributeInfoSupport
extends MBeanAttributeInfo
implements OpenMBeanAttributeInfo

描述 open MBean 的一個屬性。

從以下版本開始：

1.5

另請參見：

序列化表格

欄位摘要

從類別 javax.management.MBeanFeatureInfo 繼承的欄位

description, name

建構子摘要

OpenMBeanAttributeInfoSupport(String name, String description, OpenType<?> openType, boolean isReadable, boolean isWritable, boolean isIs)
建構一個 OpenMBeanAttributeInfoSupport 實例，該實例使用指定的 name、<openType 和 description 以及指定的讀/寫存取屬性來描述 open MBean 的屬性。

OpenMBeanAttributeInfoSupport(String name, String description, OpenType<?> openType, boolean isReadable, boolean isWritable, boolean isIs, Descriptor descriptor)
建構一個 OpenMBeanAttributeInfoSupport 實例，該實例使用指定的 name、openType、description、讀/寫存取屬性和 Descriptor 來描述 open MBean 的屬性。

OpenMBeanAttributeInfoSupport(String name, String description, OpenType<T> openType, boolean isReadable, boolean isWritable, boolean isIs, T defaultValue)
建構一個 OpenMBeanAttributeInfoSupport 實例，該實例使用指定的 name、openType、description、defaultValue，以及制定的讀/寫存取屬性來描述 open MBean 的屬性。

OpenMBeanAttributeInfoSupport(String name, String description, OpenType<T> openType, boolean isReadable, boolean isWritable, boolean isIs, T defaultValue, Comparable<T> minValue, Comparable<T> maxValue)
建構一個 OpenMBeanAttributeInfoSupport 實例，該實例使用指定的 name、openType、description、defaultValue、minValue 和 maxValue 來描述 open MBean 的屬性。

OpenMBeanAttributeInfoSupport(String name, String description, OpenType<T> openType, boolean isReadable, boolean isWritable, boolean isIs, T defaultValue, T[] legalValues)
建構一個 OpenMBeanAttributeInfoSupport 實例，該實例使用指定的 name、openType、description、defaultValue、legalValues，以及指定的讀/寫存取屬性來描述 open MBean 的屬性。

方法摘要

boolean	equals(Object obj) 比較指定 obj 參數與此 OpenMBeanAttributeInfoSupport 實例的相等性。
Object	getDefaultValue() 返回此 OpenMBeanAttributeInfoSupport 實例描述的屬性的預設值（如果已指定），否則返回 null。
Set<?>	getLegalValues() 返回此 OpenMBeanAttributeInfoSupport 實例描述的屬性的合法值的不可修改的 Set（如果已指定），否則返回 null。
Comparable<?>	getMaxValue() 返回此 OpenMBeanAttributeInfoSupport 實例描述的屬性的最大值（如果已指定），否則返回 null。
Comparable<?>	getMinValue() 返回此 OpenMBeanAttributeInfoSupport 實例描述的屬性的最小值（如果已指定），否則返回 null。
OpenType<?>	getOpenType() 返回此 OpenMBeanAttributeInfoSupport 實例描述的屬性值的開放型別。
boolean	hasDefaultValue() 如果此 OpenMBeanAttributeInfoSupport 實例指定所描述屬性的非 null 預設值，則返回 true，否則返回 false。
int	hashCode() 返回此 OpenMBeanAttributeInfoSupport 實例的雜湊碼值。
boolean	hasLegalValues() 如果此 OpenMBeanAttributeInfoSupport 實例指定所描述屬性的非 null 的合法值集，則返回 true，否則返回 false。
boolean	hasMaxValue() 如果此 OpenMBeanAttributeInfoSupport 實例指定所描述屬性的非 null 的最大值，則返回 true，否則返回 false。
boolean	hasMinValue() 如果此 OpenMBeanAttributeInfoSupport 實例指定所描述屬性的非 null 的最小值，則返回 true，否則返回 false。
boolean	isValue(Object obj) 測試 obj 是否為此 OpenMBeanAttributeInfoSupport 實例描述的屬性的有效值。
String	toString() 返回此 OpenMBeanAttributeInfoSupport 實例的字元串表示形式。

從類別 javax.management.MBeanAttributeInfo 繼承的方法

clone, getType, isIs, isReadable, isWritable

從類別 javax.management.MBeanFeatureInfo 繼承的方法

getDescription, getDescriptor, getName

從類別 java.lang.Object 繼承的方法

finalize, getClass, notify, notifyAll, wait, wait, wait

從介面 javax.management.openmbean.OpenMBeanAttributeInfo 繼承的方法

isIs, isReadable, isWritable

從介面 javax.management.openmbean.OpenMBeanParameterInfo 繼承的方法

getDescription, getName

建構子詳細資訊

OpenMBeanAttributeInfoSupport

public OpenMBeanAttributeInfoSupport(String name,
                                     String description,
                                     OpenType<?> openType,
                                     boolean isReadable,
                                     boolean isWritable,
                                     boolean isIs)

建構一個 OpenMBeanAttributeInfoSupport 實例，該實例使用指定的 name、<openType 和 description 以及指定的讀/寫存取屬性來描述 open MBean 的屬性。

參數：

name - 不可以為 null 或空字元串。

description - 不可以為 null 或空字元串。

openType - 不可以為 null。

isReadable - 如果該屬性有一個為了便於管理而公開的獲取方法，則此參數為 true。

isWritable - 如果該屬性有一個為了便於管理而公開的設置方法，則此參數為 true。

isIs - 如果該屬性的獲取方法的形式是 isXXX，則此參數為 true。

拋出：

IllegalArgumentException - 如果 name 或 description 為 null 或空字元串，或者 openType 為 null。

OpenMBeanAttributeInfoSupport

public OpenMBeanAttributeInfoSupport(String name,
                                     String description,
                                     OpenType<?> openType,
                                     boolean isReadable,
                                     boolean isWritable,
                                     boolean isIs,
                                     Descriptor descriptor)

建構一個 OpenMBeanAttributeInfoSupport 實例，該實例使用指定的 name、openType、description、讀/寫存取屬性和 Descriptor 來描述 open MBean 的屬性。

正如包描述中所解釋的，descriptor 可以包含那些定義此類別某些方法的返回值的項。

參數：

name - 不可以為 null 或空字元串。

description - 不可以為 null 或空字元串。

openType - 不可以為 null。

isReadable - 如果該屬性有一個為了便於管理而公開的獲取方法，則此參數為 true。

isWritable - 如果該屬性有一個為了便於管理而公開的設置方法，則此參數為 true。

isIs - 如果該屬性的獲取方法的形式是 isXXX，則此參數為 true。

descriptor - 屬性的描述符。此參數可以為 null，它等效於一個空描述符。

拋出：

IllegalArgumentException - 如果 name 或 description 為 null 或空字元串；或者 openType 為 null；或者根據包描述中的描述，描述符項無效。

從以下版本開始：

1.6

OpenMBeanAttributeInfoSupport

public OpenMBeanAttributeInfoSupport(String name,
                                     String description,
                                     OpenType<T> openType,
                                     boolean isReadable,
                                     boolean isWritable,
                                     boolean isIs,
                                     T defaultValue)
                              throws OpenDataException

建構一個 OpenMBeanAttributeInfoSupport 實例，該實例使用指定的 name、openType、description、defaultValue，以及制定的讀/寫存取屬性來描述 open MBean 的屬性。

型別參數：

T - 允許編譯器查看 defaultValue（如果不為 null）是否具有對應 openType 的正確 Java 型別。

參數：

name - 不可以為 null 或空字元串。

description - 不可以為 null 或空字元串。

openType - 不可以為 null。

isReadable - 如果該屬性有一個為了便於管理而公開的獲取方法，則此參數為 true。

isWritable - 如果該屬性有一個為了便於管理而公開的設置方法，則此參數為 true。

isIs - 如果該屬性的獲取方法的形式是 isXXX，則此參數為 true。

defaultValue - 必須是為此屬性指定的 @code openType} 的有效值；預設值不支持 ArrayType 和 TabularType；可以為 null，在這種情況下，它意味著不設置任何預設值。

拋出：

IllegalArgumentException - 如果 name 或 description 為 null 或空字元串，或者 openType 為 null。

OpenDataException - 如果 defaultValue 不是指定 openType 的有效值，或者 defaultValue 不為 null 且 openType 為 ArrayType 或 TabularType。

OpenMBeanAttributeInfoSupport

public OpenMBeanAttributeInfoSupport(String name,
                                     String description,
                                     OpenType<T> openType,
                                     boolean isReadable,
                                     boolean isWritable,
                                     boolean isIs,
                                     T defaultValue,
                                     T[] legalValues)
                              throws OpenDataException

建構一個 OpenMBeanAttributeInfoSupport 實例，該實例使用指定的 name、openType、description、defaultValue、legalValues，以及指定的讀/寫存取屬性來描述 open MBean 的屬性。

複製 legalValues 的內容，因此對 legalValues 參考的陣列進行後續修改不會影響此 OpenMBeanAttributeInfoSupport 實例。

型別參數：

T - 允許編譯器查看 defaultValue 和 legalValues（如果不為 null）是否具有對應 openType 的正確 Java 型別。

參數：

name - 不可以為 null 或空字元串。

description - 不可以為 null 或空字元串。

openType - 不可以為 null。

isReadable - 如果該屬性有一個為了便於管理而公開的獲取方法，則此參數為 true。

isWritable - 如果該屬性有一個為了便於管理而公開的設置方法，則此參數為 true。

isIs - 如果該屬性的獲取方法的形式是 isXXX，則此參數為 true。

defaultValue - 必須是為此屬性指定的 openType 的有效值；預設值不支持 ArrayType 和 TabularType；可以為 null，在這種情況下，它意味著不設置任何預設值。

legalValues - 套件含的每個值對於為此屬性指定的 openType 必須是有效的；ArrayType 和 TabularType 不支持的合法值；可以為 null 或空。

拋出：

IllegalArgumentException - 如果 name 或 description 為 null 或空字元串，或者 openType 為 null。

OpenDataException - 如果 defaultValue 對指定的 openType 無效；如果 legalValues 中的一個值對指定的 openType 無效；如果 defaultValue 為非 null 且 openType 為 ArrayType 或 TabularType；如果 legalValues 為非 null 和非空(null)且 openType 為 ArrayType 或 TabularType；如果 legalValues 為非 null 和非空(null)且 legalValues 中不包含 defaultValue。

OpenMBeanAttributeInfoSupport

public OpenMBeanAttributeInfoSupport(String name,
                                     String description,
                                     OpenType<T> openType,
                                     boolean isReadable,
                                     boolean isWritable,
                                     boolean isIs,
                                     T defaultValue,
                                     Comparable<T> minValue,
                                     Comparable<T> maxValue)
                              throws OpenDataException

建構一個 OpenMBeanAttributeInfoSupport 實例，該實例使用指定的 name、openType、description、defaultValue、minValue 和 maxValue 來描述 open MBean 的屬性。只有值為 Comparable 的開放型別才能指定最小值和最大值。

型別參數：

T - 允許編譯器查看 defaultValue、minValue 和 maxValue（如果不為 null）是否具有對應 openType 的正確 Java 型別。

參數：

name - 不可以為 null 或空字元串。

description - 不可以為 null 或空字元串。

openType - 不可以為 null。

isReadable - 如果該屬性有一個為了便於管理而公開的獲取方法，則此參數為 true。

isWritable - 如果該屬性有一個為了便於管理而公開的設置方法，則此參數為 true。

isIs - 如果該屬性的獲取方法的形式是 isXXX，則此參數為 true。

defaultValue - 必須是為此屬性指定的 openType 的有效值；預設值不支持 ArrayType 和 TabularType；可以為 null，在這種情況下，它意味著不設置任何預設值。

minValue - 對於為此屬性指定的 openType 必須有效；可以為 null，在這種情況下，它意味著不設置任何最小值。

maxValue - 對於為此屬性指定的 openType 必須有效；可以為 null，在這種情況下，它意味著不設置任何最大值。

拋出：

IllegalArgumentException - 如果 name 或 description 為 null 或空字元串，或者 openType 為 null。

OpenDataException - 如果 defaultValue、minValue 或 maxValue 不是對應指定 openType 的有效值；如果 defaultValue 不為 null 且 openType 是 ArrayType 或 TabularType；如果 minValue 和 maxValue 都不為 null 且 minValue.compareTo(maxValue) > 0 為 true；如果 defaultValue 和 minValue 都不為 null 且 minValue.compareTo(defaultValue) > 0 為 true；如果 defaultValue 和 maxValue 都不為 null 且 defaultValue.compareTo(maxValue) > 0 為 true。

方法詳細資訊

getOpenType

public OpenType<?> getOpenType()

返回此 OpenMBeanAttributeInfoSupport 實例描述的屬性值的開放型別。

指定者：

介面 OpenMBeanParameterInfo 中的 getOpenType

返回：

開放型別。

getDefaultValue

public Object getDefaultValue()

返回此 OpenMBeanAttributeInfoSupport 實例描述的屬性的預設值（如果已指定），否則返回 null。

指定者：

介面 OpenMBeanParameterInfo 中的 getDefaultValue

返回：

預設值。

getLegalValues

public Set<?> getLegalValues()

返回此 OpenMBeanAttributeInfoSupport 實例描述的屬性的合法值的不可修改的 Set（如果已指定），否則返回 null。

指定者：

介面 OpenMBeanParameterInfo 中的 getLegalValues

返回：

合法值的集合。

getMinValue

public Comparable<?> getMinValue()

返回此 OpenMBeanAttributeInfoSupport 實例描述的屬性的最小值（如果已指定），否則返回 null。

指定者：

介面 OpenMBeanParameterInfo 中的 getMinValue

返回：

最小值。

getMaxValue

public Comparable<?> getMaxValue()

返回此 OpenMBeanAttributeInfoSupport 實例描述的屬性的最大值（如果已指定），否則返回 null。

指定者：

介面 OpenMBeanParameterInfo 中的 getMaxValue

返回：

最大值。

hasDefaultValue

public boolean hasDefaultValue()

如果此 OpenMBeanAttributeInfoSupport 實例指定所描述屬性的非 null 預設值，則返回 true，否則返回 false。

指定者：

介面 OpenMBeanParameterInfo 中的 hasDefaultValue

返回：

如果存在預設值，則返回 true。

hasLegalValues

public boolean hasLegalValues()

如果此 OpenMBeanAttributeInfoSupport 實例指定所描述屬性的非 null 的合法值集，則返回 true，否則返回 false。

指定者：

介面 OpenMBeanParameterInfo 中的 hasLegalValues

返回：

如果存在合法值的集合，則返回 true。

hasMinValue

public boolean hasMinValue()

如果此 OpenMBeanAttributeInfoSupport 實例指定所描述屬性的非 null 的最小值，則返回 true，否則返回 false。

指定者：

介面 OpenMBeanParameterInfo 中的 hasMinValue

返回：

如果存在最小值，則返回 true。

hasMaxValue

public boolean hasMaxValue()

如果此 OpenMBeanAttributeInfoSupport 實例指定所描述屬性的非 null 的最大值，則返回 true，否則返回 false。

指定者：

介面 OpenMBeanParameterInfo 中的 hasMaxValue

返回：

如果存在最大值，則返回 true。

isValue

public boolean isValue(Object obj)

測試 obj 是否為此 OpenMBeanAttributeInfoSupport 實例描述的屬性的有效值。

指定者：

介面 OpenMBeanParameterInfo 中的 isValue

參數：

obj - 要測試的物件。

返回：

如果 obj 是此 OpenMBeanAttributeInfoSupport 實例描述的參數的有效值，則返回 true，否則返回 false。

equals

public boolean equals(Object obj)

比較指定 obj 參數與此 OpenMBeanAttributeInfoSupport 實例的相等性。

當且僅當下面的所有語句均為 true 時，才返回 true：

• obj 為非 null，
• obj 還實作 OpenMBeanAttributeInfo 介面，
• 它們的名稱相等
• 它們的開放型別相等
• 它們的存取屬性（isReadable、isWritable 和 isIs）相等
• 它們的預設值、最小值、最大值和合法值相等。

這確保了此 equals 方法對作為 OpenMBeanAttributeInfo 介面的不同實作的 obj 參數正常工作。

如果 obj 還實作 DescriptorRead，則其 getDescriptor() 必須為此物件返回相同的值。

指定者：

介面 OpenMBeanAttributeInfo 中的 equals

指定者：

介面 OpenMBeanParameterInfo 中的 equals

覆寫：

類別 MBeanAttributeInfo 中的 equals

參數：

obj - 與此 OpenMBeanAttributeInfoSupport 實例進行相等性比較的物件。

返回：

如果指定的物件等於此 OpenMBeanAttributeInfoSupport 實例，則返回 true。

另請參見：

Object.hashCode(), Hashtable

hashCode

public int hashCode()

返回此 OpenMBeanAttributeInfoSupport 實例的雜湊碼值。

OpenMBeanAttributeInfoSupport 實例的雜湊碼是在 equals 比較中使用的所有資訊元素的雜湊碼的總和（即它的名稱、開放型別、預設值、最小值、最大值、合法值和 Descriptor）。

這確保 t1.equals(t2) 意味著對於任何兩個 OpenMBeanAttributeInfoSupport 實例 t1 和 t2 而言，都存在 t1.hashCode()==t2.hashCode()，這是方法 Object.hashCode() 的通用協定所要求的。

不過請注意，根據 equals(java.lang.Object) 中的定義，實作 OpenMBeanAttributeInfo 介面的類別的其他實例可能與此 OpenMBeanAttributeInfoSupport 實例相等，但是如果它的計算方法不同，可能會有不同的雜湊碼。

由於 OpenMBeanAttributeInfoSupport 實例是不可變的，此實例的雜湊碼在首次調用 hashCode 時被計算一次，然後對後續調用返回相同的值。

指定者：

介面 OpenMBeanAttributeInfo 中的 hashCode

指定者：

介面 OpenMBeanParameterInfo 中的 hashCode

覆寫：

類別 MBeanAttributeInfo 中的 hashCode

返回：

此 OpenMBeanAttributeInfoSupport 實例的雜湊碼值

另請參見：

Object.equals(java.lang.Object), Hashtable

toString

public String toString()

返回此 OpenMBeanAttributeInfoSupport 實例的字元串表示形式。

字元串表示形式由此類別（即 javax.management.openmbean.OpenMBeanAttributeInfoSupport）的名稱、名稱的字元串表示形式和描述參數的開放型別，以及它的預設值、最小值、最大值和合法值和描述符的字元串表示形式組成。

由於 OpenMBeanAttributeInfoSupport 實例是不可變的，所以此實例的字元串表示形式在首次調用 toString 時被計算一次，然後對後續調用返回相同的值。

指定者：

介面 OpenMBeanAttributeInfo 中的 toString

指定者：

介面 OpenMBeanParameterInfo 中的 toString

覆寫：

類別 MBeanAttributeInfo 中的 toString

返回：

此 OpenMBeanAttributeInfoSupport 實例的字元串表示形式