javax.management
類別 MBeanInfo

java.lang.Object
  javax.management.MBeanInfo

所有已實作的介面：

Serializable, Cloneable, DescriptorRead

直接已知子類別：

ModelMBeanInfoSupport, OpenMBeanInfoSupport

public class MBeanInfo
extends Object
implements Cloneable, Serializable, DescriptorRead

描述由 MBean 公開的管理介面；即描述為管理操作所提供的屬性和操作的集合。此類別的實例是不可變的。子類別可以是可變的，但是不推薦使用此功能。

Dynamic MBean 的 MBeanInfo 內容由其 getMBeanInfo() 方法確定。這包括 Open MBean 和 Model MBean，它們都屬於 Dynamic MBean。

Standard MBean 的 MBeanInfo 內容由 MBean 伺服器按如下方式確定：

• getClassName() 返回 MBean 物件的 Java 類別名；
• getConstructors() 返回該物件中所有公共建構子的列表；
• getAttributes() 返回所有屬性的列表，這些屬性的存在是根據 MBean 介面中是否存在 getName、isName 或 setName 方法（符合 Standard MBean 的約定）來推斷的；
• getOperations() 返回 MBean 介面中不表示屬性的所有方法的列表；
• 如果 MBean 未實作 NotificationBroadcaster 介面，則 getNotifications() 返回一個空陣列；否則它返回在該介面上調用 NotificationBroadcaster.getNotificationInfo() 的結果；
• getDescriptor() 返回一個描述符，其包含的內容是 MBean 介面中的所有描述符註釋。

getDescription() 返回的描述以及所含屬性和操作的描述由相應的 Description 註釋（如果有）確定；其他情況下，其內容沒有指定。

沒有指定 Standard MBean 的 MBeanInfo 的其餘細節。這包括所有套件含的建構子、通知的描述；建構子和操作的參數的名稱，以及建構子參數的描述。

從以下版本開始：

1.5

另請參見：

序列化表格

建構子摘要

MBeanInfo(String className, String description, MBeanAttributeInfo[] attributes, MBeanConstructorInfo[] constructors, MBeanOperationInfo[] operations, MBeanNotificationInfo[] notifications)
建構一個 MBeanInfo。

MBeanInfo(String className, String description, MBeanAttributeInfo[] attributes, MBeanConstructorInfo[] constructors, MBeanOperationInfo[] operations, MBeanNotificationInfo[] notifications, Descriptor descriptor)
建構一個 MBeanInfo。

方法摘要

Object	clone() 返回此實例的淺表副本。
boolean	equals(Object o) 比較此 MBeanInfo 與另一個 MBeanInfo。
MBeanAttributeInfo[]	getAttributes() 返回為了便於管理而公開的屬性的列表。
String	getClassName() 返回此 MBeanInfo 描述的 MBean 的 Java 類別名。
MBeanConstructorInfo[]	getConstructors() 返回 MBean 的公共建構子列表。
String	getDescription() 返回該 MBean 的可讀描述。
Descriptor	getDescriptor() 獲取此 MBean 的描述符。
MBeanNotificationInfo[]	getNotifications() 返回 MBean 所發出的通知列表。
MBeanOperationInfo[]	getOperations() 返回 MBean 的操作列表。
int	hashCode() 返回該物件的雜湊碼值。
String	toString() 返回該物件的字元串表示。

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

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

建構子詳細資訊

MBeanInfo

public MBeanInfo(String className,
                 String description,
                 MBeanAttributeInfo[] attributes,
                 MBeanConstructorInfo[] constructors,
                 MBeanOperationInfo[] operations,
                 MBeanNotificationInfo[] notifications)
          throws IllegalArgumentException

建構一個 MBeanInfo。

參數：

className - 此 MBeanInfo 所描述的 MBean 的 Java 類別名。此值可以是任何語法上合法的 Java 類別名。它不必是 MBean 伺服器或 MBean 的 ClassLoader 已知的 Java 類別。如果它是 MBean 的 ClassLoader 已知的 Java 類別，則建議但並不要求該類別的公共方法包括此 MBeanInfo 中的屬性和操作，而這些屬性和操作將出現在 Standard MBean 實作中。

