CompositeDataSupport (Java Platform SE 6)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM Platform
Standard Ed. 6

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

javax.management.openmbean
クラス CompositeDataSupport

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

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

public class CompositeDataSupport
extends Object
implements CompositeData, Serializable
extends Object
implements CompositeData, Serializable

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

導入されたバージョン:: 1.5
関連項目:: 直列化された形式

コンストラクタの概要
`CompositeDataSupport(CompositeType compositeType, Map<String,?> 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<String,?> 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 または空の文字列である場合; 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 インタフェースを実装している。
複合型が等しい。
内容、すなわち名前と値のペアが等しい。内容に含まれる値が配列である場合、オブジェクト参照型の配列に対して deepEquals メソッドを呼び出すか、またはプリミティブ型の配列に対して Arrays.equals(e1,e2) の適切なオーバーロードを呼び出すのと同様に、値の比較が実行されます。

これらの条件が満たされている場合、この 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() となることが保証されます。

各項目値のハッシュコードは、返されたハッシュコードに追加されます。項目値が配列である場合、オブジェクト参照型の配列に対して deepHashCode メソッドを呼び出すか、またはプリミティブ型の配列に対して Arrays.hashCode(e) の適切なオーバーロードを呼び出すのと同様に、値の比較が実行されます。