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」getter を持つかどうかを示します。
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 - 属性が getter メソッドを持つ場合は true、そうでない場合は false。

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

isIs - 属性が「is」getter を持つ場合は 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 - 属性が getter メソッドを持つ場合は true、そうでない場合は false。

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

isIs - 属性が「is」getter を持つ場合は 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() によって実装されるデフォルトのネイティブシャローコピーメカニズムの呼び出し) によって取得されます。内部フィールドについて、これ以上詳細なコピーは作成されません。

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

オーバーライド:

clone、クラス: Object

戻り値:

このインスタンスの複製。

関連項目:

Cloneable

getType

public String getType()

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

戻り値:

クラス名。

isReadable

public boolean isReadable()

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

戻り値:

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

isWritable

public boolean isWritable()

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

戻り値:

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

isIs

public boolean isIs()

この属性が「is」getter を持つかどうかを示します。

戻り値:

この属性が「is」getter を持つ場合は true。

toString

public String toString()

クラスからコピーされた説明: Object

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

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

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

オーバーライド:

toString、クラス: Object

戻り値:

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

equals

public boolean equals(Object o)

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

オーバーライド:

equals、クラス: MBeanFeatureInfo

パラメータ:

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

戻り値:

o が MBeanAttributeInfo であり、その MBeanFeatureInfo.getName()、getType()、MBeanFeatureInfo.getDescription()、isReadable()、isWritable()、および isIs() の各値がこの MBeanAttributeInfo と同等 (同一である必要はない) の場合にだけ true。

関連項目:

Object.hashCode()、HashMap

hashCode

public int hashCode()

クラスからコピーされた説明: Object

オブジェクトのハッシュコード値を返します。このメソッドは、HashMap によって提供されるハッシュテーブルなどの、ハッシュテーブルの利点のためにサポートされています。

hashCode の一般的な規則は次のとおりです。

• Java アプリケーションの実行中に同じオブジェクトに対して複数回呼び出された場合は常に、このオブジェクトに対する equals の比較で使用される情報が変更されていなければ、hashCode メソッドは常に同じ整数を返す必要があります。ただし、この整数は同じアプリケーションの実行ごとに同じである必要はありません。
• equals(Object) メソッドに従って 2 つのオブジェクトが等しい場合は、2 つの各オブジェクトに対する hashCode メソッドの呼び出しによって同じ整数の結果が生成される必要があります。
• Object.equals(java.lang.Object) メソッドに従って 2 つのオブジェクトが等しくない場合は、2 つの各オブジェクトに対する hashCode メソッドの呼び出しによって異なる整数の結果が生成される必要はありません。ただし、プログラマは、等しくないオブジェクトに対して異なる整数の結果を生成すると、ハッシュテーブルのパフォーマンスが向上する場合があることに気付くはずです。

クラス Object によって定義された hashCode メソッドは、可能なかぎり、異なるオブジェクトに対して異なる整数を返します。(これは通常、オブジェクトの内部アドレスを整数に変換することによって実装されますが、この実装テクニックは Java^TM プログラミング言語では必要ありません。)

オーバーライド:

hashCode、クラス: MBeanFeatureInfo

戻り値:

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

関連項目:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)