javax.management.openmbean
クラス CompositeDataSupport

java.lang.Object
  javax.management.openmbean.CompositeDataSupport

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

Serializable, CompositeData

public class CompositeDataSupport
extends Object
implements CompositeData, Serializable

CompositeDataSupport クラスは、CompositeData インタフェースを実装する「公開データ」クラスです。

導入されたバージョン:

1.5

関連項目:

直列化された形式

コンストラクタの概要

CompositeDataSupport(CompositeType compositeType, Map items)
指定された compositeType で CompositeDataSupport インスタンスを構築します。

CompositeDataSupport(CompositeType compositeType, String[] itemNames, Object[] itemValues)
指定された compositeType で CompositeDataSupport インスタンスを構築します。

メソッドの概要

boolean	containsKey(String key) この CompositeData インスタンスに key という名前の項目が含まれる場合に限り、true を返します。
boolean	containsValue(Object value) この CompositeData インスタンスに value という名前の項目が含まれる場合に限り、true を返します。
boolean	equals(Object obj) 指定された obj パラメータとこの CompositeDataSupport インスタンスが等しいかどうかを比較します。
Object	get(String key) key という名前の項目の値を返します。
Object[]	getAll(String[] keys) keys によって、keys と同じ順番で名前を指定された項目の値から成る配列を返します。
CompositeType	getCompositeType() この「複合データ」インスタンスの「複合型」を返します。
int	hashCode() この CompositeDataSupport インスタンスのハッシュコード値を返します。
String	toString() この CompositeDataSupport インスタンスの文字列表現を返します。
Collection	values() この CompositeData インスタンスに含まれる項目値の変更不能な Collection ビューを返します。

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

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

コンストラクタの詳細

CompositeDataSupport

public CompositeDataSupport(CompositeType compositeType,
                            String[] itemNames,
                            Object[] itemValues)
                     throws OpenDataException

指定された compositeType で CompositeDataSupport インスタンスを構築します。compositeType の項目の値は、itemValues[] によって、itemNames[] と同じ順番で指定されます。CompositeType はその項目の順番を指定しないので、itemValues[] に値を渡す順番の指定には itemNames[] パラメータが使用されます。この CompositeDataSupport インスタンスに含まれる項目は内部で TreeMap に格納されます。個々の項目は、値を高速で取得できるように、アルファベットの昇順でソートされます。

コンストラクタは、各パラメータが以下のすべての制約を満たしていることを確認し、満たされていない制約がある場合は適切な例外をスローします。

パラメータ:

compositeType - この「複合データ」インスタンスの「複合型」。null 以外

itemNames - itemNames は、compositeType に定義されたすべての項目名を任意の順番で並べる必要がある。この順番で itemValues[] 内の値のマッチングが行われる。null または空文字列以外

itemValues - 項目の値。itemNames 内の名前と同じ順番で並べる。項目の値は null であってもよいが、null でない場合、対応する項目の compositeType に定義された公開型に対して有効な値でなければならない。itemNames と同じサイズで、null または空文字列以外

例外:

IllegalArgumentException - compositeType が null の場合、itemNames[] または itemValues[] が null または空文字列の場合、itemNames[] 内に null または空の要素が含まれる場合、または itemNames[] と itemValues[] のサイズが異なる場合

OpenDataException - itemNames[] または itemValues[] のサイズが compositeType に定義された項目数と異なる場合、itemNames[] 内のいずれかの要素が compositeType に定義された項目名と一致していない場合、または itemValues[] 内のいずれかの要素が compositeType に定義されているように対応する項目に対して有効な値でない場合

CompositeDataSupport

public CompositeDataSupport(CompositeType compositeType,
                            Map items)
                     throws OpenDataException

指定された compositeType で CompositeDataSupport インスタンスを構築します。compositeType の項目名と対応する値は、マップ items 内のマッピングによって指定されます。このコンストラクタは、文字配列のキーと値をオブジェクト配列に変換し、CompositeDataSupport(javax.management.openmbean.CompositeType, java.lang.String[], java.lang.Object[]) を呼び出します。

パラメータ:

compositeType - この「複合データ」インスタンスの「複合型」。null 以外

items - すべての項目名とその値のマッピング。items には、compositeType に定義されたすべての項目名が含まれていなければならない。null または空文字列以外

例外:

IllegalArgumentException - compositeType が null の場合、items が null または空文字列の場合、items 内のいずれかのキーが null または空文字列の場合、または items のいずれかの値が null の場合

