javax.management
クラス MBeanInfo

java.lang.Object
  javax.management.MBeanInfo

すべての実装されたインタフェース:

Serializable, Cloneable

直系の既知のサブクラス:

ModelMBeanInfoSupport, OpenMBeanInfoSupport

public class MBeanInfo
extends Object
implements Cloneable, Serializable

MBean によって公開された管理インタフェース (管理オペレーションに使用できる属性と操作のセット) を記述します。このクラスのインスタンスは不変です。サブクラスは可変ですが、サブクラスの変更は推奨されていません。

Dynamic MBean によって使用される MBeanInfo のコンテンツは、getMBeanInfo() メソッドによって決定されます。Dynamic MBean である Open MBean、Model MBean が含まれます。

Standard MBean によって使用される MBeanInfo のコンテンツは、MBean サーバにより、次のように決定されます。

• getClassName() MBean オブジェクトの Java クラス名を返す
• getConstructors() そのオブジェクト内のすべての public コンストラクタのリストを返す
• getAttributes() すべての属性のリストを返す。その属性が存在するかどうかは、Standard MBean の規約に準拠した getName、isName、または setName メソッドの MBean インタフェース内に存在するかどうかで推測できる
• getOperations() 属性を表さない MBean インタフェース内のすべてのメソッドのリストを返す
• getNotifications() MBean が NotificationBroadcaster インタフェースを実装しない場合は空の配列、それ以外の場合は NotificationBroadcaster.getNotificationInfo() の呼び出しの結果を返す

Standard MBean によって使用される MBeanInfo のその他の詳細情報は指定されません。指定されない詳細情報には、MBeanInfo の説明、その他のコンストラクタ、属性、オペレーション、および通知の説明、コンストラクタやオペレーションに渡されるパラメータの名前と説明が含まれます。

導入されたバージョン:

1.5

関連項目:

直列化された形式

コンストラクタの概要

MBeanInfo(String className, String description, MBeanAttributeInfo[] attributes, MBeanConstructorInfo[] constructors, MBeanOperationInfo[] operations, MBeanNotificationInfo[] notifications)
MBeanInfo を構築します。

メソッドの概要

Object	clone() このインスタンスのシャローコピーを返します。
boolean	equals(Object o) この MBeanInfo を別の MBeanInfo と比較します。
MBeanAttributeInfo[]	getAttributes() 管理用の公開属性のリストを返します。
String	getClassName() この MBeanInfo によって記述された MBean の Java クラスの名前を返します。
MBeanConstructorInfo[]	getConstructors() MBean の public コンストラクタのリストを返します。
String	getDescription() 人間が読める形式の MBean の説明を返します。
MBeanNotificationInfo[]	getNotifications() MBean によって発行された通知のリストを返します。
MBeanOperationInfo[]	getOperations() MBean のオペレーションのリストを返します。
int	hashCode() オブジェクトのハッシュコード値を返します。

クラス java.lang.Object から継承されたメソッド

finalize, getClass, notify, notifyAll, toString, 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 のクラスローダの既知の Java クラスでなくてもよい。MBean のクラスローダの既知の Java クラスである場合、クラスの public メソッドに、この MBeanInfo 内の属性とオペレーションを実装する Standard MBean 内のメソッドを含めることが推奨されるが、これは必須ではない

description - 人間が読める形式の MBean の説明 (任意)

attributes - MBean の公開属性のリスト。ゼロ長の配列を指定した場合と同様に、null になる場合もある

constructors - MBean の public コンストラクタのリスト。ゼロ長の配列を指定した場合と同様に、null になる場合もある

operations - MBean のオペレーションのリスト。ゼロ長の配列を指定した場合と同様に、null になる場合もある

notifications - 発行された通知のリスト。ゼロ長の配列を指定した場合と同様に、null になる場合もある

例外:

IllegalArgumentException

メソッドの詳細

clone

public Object clone()

このインスタンスのシャローコピーを返します。このコピーは、super.clone() の呼び出し (Object.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 の public コンストラクタのリストを返します。各オペレーションは MBeanConstructorInfo オブジェクトによって記述されます。

返される配列は、内部配列のシャローコピー、つまり MBeanConstructorInfo オブジェクトを参照する内部配列のコピーになります。ただし、参照される各 MBeanConstructorInfo オブジェクトはコピーされません。

返されるリストは完全でなくてもかまいません。つまり、MBean は、リストにない public コンストラクタを持つこともできます。この場合、MBean サーバは、リストに含まれているかどうかに関係なく、コンストラクタを使って、この MBean のクラスのインスタンスを新たに構築できます。

戻り値:

MBeanConstructorInfo オブジェクトの配列

getNotifications

public MBeanNotificationInfo[] getNotifications()

MBean によって発行された通知のリストを返します。各通知は MBeanNotificationInfo オブジェクトによって記述されます。 返される配列は、内部配列のシャローコピー、つまり MBeanNotificationInfo オブジェクトを参照する内部配列のコピーになります。ただし、参照される各 MBeanNotificationInfo オブジェクトはコピーされません。

戻り値:

MBeanNotificationInfo オブジェクトの配列

equals

public boolean equals(Object o)

この MBeanInfo を別の MBeanInfo と比較します。getClassName() および getDescription() の戻り値が等しく、getAttributes()、getOperations()、getConstructors()、および getNotifications() の 2 つのオブジェクトによって返される配列の値のペアが等しい場合、2 つの MBeanInfo オブジェクトは等しくなります。「等しい」とは、ID ではなく、Object.equals(Object) が等しいことを意味します。

2 つの MBeanInfo オブジェクトによって配列内に返される値が同じでも、その順番が異なっている場合、この 2 つの MBeanInfo オブジェクトは等しくありません。

オーバーライド:

クラス Object 内の equals

パラメータ:

o - 比較対象のオブジェクト

戻り値:

o が、上記の規則に従ってこのオブジェクトに等しい MBeanInfo である場合、true

関連項目:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

クラス Object の記述:

オブジェクトのハッシュコード値を返します。このメソッドは、java.util.Hashtable によって提供されるようなハッシュテーブルで使用するために用意されています。

hashCode メソッドの一般的な規則を次に示します。

• Java アプリケーションの実行中に同じオブジェクト上で複数回呼び出される場合は必ず、このオブジェクトに対する equals による比較で使われた情報が変更されていなければ、hashCode メソッドは同じ整数を一貫して返さなければならない。アプリケーションを一度終了してからもう一度同じアプリケーションを実行した場合、このメソッドから返される整数は前回の実行時に返された整数と同じであるとは限らない
• equals(Object) メソッドで 2 つのオブジェクトが等価とされた場合、どちらのオブジェクトで hashCode メソッドを呼び出しても結果は同じ整数値にならなければならない
• Object.equals(java.lang.Object) メソッドで 2 つのオブジェクトが等価でないとされた場合は、これらのオブジェクトに対して hashCode メソッドを呼び出したときに、結果が異なる整数値にならなくてもかまわない。しかし、等しくないオブジェクトについては異なる整数値が生成されるようにすれば、ハッシュテーブルのパフォーマンスを上げることができる

できるかぎり、Object クラスで定義される hashCode メソッドは、異なるオブジェクトについては異なる整数値を返します。通常、これはオブジェクトの内部アドレスを整数値に変換する形で実装されますが、そのような実装テクニックは Java^TM プログラミング言語では不要です。

オーバーライド:

クラス Object 内の hashCode

戻り値:

このオブジェクトのハッシュコード値

関連項目:

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