javax.management
クラス MBeanAttributeInfo

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

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

Serializable, Cloneable, DescriptorRead

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

ModelMBeanAttributeInfo, OpenMBeanAttributeInfoSupport

public class MBeanAttributeInfo
extends MBeanFeatureInfo
implements Cloneable

管理用として公開される MBean 属性を記述します。このクラスのインスタンスは不変です。サブクラスは可変ですが、サブクラスの変更は推奨されていません。

導入されたバージョン:

1.5

関連項目:

直列化された形式

フィールドの概要

クラス javax.management.MBeanFeatureInfo から継承されたフィールド

description, name

コンストラクタの概要

MBeanAttributeInfo(String name, String description, Method getter, Method setter)
このコンストラクタは、単純な属性名と、属性の読み込みおよび書き込み用の Method オブジェクトを引数に取ります。

MBeanAttributeInfo(String name, String type, String description, boolean isReadable, boolean isWritable, boolean isIs)
MBeanAttributeInfo オブジェクトを構築します。

MBeanAttributeInfo(String name, String type, String description, boolean isReadable, boolean isWritable, boolean isIs, Descriptor descriptor)
MBeanAttributeInfo オブジェクトを構築します。

メソッドの概要

Object	clone() このインスタンスのシャローコピーを返します。
boolean	equals(Object o) この MBeanAttributeInfo を別の MBeanAttributeInfo と比較します。
String	getType() 属性のクラス名を返します。
int	hashCode() オブジェクトのハッシュコード値を返します。
boolean	isIs() この属性が is 取得メソッドを持つかどうかを示します。
boolean	isReadable() 属性値が読み取り可能かどうかを示します。
boolean	isWritable() 属性に新しい値を書き込めるかどうかを示します。
String	toString() オブジェクトの文字列表現を返します。

クラス javax.management.MBeanFeatureInfo から継承されたメソッド

getDescription, getDescriptor, getName

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

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

コンストラクタの詳細

MBeanAttributeInfo

public MBeanAttributeInfo(String name,
                          String type,
                          String description,
                          boolean isReadable,
                          boolean isWritable,
                          boolean isIs)

MBeanAttributeInfo オブジェクトを構築します。

パラメータ:

name - 属性の名前

type - 属性の型またはクラス名

description - 人間が読める形式の属性の説明

isReadable - 属性が取得メソッドを持つ場合は true、そうでない場合は false

isWritable - 属性が設定メソッドを持つ場合は true、そうでない場合は false

isIs - 属性が is 取得メソッドを持つ場合は true、そうでない場合は false

例外:

IllegalArgumentException - isIs が true であるが isReadable が false である場合、または isIs が true であり、 type が boolean でも java.lang.Boolean でもない場合 (新規コードでは、java.lang.Boolean ではなく boolean を常に使用する)

MBeanAttributeInfo

public MBeanAttributeInfo(String name,
                          String type,
                          String description,
                          boolean isReadable,
                          boolean isWritable,
                          boolean isIs,
                          Descriptor descriptor)

MBeanAttributeInfo オブジェクトを構築します。

パラメータ:

name - 属性の名前

type - 属性の型またはクラス名

description - 人間が読める形式の属性の説明

isReadable - 属性が取得メソッドを持つ場合は true、そうでない場合は false

isWritable - 属性が設定メソッドを持つ場合は true、そうでない場合は false

isIs - 属性が is 取得メソッドを持つ場合は true、そうでない場合は false

descriptor - 属性の記述子。null の場合があり、 これは空の記述子と同等

例外:

IllegalArgumentException - isIs が true であるが isReadable が false である場合、または isIs が true であり、 type が boolean でも java.lang.Boolean でもない場合 (新規コードでは、java.lang.Boolean ではなく boolean を常に使用する)

導入されたバージョン:

1.6

MBeanAttributeInfo

public MBeanAttributeInfo(String name,
                          String description,
                          Method getter,
                          Method setter)
                   throws IntrospectionException

このコンストラクタは、単純な属性名と、属性の読み込みおよび書き込み用の Method オブジェクトを引数に取ります。コンストラクタオブジェクトの Descriptor には、DescriptorKey メタ注釈を含む Method オブジェクト上の注釈が寄与するフィールドが含まれます。

パラメータ:

name - 属性のプログラム名

description - 人間が読める形式の属性の説明

getter - 属性値の読み込みに使用するメソッド。属性が書き込み専用の場合は null

setter - 属性値の書き込みに使用するメソッド。属性が読み取り専用の場合は null

例外:

IntrospectionException - この属性の定義に整合性の問題がある場合

メソッドの詳細

clone

public Object clone()

このインスタンスのシャローコピーを返します。このコピーは、super.clone() の呼び出し (Object.clone() によって実装されるデフォルトのネイティブシャローコピー機構の呼び出し) によって取得されます。内部フィールドについて、これ以上詳細なコピーは作成されません。

このクラスは不変なので、コピーは主にサブクラスにとって重要な処理となります。

オーバーライド:

クラス Object 内の clone

戻り値:

このインスタンスの複製

関連項目:

Cloneable

getType

public String getType()

属性のクラス名を返します。

戻り値:

クラス名

isReadable

public boolean isReadable()

属性値が読み取り可能かどうかを示します。

戻り値:

属性が読み取り可能な場合は true、そうでない場合は false

isWritable

public boolean isWritable()

属性に新しい値を書き込めるかどうかを示します。

戻り値:

属性が書き込み可能な場合は true、そうでない場合は false

isIs

public boolean isIs()

この属性が is 取得メソッドを持つかどうかを示します。

戻り値:

この属性が is 取得メソッドを持つ場合は true

toString

public String toString()

クラス Object の記述:

オブジェクトの文字列表現を返します。通常、toString メソッドはこのオブジェクトを「テキストで表現する」文字列を返します。この結果は、人間が読める簡潔で有益な情報であるべきです。すべてのサブクラスで、このメソッドをオーバーライドすることをお勧めします。

Object クラスの toString メソッドは、オブジェクトの派生元のクラス名、アットマーク (@)、およびオブジェクトのハッシュコードの符号なし 16 進表現から構成される文字列を返します。つまり、このメソッドは次の値と等しい文字列を返します。

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

オーバーライド:

クラス Object 内の toString

戻り値:

このオブジェクトの文字列表現

equals

public boolean equals(Object o)

この MBeanAttributeInfo を別の MBeanAttributeInfo と比較します。

オーバーライド:

クラス MBeanFeatureInfo 内の equals

パラメータ:

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

戻り値:

o が MBeanAttributeInfo であり、 その MBeanFeatureInfo.getName()、getType()、MBeanFeatureInfo.getDescription()、isReadable()、isWritable()、および isIs() の各値がこの MBeanAttributeInfo と同等 (同一である必要はない) の場合にだけ 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 プログラミング言語では不要です。

オーバーライド:

クラス MBeanFeatureInfo 内の hashCode

戻り値:

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

関連項目:

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