OpenDataException - items のサイズが compositeType に定義された項目数と異なる場合、items 内のいずれかのキーが compositeType に定義された項目名と一致していない場合、または items 内のいずれかの値が compositeType に定義されているように対応する項目に対して有効な値でない場合

ArrayStoreException - items 内の 1 つ以上のキーが java.lang.String クラスでない場合

メソッドの詳細

getCompositeType

public CompositeType getCompositeType()

この「複合データ」インスタンスの「複合型」を返します。

定義:

インタフェース CompositeData 内の getCompositeType

戻り値:

この CompositeData の型

get

public Object get(String key)

key という名前の項目の値を返します。

定義:

インタフェース CompositeData 内の get

パラメータ:

key - 項目の名前

戻り値:

このキーに関連した値

例外:

IllegalArgumentException - key が null または空の String の場合

InvalidKeyException - key がこの CompositeData インスタンスの既存の項目名でない場合

getAll

public Object[] getAll(String[] keys)

keys によって、keys と同じ順番で名前を指定された項目の値から成る配列を返します。

定義:

インタフェース CompositeData 内の getAll

パラメータ:

keys - 項目の名前

戻り値:

キーに対応する値

例外:

IllegalArgumentException - keys 内の要素が null または空の String の場合

InvalidKeyException - keys 内の要素がこの CompositeData インスタンスの既存の項目名でない場合

containsKey

public boolean containsKey(String key)

この CompositeData インスタンスに key という名前の項目が含まれる場合に限り、true を返します。key が null または空の String の場合、このメソッドは false を返します。

定義:

インタフェース CompositeData 内の containsKey

パラメータ:

key - 判定されるキー

戻り値:

この CompositeData にキーが含まれる場合は true

containsValue

public boolean containsValue(Object value)

この CompositeData インスタンスに value という名前の項目が含まれる場合に限り、true を返します。

定義:

インタフェース CompositeData 内の containsValue

パラメータ:

value - 判定される値

戻り値:

この CompositeData に値が含まれる場合は true

values

public Collection values()

この CompositeData インスタンスに含まれる項目値の変更不能な Collection ビューを返します。返されたコレクションの反復子は、対応する項目名の値をアルファベットの昇順で返します。

定義:

インタフェース CompositeData 内の values

戻り値:

値

equals

public boolean equals(Object obj)

指定された obj パラメータとこの CompositeDataSupport インスタンスが等しいかどうかを比較します。

次のすべての条件が満たされている場合に限り、true を返します。

• obj が null でない
• obj が CompositeData インタフェースを実装している
• 複合型が等しい
• 内容、すなわち名前と値のペアが等しい

これらの条件が満たされている場合、この equals メソッドは、CompositeData インタフェースの異なった実装である obj パラメータに対して正常に動作します。ただし、java.util.Collection インタフェースの equals メソッドの制約が課されます。

定義:

インタフェース CompositeData 内の equals

オーバーライド:

クラス Object 内の equals

パラメータ:

obj - この CompositeDataSupport インスタンスと等しいかどうかを比較するオブジェクト

戻り値:

指定されたオブジェクトがこの CompositeDataSupport インスタンスと等しい場合は true

関連項目:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

この CompositeDataSupport インスタンスのハッシュコード値を返します。

CompositeDataSupport インスタンスのハッシュコードは、equals の比較で使用されたすべての情報要素 (「複合型」とすべての項目値) のハッシュコードの合計です。

これにより、Object.hashCode() メソッドの一般規約によって要求される、任意の 2 つの CompositeDataSupport インスタンス t1 と t2 で、t1.equals(t2) であれば t1.hashCode()==t2.hashCode() となることが保証されます。

CompositeData インタフェースを実装する別のクラスインスタンスが、equals(java.lang.Object) で定義されているように、この CompositeDataSupport インスタンスと等しくなる場合もあります。しかし、計算方法が異なっているため、ハッシュコードも異なっている可能性があります。

定義:

インタフェース CompositeData 内の hashCode

オーバーライド:

クラス Object 内の hashCode

戻り値:

この CompositeDataSupport インスタンスのハッシュコード値

関連項目:

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

toString

public String toString()

この CompositeDataSupport インスタンスの文字列表現を返します。

この文字列表現は、このクラス (javax.management.openmbean.CompositeDataSupport) の名前、このインタフェースの複合型の文字列表現、および内容 (itemName=itemValue のマッピングのリスト) の文字列表現で構成されます。

定義:

インタフェース CompositeData 内の toString

オーバーライド:

クラス Object 内の toString

戻り値:

この CompositeDataSupport インスタンスの文字列表現