CompositeData (Java Platform SE 6)

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

メソッドの詳細

getCompositeType

CompositeType getCompositeType()

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

戻り値:: この CompositeData の型

get

Object get(String key)

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

パラメータ:: key - 項目の名前
戻り値:: このキーに関連した値
例外:: IllegalArgumentException - key が null または空の String の場合; InvalidKeyException - key がこの CompositeData インスタンスの既存の項目名でない場合

getAll

Object[] getAll(String[] keys)

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

パラメータ:: keys - 項目の名前
戻り値:: キーに対応する値
例外:: IllegalArgumentException - keys 内の要素が null または空の String の場合; InvalidKeyException - keys 内の要素がこの CompositeData インスタンスの既存の項目名でない場合

containsKey

boolean containsKey(String key)

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

パラメータ:: key - 判定されるキー
戻り値:: この CompositeData にキーが含まれる場合は true

containsValue

boolean containsValue(Object value)

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

パラメータ:: value - 判定される値
戻り値:: この CompositeData に値が含まれる場合は true

values

Collection<?> values()

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

戻り値:: 値

equals

boolean equals(Object obj)

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

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

obj が null でない
obj が CompositeData インタフェースを実装している。
複合型が等しい。
内容、すなわち名前と値のペアが等しい。内容に含まれる値が配列である場合、オブジェクト参照型の配列に対して deepEquals メソッドを呼び出すか、またはプリミティブ型の配列に対して Arrays.equals(e1,e2) の適切なオーバーロードを呼び出すのと同様に、値の比較が実行されます。

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

オーバーライド:: クラス Object 内の equals

パラメータ:: obj - この CompositeData インスタンスと等しいかどうかを比較するオブジェクト
戻り値:: 指定されたオブジェクトがこの CompositeData インスタンスと等しい場合は true
関連項目:: Object.hashCode(), Hashtable

hashCode

int hashCode()

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

CompositeData インスタンスのハッシュコードは、equals の比較で使用されるすべての情報要素 (複合型およびすべての項目値) のハッシュコードの合計です。

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

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