- 既知のすべての実装クラス:
CompositeDataSupport
,GcInfo
public interface CompositeData
CompositeData
インタフェースは、「複合データ」構造を表す特定のタイプの複合「オープン・データ」オブジェクトの動作を指定します。- 導入されたバージョン:
- 1.5
-
メソッドのサマリー
修飾子と型メソッド説明boolean
containsKey
(String key) このCompositeData
インスタンスにkey
という名前のアイテムが含まれている場合にのみ、true
を返します。boolean
containsValue
(Object value) このCompositeData
インスタンスに、値がvalue
のアイテムが含まれている場合のみ、true
を返します。boolean
指定されたobjパラメータとこのCompositeData
インスタンスが等しいかどうかを比較します。名前がkey
のアイテムの値を返します。Object[]
keys
で指定された名前を持つアイテムの値の配列を、keys
と同じ順序で返します。この複合データ・インスタンスの複合型を返します。int
hashCode()
このCompositeData
インスタンスのハッシュ・コード値を返します。toString()
このCompositeData
インスタンスの文字列表現を返します。Collection
<?> values()
このCompositeData
インスタンスに含まれるアイテム値の変更不可能なコレクション・ビューを返します。
-
メソッドの詳細
-
getCompositeType
CompositeType getCompositeType()この複合データ・インスタンスの複合型を返します。- 戻り値:
- このCompositeDataの型。
-
get
名前がkey
のアイテムの値を返します。- パラメータ:
key
- 項目の名前。- 戻り値:
- このキーに関連した値。
- 例外:
IllegalArgumentException
-key
がnullまたは空の文字列の場合。InvalidKeyException
-key
がこのCompositeData
インスタンスの既存のアイテム名でない場合。
-
getAll
keys
で指定された名前を持つアイテムの値の配列を、keys
と同じ順序で返します。- パラメータ:
keys
- 項目の名前。- 戻り値:
- キーに対応する値。
- 例外:
IllegalArgumentException
-keys
の要素がnullまたは空の文字列である場合。InvalidKeyException
-keys
の要素がこのCompositeData
インスタンスの既存のアイテム名でない場合。
-
containsKey
boolean containsKey(String key) このCompositeData
インスタンスにkey
という名前のアイテムが含まれている場合にのみ、true
を返します。key
がnullまたは空の文字列の場合、このメソッドは単にfalseを返します。- パラメータ:
key
- 判定されるキー。- 戻り値:
- この
CompositeData
にキーが含まれている場合はtrue。
-
containsValue
boolean containsValue(Object value) このCompositeData
インスタンスに、値がvalue
のアイテムが含まれている場合のみ、true
を返します。- パラメータ:
value
- 判定される値。- 戻り値:
- この
CompositeData
に値が含まれている場合はtrue。
-
values
Collection<?> values()このCompositeData
インスタンスに含まれるアイテム値の変更不可能なコレクション・ビューを返します。 返されたコレクションのイテレータは、対応する項目名の値をアルファベットの昇順で返します。- 戻り値:
- 値
-
equals
boolean equals(Object obj) 指定されたobjパラメータとこのCompositeData
インスタンスが等しいかどうかを比較します。次のすべての条件が満たされている場合に限り、
true
を返します。- objがnullでない
- objが
CompositeData
インタフェースも実装している - 複合型が等しい
- 内容、すなわち名前と値のペアが等しい。 内容に含まれる値が配列である場合、オブジェクト参照型の配列に対して
deepEquals
メソッドを呼び出すか、またはプリミティブ型の配列に対してArrays.equals(e1,e2)
の適切なオーバーロードを呼び出すのと同様に、値の比較が実行されます
これにより、この
equals
メソッドは、CompositeData
インタフェースの異なる実装であるobjパラメータに対して正しく機能し、java.util.Collection
インタフェースのequals
メソッドに示されている制限があります。 -
hashCode
int hashCode()このCompositeData
インスタンスのハッシュ・コード値を返します。CompositeData
インスタンスのハッシュ・コードは、equals
の比較で使用されるすべての情報要素(複合型およびすべての項目値)のハッシュ・コードの合計です。これにより、
Object.hashCode()
メソッドの一般規約によって要求される、任意の2つのCompositeData
インスタンスt1
とt2
で、t1.equals(t2)
であればt1.hashCode()==t2.hashCode()
となることが保証されます。各項目値のハッシュ・コードは、返されたハッシュ・コードに追加されます。 項目値が配列である場合、オブジェクト参照型の配列に対して
deepHashCode
メソッドを呼び出すか、またはプリミティブ型の配列に対してArrays.hashCode(e)
の適切なオーバーロードを呼び出すのと同様に、値の比較が実行されます。 -
toString
String toString()このCompositeData
インスタンスの文字列表現を返します。この文字列表現は、実装クラスの名前、このインタフェースの複合型の文字列表現、および内容(itemName=itemValueのマッピングのリスト)の文字列表現で構成されます。
-