インタフェースCompositeData

既知のすべての実装クラス:
CompositeDataSupport, GcInfo
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インスタンスに含まれるアイテム値の変更不可能なコレクション・ビューを返します。

  • メソッドの詳細

    • getCompositeType

      CompositeType getCompositeType()
      この複合データ・インスタンスの複合型を返します。
      戻り値:
      このCompositeDataの型。

    • get

      Object get(String key)
      名前がkeyのアイテムの値を返します。
      パラメータ:
      key - 項目の名前。
      戻り値:
      このキーに関連した値。
      スロー:
      IllegalArgumentException - keyがnullまたは空の文字列の場合。
      InvalidKeyException - keyがこのCompositeDataインスタンスの既存のアイテム名でない場合。

    • getAll

      Object[] getAll(String[] keys)
      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メソッドに示されている制限があります。

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

    • 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インスタンスのハッシュ・コード値
      関連項目:

    • toString

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

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

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