模块 java.management
包 javax.management.openmbean

接口 TabularData

所有已知的实现类：
TabularDataSupport
public interface TabularData
TabularData 接口指定了特定类型的复合体的行为开放数据代表的对象表格数据结构。
自从：
1.5

  • 方法总结

    修饰符和类型
    方法
    描述
    Object[]
    calculateIndex(CompositeData value)
    计算将在此 TabularData 实例中使用的索引以引用指定的复合数据value参数，如果它被添加到这个实例。
    void
    clear()
    从此 TabularData 实例中删除所有 CompositeData 值（即行）。
    boolean
    containsKey(Object[] key)
    当且仅当此 TabularData 实例包含索引为指定的 CompositeData 值（即一行）时，返回 truekey.
    boolean
    containsValue(CompositeData value)
    当且仅当此 TabularData 实例包含指定的 CompositeData 值时，返回 true。
    boolean
    equals(Object obj)
    比较指定的对象参数与此 TabularData 实例相等。
    CompositeData
    get(Object[] key)
    返回索引为的CompositeData值key或 null 如果没有值映射到key，在这个 TabularData 实例中。
    TabularType
    getTabularType()
    返回表格类型描述这个 TabularData 实例。
    int
    hashCode()
    返回此 TabularData 实例的哈希码值。
    boolean
    isEmpty()
    如果此 TabularData 实例中包含的 CompositeData 值的数量（即行数）为零，则返回 true。
    Set<?>
    keySet()
    返回此 TabularData 实例中包含的 CompositeData 值（即行）的键（即索引值）的集合视图。
    void
    put(CompositeData value)
    添加value到这个 TabularData 实例。
    void
    putAll(CompositeData[] values)
    添加所有元素values到这个 TabularData 实例。
    CompositeData
    remove(Object[] key)
    删除索引为的 CompositeData 值key来自这个 TabularData 实例，并返回移除的值，或者如果没有索引为的值则返回 nullkey.
    int
    size()
    返回此 TabularData 实例中包含的 CompositeData 值的数量（即行数）。
    String
    toString()
    返回此 TabularData 实例的字符串表示形式。
    Collection<?>
    values()
    返回此 TabularData 实例中包含的 CompositeData 值（即行）的集合视图。

  • 方法详情

    • getTabularType

      TabularType  getTabularType()
      返回表格类型描述这个 TabularData 实例。
      返回：
      表格类型。

    • calculateIndex

      Object [] calculateIndex(CompositeData  value)
      计算将在此 TabularData 实例中使用的索引以引用指定的复合数据value参数，如果它被添加到这个实例。此方法检查指定的类型有效性value, 但不检查计算的索引是否已用于引用此 TabularData 实例中的值。
      参数：
      value - 要计算其在此 TabularData 实例中的索引的复合数据值；必须与此实例的行类型具有相同的复合类型；不得为空。
      返回：
      指定的索引value在这个 TabularData 实例中会有。
      抛出：
      NullPointerException - 如果value是null
      InvalidOpenTypeException - 如果value不符合此 TabularData 实例的行类型定义。

    • size

      int size()
      返回此 TabularData 实例中包含的 CompositeData 值的数量（即行数）。
      返回：
      包含的值的数量。

    • isEmpty

      boolean isEmpty()
      如果此 TabularData 实例中包含的 CompositeData 值的数量（即行数）为零，则返回 true。
      返回：
      如果此 TabularData 为空，则为真。

    • containsKey

      boolean containsKey(Object [] key)
      当且仅当此 TabularData 实例包含索引为指定的 CompositeData 值（即一行）时，返回 truekey.如果key是 null 或不符合此 TabularData 实例的 TabularType 定义，此方法仅返回 false 。
      参数：
      key - 要测试其在此 TabularData 实例中是否存在的索引值。
      返回：
      true 如果此 TabularData 使用指定键索引行值。

    • containsValue

      boolean containsValue(CompositeData  value)
      当且仅当此 TabularData 实例包含指定的 CompositeData 值时，返回 true。如果value是 null 或不符合此 TabularData 实例的行类型定义，此方法仅返回 false 。
      参数：
      value - 要测试其在此 TabularData 实例中是否存在的行值。
      返回：
      true 如果此 TabularData 实例包含指定的行值。

    • get

      CompositeData  get(Object [] key)
      返回索引为的CompositeData值key或 null 如果没有值映射到key，在这个 TabularData 实例中。
      参数：
      key - 要返回的行的键。
      返回：
      对应的值key.
      抛出：
      NullPointerException - 如果key是null
      InvalidKeyException - 如果key不符合这个 TabularData 实例的 * TabularType 定义

    • put

      void put(CompositeData  value)
      添加value到这个 TabularData 实例。的复合类型value必须与此实例的行类型相同（即 this.getTabularType().getRowType() 返回的复合类型），并且此 TabularData 实例中不得已经存在其索引与为计算的索引相同的值value待补充。该索引为value根据此 TabularData 实例的 TabularType 定义计算（参见 TabularType.getIndexNames() ）。
      参数：
      value - 要作为新行添加到此 TabularData 实例的复合数据值；必须与此实例的行类型具有相同的复合类型；不得为空。
      抛出：
      NullPointerException - 如果value是null
      InvalidOpenTypeException - 如果value不符合此 TabularData 实例的行类型定义。
      KeyAlreadyExistsException - 如果索引为value，根据此 TabularData 实例的 TabularType 定义计算已映射到底层 HashMap 中的现有值。

    • remove

      CompositeData  remove(Object [] key)
      删除索引为的 CompositeData 值key来自这个 TabularData 实例，并返回移除的值，或者如果没有索引为的值则返回 nullkey.
      参数：
      key - 要在此 TabularData 实例中获取的值的索引；必须对此 TabularData 实例的行类型定义有效；不得为空。
      返回：
      与指定键相关联的先前值，或者 null 如果没有键的映射。
      抛出：
      NullPointerException - 如果key是null
      InvalidKeyException - 如果key不符合这个 TabularData 实例的 TabularType 定义

    • putAll

      void putAll(CompositeData [] values)
      添加所有元素values到这个 TabularData 实例。如果任何元素在values不满足 put 中定义的约束，或者如果任何两个元素values具有根据此 TabularData 实例的 TabularType 定义计算的相同索引，然后抛出描述失败的异常并且没有元素values被添加，从而使这个 TabularData 实例保持不变。
      参数：
      values - 要作为新行添加到此 TabularData 实例的复合数据值数组；如果values为 null 或为空，此方法不执行任何操作返回。
      抛出：
      NullPointerException - 如果元素values是null
      InvalidOpenTypeException - 如果元素values不符合此 TabularData 实例的行类型定义
      KeyAlreadyExistsException - 如果一个元素的索引values，根据这个 TabularData 实例的 TabularType 定义计算已经映射到这个实例中的现有值，或者两个元素values有相同的索引。

    • clear

      void clear()
      从此 TabularData 实例中删除所有 CompositeData 值（即行）。

    • keySet

      Set <?> keySet()
      返回此 TabularData 实例中包含的 CompositeData 值（即行）的键（即索引值）的集合视图。返回的 Set 是 Set<List<?>> 但出于兼容性原因被声明为 Set<?>。返回的集合可用于迭代键。
      返回：
      此 TabularData 实例中使用的索引值的集合视图 (Set<List<?>>)。

    • values

      Collection <?> values()
      返回此 TabularData 实例中包含的 CompositeData 值（即行）的集合视图。返回的 Collection 是 Collection<CompositeData> 但出于兼容性原因被声明为 Collection<?>。返回的集合可用于迭代值。
      返回：
      此 TabularData 实例中包含的行的集合视图 (Collection<CompositeData>)。

    • equals

      boolean equals(Object  obj)
      比较指定的对象参数与此 TabularData 实例相等。

      当且仅当以下所有陈述都为真时，返回 true：

      • 对象非空，
      • 对象还实现了TabularData接口，
      • 他们的行类型相等
      • 它们的内容（即索引到值的映射）相等
      这可确保此 equals 方法适用于对象参数是TabularData接口的不同实现。
       
      重写：
      equals 在类 Object 中
      参数：
      obj - 要与此 TabularData 实例进行相等比较的对象；
      返回：
      true 如果指定对象等于此 TabularData 实例。
      参见：

    • hashCode

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

      TabularData 实例的哈希码是 equals 比较中使用的所有信息元素的哈希码的总和（即：其表格类型及其内容，其中内容定义为所有索引到值的映射）。

      这确保 t1.equals(t2) 暗示 t1.hashCode()==t2.hashCode() 对于任何两个 TabularDataSupport 实例 t1 和 t2，正如方法 Object.hashCode() 的一般契约所要求的那样。

      重写：
      hashCode 在类 Object 中
      返回：
      此 TabularDataSupport 实例的哈希码值
      参见：

    • toString

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

      字符串表示形式由实现类的名称和此实例的表格类型组成。

      重写：
      toString 在类 Object 中
      返回：
      此 TabularData 实例的字符串表示形式