模块  java.management
软件包  javax.management.openmbean

Interface CompositeData

  • 所有已知实现类：
    CompositeDataSupport ， GcInfo 
    public interface CompositeData
    CompositeData接口指定表示 复合数据结构的特定类型的复杂 开放数据对象的行为。
    从以下版本开始：
    1.5

    • 方法摘要

      所有方法  实例方法 抽象方法 
      变量和类型 方法 描述
      boolean containsKey​(String key)
      返回 true当且仅当此 CompositeData实例包含名称是项目 key 。
      boolean containsValue​(Object value)
      返回 true当且仅当此 CompositeData实例包含其值是一个项目 value 。
      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是空字符串或空字符串。
        InvalidKeyException - 如果 key不是此 CompositeData实例的现有项目名称。

      • getAll

        Object[] getAll​(String[] keys)
        返回其名称由 keys指定的项的值的数组，顺序与 keys相同。
        参数
        keys - 项目的名称。
        结果
        与键对应的值。
        异常
        IllegalArgumentException -如果在元件 keys为空或空字符串。
        InvalidKeyException -如果一个元素 keys不是这个现有项目的名称 CompositeData实例。

      • containsKey

        boolean containsKey​(String key)
        返回true当且仅当此CompositeData实例包含名称是项目key 。 如果key是null或空String，则此方法只返回false。
        参数
        key - 要测试的密钥。
        结果
        如果此 CompositeData包含密钥，则 CompositeData true。

      • containsValue

        boolean containsValue​(Object value)
        返回 true当且仅当此 CompositeData实例包含其值是一个项目 value 。
        参数
        value - 要测试的值。
        结果
        如果此 CompositeData包含值，则 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方法正常工作对作为不同实现的obj参数CompositeData接口，具有在所提到的限制equals所述的方法java.util.Collection接口。

        重写：
        equals在类 Object
        参数
        obj - 要与此 CompositeData实例进行相等性比较的对象。
        结果
        true如果指定的对象等于此 CompositeData实例。
        另请参见：
        Object.hashCode() ， HashMap

      • hashCode

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

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

        这确保了t1.equals(t2)意味着t1.hashCode()==t2.hashCode()对于任何两个CompositeData实例t1和t2 ，所要求的方法的常规合同Object.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实例的字符串表示形式