Module java.management
Package javax.management.openmbean

Interface CompositeData

所有已知的实现类:
CompositeDataSupport, GcInfo
public interface CompositeData
CompositeData接口指定了一种特定类型的复杂开放数据对象的行为，这些对象代表复合数据结构。
自:
1.5

  • Method Summary

    Modifier and Type
    Method
    Description
    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实例中包含的项值的不可修改的集合视图。

  • Method Details

    • 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)重载来进行。

      这确保了对于CompositeData接口的不同实现的obj参数，此equals方法可以正常工作，但受到java.util.Collection接口的equals方法中提到的限制。

      覆盖:
      equals 在类 Object
      参数:
      obj - 与此CompositeData实例比较是否相等的对象。
      返回:
      如果指定的对象等于此CompositeData实例，则返回true。
      参见:

    • hashCode

      int hashCode()
      返回此CompositeData实例的哈希码值。

      CompositeData实例的哈希码是用于equals比较的所有信息元素的哈希码之和（即：其复合类型和所有项值）。

      这确保了对于任何两个CompositeData实例t1和t2，如果t1.equals(t2)，则t1.hashCode()==t2.hashCode()，这是Object.hashCode()方法的一般契约所要求的。

      每个项值的哈希码将添加到返回的哈希码中。如果项值是数组，则其哈希码将按照调用对象引用类型数组的deepHashCode方法或适当的Arrays.hashCode(e)重载来获取。

      覆盖:
      hashCode 在类 Object
      返回:
      此CompositeData实例的哈希码值
      参见:

    • toString

      String toString()
      返回此CompositeData实例的字符串表示形式。

      字符串表示形式包括实现类的名称，此实例的复合类型的字符串表示形式，以及内容的字符串表示形式（即列出itemName=itemValue映射）。

      覆盖:
      toString 在类 Object
      返回:
      此CompositeData实例的字符串表示形式