JavaTM 2 Platform
Standard Ed. 5.0

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 サーバにより、次のように決定されます。

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 メソッドの一般的な規則を次に示します。

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

オーバーライド:
クラス Object 内の hashCode
戻り値:
このオブジェクトのハッシュコード値
関連項目:
Object.equals(java.lang.Object), Hashtable

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。