description - MBean 的可讀描述（可選）。

attributes - MBean 已公開的屬性的列表。此參數可以為 null，與零長度陣列的效果相同。

constructors - MBean 的公共建構子列表。此參數可以為 null，與零長度陣列的效果相同。

operations - MBean 的操作列表。此參數可以為 null，與零長度陣列的效果相同。

notifications - 已發出的那些通知的列表。此參數可以為 null，與零長度陣列的效果相同。

拋出：

IllegalArgumentException

MBeanInfo

public MBeanInfo(String className,
                 String description,
                 MBeanAttributeInfo[] attributes,
                 MBeanConstructorInfo[] constructors,
                 MBeanOperationInfo[] operations,
                 MBeanNotificationInfo[] notifications,
                 Descriptor descriptor)
          throws IllegalArgumentException

建構一個 MBeanInfo。

參數：

className - 此 MBeanInfo 所描述的 MBean 的 Java 類別名。此值可以是任何語法上合法的 Java 類別名。它不必是 MBean 伺服器或 MBean 的 ClassLoader 已知的 Java 類別。如果它是 MBean 的 ClassLoader 已知的 Java 類別，則建議但並不要求該類別的公共方法包括此 MBeanInfo 中的屬性和操作，而這些屬性和操作將出現在 Standard MBean 實作中。

description - MBean 的可讀描述（可選）。

attributes - MBean 已公開的屬性的列表。此參數可以為 null，與零長度陣列的效果相同。

constructors - MBean 的公共建構子列表。此參數可以為 null，與零長度陣列的效果相同。

operations - MBean 的操作列表。此參數可以為 null，與零長度陣列的效果相同。

notifications - 已發出的那些通知的列表。此參數可以為 null，與零長度陣列的效果相同。

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

拋出：

IllegalArgumentException

從以下版本開始：

1.6

方法詳細資訊

clone

public Object clone()

返回此實例的淺表副本。可通過調用 super.clone() 來獲得該副本，因此要調用 Object.clone() 所實作的預設本機淺表複製機制。不進行任何內部欄位的更深層複製。

因為此類別是不可變的，所以主要針對子類別使用該 clone 方法。

覆寫：

類別 Object 中的 clone

返回：

此實例的一個副本。

另請參見：

Cloneable

getClassName

public String getClassName()

返回此 MBeanInfo 描述的 MBean 的 Java 類別名。

返回：

類別名。

getDescription

public String getDescription()

返回該 MBean 的可讀描述。

返回：

描述。

getAttributes

public MBeanAttributeInfo[] getAttributes()

返回為了便於管理而公開的屬性的列表。每個屬性由一個 MBeanAttributeInfo 物件描述。返回的陣列是內部陣列的一個淺表副本，這意味著它是 MBeanAttributeInfo 物件參考的一個內部陣列副本，但它沒有複製每個被參考的 MBeanAttributeInfo 物件。

返回：

MBeanAttributeInfo 物件的陣列。

getOperations

public MBeanOperationInfo[] getOperations()

返回 MBean 的操作列表。每個操作由一個 MBeanOperationInfo 物件描述。返回的陣列是內部陣列的一個淺表副本，這意味著它是 MBeanOperationInfo 物件參考的一個內部陣列副本，但它沒有複製每個被參考的 MBeanOperationInfo 物件。

返回：

MBeanOperationInfo 物件的陣列。

getConstructors

public MBeanConstructorInfo[] getConstructors()

返回 MBean 的公共建構子列表。每個建構子都由一個 MBeanConstructorInfo 物件描述。

返回的陣列是內部陣列的一個淺表副本，這意味著它是 MBeanConstructorInfo 物件參考的一個內部陣列副本，但它沒有複製每個被參考的 MBeanConstructorInfo 物件。

