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 を返します。

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

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

オーバーライド:

equals、クラス: Object

パラメータ:

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

戻り値:

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

関連項目:

Object.hashCode()、HashMap

hashCode

int hashCode()

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

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

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

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

オーバーライド:

hashCode、クラス: Object

戻り値:

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

関連項目:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

String toString()

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

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

オーバーライド:

toString、クラス: Object

戻り値:

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