JavaTM Platform
Standard Ed. 6

javax.management.openmbean
インタフェース CompositeData

既知の実装クラスの一覧:
CompositeDataSupport

public interface CompositeData

CompositeData インタフェースは、「複合データ」構造を表現する特定の型の複合「公開データ」オブジェクトの動作を指定します。

導入されたバージョン:
1.5

メソッドの概要
 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 を返します。

これらの条件が満たされている場合、この 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 インスタンス t1t2 で、t1.equals(t2) であれば t1.hashCode()==t2.hashCode() となることが保証されます。

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

オーバーライド:
クラス Object 内の hashCode
戻り値:
この CompositeData インスタンスのハッシュコード値
関連項目:
Object.equals(java.lang.Object), Hashtable

toString

String toString()
この CompositeData インスタンスの文字列表現を返します。

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

オーバーライド:
クラス Object 内の toString
戻り値:
この CompositeData インスタンスの文字列表現

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。