該返回的列表不必包括全部的建構子。也就是說，該 MBean 具有的公共建構子可能不在該列表中。在這種情況下，MBean 伺服器可以使用該建構子建構此 MBean 類別的另一個實例，即使該建構子不在列表中也是如此。

返回：

MBeanConstructorInfo 物件的陣列。

getNotifications

public MBeanNotificationInfo[] getNotifications()

返回 MBean 所發出的通知列表。每個通知由一個 MBeanNotificationInfo 物件描述。返回的陣列是內部陣列的一個淺表副本，這意味著它是 MBeanNotificationInfo 物件參考的一個內部陣列副本，但它沒有複製每個被參考的 MBeanNotificationInfo 物件。

返回：

MBeanNotificationInfo 物件的陣列。

getDescriptor

public Descriptor getDescriptor()

獲取此 MBean 的描述符。更改返回值對原描述符沒有影響。

指定者：

介面 DescriptorRead 中的 getDescriptor

返回：

一個描述符，可能是不可變的，也可能是原描述符的副本。

從以下版本開始：

1.6

toString

public String toString()

從類別 Object 複製的描述

返回該物件的字元串表示。通常，toString 方法會返回一個「以文本方式表示」此物件的字元串。結果應是一個簡明但易於讀懂的資訊表達式。建議所有子類別都覆寫此方法。

Object 類別的 toString 方法返回一個字元串，該字元串由類別名（物件是該類別的一個實例）、at 標記符“@”和此物件雜湊碼的無符號十六進製表示組成。換句話說，該方法返回一個字元串，它的值等於：

getClass().getName() + '@' + Integer.toHexString(hashCode())
 

覆寫：

類別 Object 中的 toString

返回：

該物件的字元串表示形式。

equals

public boolean equals(Object o)

比較此 MBeanInfo 與另一個 MBeanInfo。當且僅當兩個 MBeanInfo 物件的 getClassName()、getDescription() 和 getDescriptor() 返回相等值，並且兩個物件的 getAttributes()、getOperations()、getConstructors() 和 getNotifications() 所返回的陣列是成對相等時，這兩個 MBeanInfo 才是相等的。其中“相等”指的是 Object.equals(Object)，而不是相同。

如果兩個 MBeanInfo 物件返回的陣列中的值相同，但是順序不同，則這兩個物件不是相等的。

覆寫：

類別 Object 中的 equals

參數：

o - 要比較的物件。

返回：

當且僅當根據上述規則 o 等於此 MBeanInfo 時才返回 true。

另請參見：

Object.hashCode(), Hashtable

hashCode

public int hashCode()

從類別 Object 複製的描述

返回該物件的雜湊碼值。支持此方法是為了提高雜湊表（例如 java.util.Hashtable 提供的雜湊表）的性能。

hashCode 的常規協定是：

• 在 Java 應用程序執行期間，在對同一物件多次調用 hashCode 方法時，必須一致地返回相同的整數，前提是將物件進行 equals 比較時所用的資訊沒有被修改。從某一應用程序的一次執行到同一應用程序的另一次執行，該整數無需保持一致。
• 如果根據 equals(Object) 方法，兩個物件是相等的，那麼對這兩個物件中的每個物件調用 hashCode 方法都必須產生相同的整數結果。
• 如果根據 Object.equals(java.lang.Object) 方法，兩個物件不相等，那麼對這兩個物件中的任一物件上調用 hashCode 方法不 要求一定產生不同的整數結果。但是，開發人員應該意識到，為不相等的物件產生不同整數結果可以提高雜湊表的性能。

實際上，由 Object 類別定義的 hashCode 方法確實會針對不同的物件返回不同的整數。（這一般是通過將該物件的內部位址轉換成一個整數來實作的，但是 Java^TM 程式語言不需要這種實作技巧。）

覆寫：

類別 Object 中的 hashCode

返回：

此物件的一個雜湊碼值。

另請參見：

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