|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object javax.management.MBeanInfo
public class MBeanInfo
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()
の呼び出しの結果を返します。
getDescriptor()
。MBean インタフェース内の記述子注釈の内容を含む記述子を返します。
getDescription()
が返す記述子および内部の属性およびオペレーションの記述子は、対応する Description 注釈が存在する場合には、それに基づいて決定されます。対応する Description 注釈が存在しない場合、内容は指定されません。
Standard MBean によって使用される MBeanInfo
のその他の詳細情報は指定されません。指定されない詳細情報には、含まれるコンストラクタおよび通知の説明、コンストラクタやオペレーションに渡されるパラメータの名前、コンストラクタパラメータの説明が含まれます。
コンストラクタの概要 | |
---|---|
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 の public コンストラクタのリストを返します。 |
String |
getDescription()
人間が読める形式の MBean の説明を返します。 |
Descriptor |
getDescriptor()
この MBeanInfo の記述子を取得します。 |
MBeanNotificationInfo[] |
getNotifications()
MBean によって発行された通知のリストを返します。 |
MBeanOperationInfo[] |
getOperations()
MBean のオペレーションのリストを返します。 |
int |
hashCode()
オブジェクトのハッシュコード値を返します。 |
String |
toString()
オブジェクトの文字列表現を返します。 |
クラス java.lang.Object から継承されたメソッド |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
コンストラクタの詳細 |
---|
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 クラスである場合、 クラスの public メソッドに、 この MBeanInfo 内の属性とオペレーションを 実装する Standard MBean 内のメソッドを含めることが推奨されるが、 これは必須ではないdescription
- 人間が読める形式の MBean の説明 (省略可能)attributes
- MBean の公開属性のリスト。ゼロ長の配列を指定した場合と同様に、null になる場合もあるconstructors
- MBean の public コンストラクタの リスト。ゼロ長の配列を指定した場合と同様に、null になる場合もあるoperations
- MBean のオペレーションのリスト。ゼロ長の配列を指定した場合と同様に、null になる場合もあるnotifications
- 発行された通知のリスト。ゼロ長の配列を指定した場合と同様に、null になる場合もある
IllegalArgumentException
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 クラスである場合、 クラスの public メソッドに、 この MBeanInfo 内の属性とオペレーションを 実装する Standard MBean 内のメソッドを含めることが推奨されるが、 これは必須ではないdescription
- 人間が読める形式の MBean の説明 (省略可能)attributes
- MBean の公開属性のリスト。ゼロ長の配列を指定した場合と同様に、null になる場合もあるconstructors
- MBean の public コンストラクタの リスト。ゼロ長の配列を指定した場合と同様に、null になる場合もあるoperations
- MBean のオペレーションのリスト。ゼロ長の配列を指定した場合と同様に、null になる場合もあるnotifications
- 発行された通知のリスト。ゼロ長の配列を指定した場合と同様に、null になる場合もあるdescriptor
- MBean の記述子。null の場合があり、 これは空の記述子と同等
IllegalArgumentException
メソッドの詳細 |
---|
public Object clone()
このインスタンスのシャローコピーを返します。このコピーは、super.clone() の呼び出し (Object.clone() によって実装されるデフォルトのネイティブシャローコピー機構の呼び出し) によって取得されます。内部フィールドについて、これ以上詳細なコピーは作成されません。
このクラスは不変なので、コピーメソッドは主にサブクラスにとって重要になります。
Object
内の clone
Cloneable
public String getClassName()
MBeanInfo
によって記述された MBean の Java クラスの名前を返します。
public String getDescription()
public MBeanAttributeInfo[] getAttributes()
MBeanAttributeInfo
オブジェクトによって記述されます。
返される配列は、内部配列のシャローコピー、つまり MBeanAttributeInfo
オブジェクトを参照する内部配列のコピーになります。ただし、参照される各 MBeanAttributeInfo
オブジェクトはコピーされません。
MBeanAttributeInfo
オブジェクトの配列public MBeanOperationInfo[] getOperations()
MBeanOperationInfo
オブジェクトによって記述されます。
返される配列は、内部配列のシャローコピー、つまり MBeanOperationInfo
オブジェクトを参照する内部配列のコピーになります。ただし、参照される各 MBeanOperationInfo
オブジェクトはコピーされません。
MBeanOperationInfo
オブジェクトの配列public MBeanConstructorInfo[] getConstructors()
MBean の public コンストラクタのリストを返します。各コンストラクタは MBeanConstructorInfo
オブジェクトによって記述されます。
返される配列は、内部配列のシャローコピー、つまり MBeanConstructorInfo
オブジェクトを参照する内部配列のコピーになります。ただし、参照される各 MBeanConstructorInfo
オブジェクトはコピーされません。
返されるリストは完全でなくてもかまいません。つまり、MBean は、リストにない public コンストラクタを持つこともできます。この場合、MBean サーバーは、リストに含まれているかどうかに関係なく、コンストラクタを使って、この MBean のクラスのインスタンスを新たに構築できます。
MBeanConstructorInfo
オブジェクトの配列public MBeanNotificationInfo[] getNotifications()
MBeanNotificationInfo
オブジェクトによって記述されます。
返される配列は、内部配列のシャローコピー、つまり MBeanNotificationInfo
オブジェクトを参照する内部配列のコピーになります。ただし、参照される各 MBeanNotificationInfo
オブジェクトはコピーされません。
MBeanNotificationInfo
オブジェクトの配列public Descriptor getDescriptor()
DescriptorRead
内の getDescriptor
public String toString()
Object
の記述:toString
メソッドはこのオブジェクトを「テキストで表現する」文字列を返します。この結果は、人間が読める簡潔で有益な情報であるべきです。すべてのサブクラスで、このメソッドをオーバーライドすることをお勧めします。
Object
クラスの toString
メソッドは、オブジェクトの派生元のクラス名、アットマーク (@
)、およびオブジェクトのハッシュコードの符号なし 16 進表現から構成される文字列を返します。つまり、このメソッドは次の値と等しい文字列を返します。
getClass().getName() + '@' + Integer.toHexString(hashCode())
Object
内の toString
public boolean equals(Object o)
この MBeanInfo を別の MBeanInfo と比較します。getClassName()
、getDescription()
、および getDescriptor()
の戻り値が等しく、getAttributes()
、getOperations()
、getConstructors()
、および getNotifications()
の 2 つのオブジェクトによって返される配列のペアが等しい場合、2 つの MBeanInfo オブジェクトは等しくなります。「等しい」とは、ID ではなく、Object.equals(Object)
が等しいことを意味します。
2 つの MBeanInfo オブジェクトによって配列内に返される値が同じでも、その順番が異なっている場合、この 2 つの MBeanInfo オブジェクトは等しくありません。
Object
内の equals
o
- 比較対象のオブジェクト
o
が MBeanInfo であり、 上記のルールによりこのオブジェクトと等しい場合にだけ trueObject.hashCode()
,
Hashtable
public int hashCode()
Object
の記述:java.util.Hashtable
によって提供されるようなハッシュテーブルで使用するために用意されています。
hashCode
メソッドの一般的な規則を次に示します。
hashCode
メソッドを呼び出しても結果は同じ整数値にならなければならない
Object.equals(java.lang.Object)
メソッドで 2 つのオブジェクトが等価でないとされた場合は、これらのオブジェクトに対して hashCode メソッドを呼び出したときに、結果が異なる整数値にならなくてもかまわない。しかし、等しくないオブジェクトについては異なる整数値が生成されるようにすれば、ハッシュテーブルのパフォーマンスを上げることができる
できるかぎり、Object クラスで定義される hashCode メソッドは、異なるオブジェクトについては異なる整数値を返します。通常、これはオブジェクトの内部アドレスを整数値に変換する形で実装されますが、そのような実装テクニックは JavaTM プログラミング言語では不要です。
Object
内の hashCode
Object.equals(java.lang.Object)
,
Hashtable
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。