TabularDataSupport (Java Platform SE 8 )

java.lang.Object
- javax.management.openmbean.TabularDataSupport

All Implemented Interfaces:

Serializable ， Cloneable ， Map < Object ， Object >， TabularData
```
public class TabularDataSupport
extends Object
implements TabularData, Map<Object,Object>, Cloneable, Serializable
```
TabularDataSupport类是 开放数据类，它实现了 TabularData和 Map接口，内部基于哈希映射数据结构。

从以下版本开始：

1.5

另请参见：

Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from interface java.util.Map
  Map.Entry<K,V>

构造方法摘要

构造方法
Constructor and Description
`TabularDataSupport(TabularType tabularType)` 创建一个空的 `TabularDataSupport`实例，其开放类型为 `tabularType` ，其底层 `HashMap`具有默认初始容量（101）和默认负载因子（0.75）。
`TabularDataSupport(TabularType tabularType, int initialCapacity, float loadFactor)` 创建一个空的 `TabularDataSupport`实例，其open-type为 `tabularType` ，其底层 `HashMap`具有指定的初始容量和负载因子。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Object[]`	`calculateIndex(CompositeData value)` 计算将在此 `TabularData`实例中使用的索引，以引用指定的复合数据 `值`参数（如果已添加到此实例）。
`void`	`clear()` 从此 `TabularDataSupport`实例中删除所有行。
`Object`	`clone()` 返回此 `TabularDataSupport`实例的克隆：克隆通过调用 `super.clone()获取` ，然后克隆底层映射。
`boolean`	`containsKey(Object key)` 返回 `true`当且仅当此 `TabularData`实例包含索引为指定 `键`的 `CompositeData`值（即一行）时。
`boolean`	`containsKey(Object[] key)` 返回 `true`当且仅当此 `TabularData`实例包含一个 `CompositeData`值（即一行），其索引是指定的 `键` 。
`boolean`	`containsValue(CompositeData value)` 返回 `true`当且仅当此 `TabularData`实例包含指定的 `CompositeData`值时。
`boolean`	`containsValue(Object value)` 当且仅当此 `TabularData`实例包含指定值时返回 `true` 。
`Set<Map.Entry<Object,Object>>`	`entrySet()` 返回此 `TabularDataSupport`实例中 `TabularDataSupport`行映射索引的集合视图。
`boolean`	`equals(Object obj)` 将指定的 `obj`参数与此 `TabularDataSupport`实例进行比较以获得相等性。
`Object`	`get(Object key)` 这种方法只需调用 `get((Object[]) key)` 。
`CompositeData`	`get(Object[] key)` 返回 `CompositeData`值，其指数是 `关键` ，或 `null`如果没有值映射到 `按键` ，在此 `TabularData`实例。
`TabularType`	`getTabularType()` 返回描述此 `TabularData`实例的表格类型。
`int`	`hashCode()` 返回此 `TabularDataSupport`实例的哈希码值。
`boolean`	`isEmpty()` 如果此 `TabularDataSupport`实例不包含任何行，则返回 `true` 。
`Set<Object>`	`keySet()` 返回用于对行进行索引的此 `TabularDataSupport`实例的底层映射中包含的键的集视图。
`void`	`put(CompositeData value)` 为此 `TabularData`实例添加 `值` 。
`Object`	`put(Object key, Object value)` 该方法简单地调用 `put((CompositeData) value)` ，因此忽略其 `关键`参数，可以是 `null` 。
`void`	`putAll(CompositeData[] values)` 将 `值`中的所有元素添加到此 `TabularData`实例。
`void`	`putAll(Map<?,?> t)` 将指定映射 `t`中包含的所有值添加到此 `TabularData`实例中。
`Object`	`remove(Object key)` 这种方法只需调用 `remove((Object[]) key)` 。
`CompositeData`	`remove(Object[] key)` 从此 `TabularData`实例中删除其索引为 `关键字`的 `CompositeData`值，并返回删除的值，如果没有索引为 `键的`值，则返回 `null` 。
`int`	`size()` 返回此 `TabularDataSupport`实例中的行数。
`String`	`toString()` 返回此 `TabularDataSupport`实例的字符串表示形式。
`Collection<Object>`	`values()` 返回此 `TabularDataSupport`实例中包含的行的集合视图。

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map
compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

- 构造方法详细信息
  - TabularDataSupport
```
public TabularDataSupport(TabularType tabularType)
```
    创建一个空的TabularDataSupport实例，其开放类型为tabularType ，其底层HashMap具有默认初始容量（101）和默认负载因子（0.75）。
    这个构造函数只需调用this(tabularType, 101, 0.75f);
    
    参数
    
    tabularType - 描述这个TabularData实例的表格类型 ; 不能为空。
    
    异常
    
    IllegalArgumentException - 如果表格类型为空。
  - TabularDataSupport
```
public TabularDataSupport(TabularType tabularType,
                          int initialCapacity,
                          float loadFactor)
```
    创建一个空的 TabularDataSupport实例，其open-type是 tabularType ，其底层 HashMap具有指定的初始容量和负载因子。
    
    参数
    
    tabularType - 描述这个TabularData实例的表格类型 ; 不能为空。
    
    initialCapacity - HashMap的初始容量。
    
    loadFactor - HashMap的负载因子
    
    异常
    
    IllegalArgumentException - 如果初始容量小于零，或负载因子为非正性，或表格类型为空。
- 方法详细信息
  - getTabularType
```
public TabularType getTabularType()
```
    返回描述此 TabularData实例的 表格类型 。
    
    Specified by:
    
    getTabularType在接口 TabularData
    
    结果
    
    表格类型。
  - calculateIndex
```
public Object[] calculateIndex(CompositeData value)
```
    计算将在此TabularData实例中使用的索引，以引用指定的复合数据值参数（如果已添加到此实例）。此方法检查指定值的类型有效性，但不检查计算的索引是否已用于引用此TabularData实例中的值。
    
    Specified by:
    
    calculateIndex在接口 TabularData
    
    参数
    
    value - 要计算此TabularData实例中的索引的复合数据值; 必须与此实例的行类型具有相同的复合类型; 不能为空。
    
    结果
    
    该指定 值在该 TabularData实例中具有的索引。
    
    异常
    
    NullPointerException - 如果 值为 null 。
    
    InvalidOpenTypeException - 如果 值不符合这个 TabularData实例的行类型定义。
  - containsKey
```
public boolean containsKey(Object key)
```
    返回true当且仅当此TabularData实例包含CompositeData值（即行），其指数为指定的键 。如果键不能被转换为Object实例的一维数组，则此方法只返回false ; 否则返回到this.containsKey((Object[]) key)的调用结果。
    
    Specified by:
    
    containsKey在接口 Map<Object,Object>
    
    参数
    
    key - 要测试其在此 TabularData实例中的索引值。
    
    结果
    
    true如果这 TabularData用指定的键索引行值。
  - containsKey
```
public boolean containsKey(Object[] key)
```
    返回true当且仅当此TabularData实例包含CompositeData值（即行），其指数为指定的键 。如果key是null或者不符合这个TabularData实例的TabularType定义，这个方法只需返回false 。
    
    Specified by:
    
    containsKey中的 TabularData
    
    参数
    
    key - 要测试其在此 TabularData实例中的索引值。
    
    结果
    
    true如果这个 TabularData用指定的键索引行值。
  - containsValue
```
public boolean containsValue(CompositeData value)
```
    当且仅当此TabularData实例包含指定的CompositeData值时返回true 。如果值为 null或不符合此TabularData实例的行类型定义，则此方法只返回false 。
    
    Specified by:
    
    containsValue在接口 TabularData
    
    参数
    
    value - 要测试其在此 TabularData实例中的行值。
    
    结果
    
    true如果这个 TabularData实例包含指定的行值。
  - containsValue
```
public boolean containsValue(Object value)
```
    当且仅当此 TabularData实例包含指定的值时返回 true 。
    
    Specified by:
    
    containsValue在接口 Map<Object,Object>
    
    参数
    
    value - 要测试其在此 TabularData实例中的行值。
    
    结果
    
    true如果这个 TabularData实例包含指定的行值。
  - get
```
public Object get(Object key)
```
    这个方法只需调用 get((Object[]) key) 。
    
    Specified by:
    
    get在接口 Map<Object,Object>
    
    参数
    
    key - 要返回其关联值的键
    
    结果
    
    指定键映射到的值，如果此映射不包含键的映射， null
    
    异常
    
    NullPointerException - 如果 密钥是 null
    
    ClassCastException - 如果 键不是类型 Object[]
    
    InvalidKeyException - 如果 密钥不符合这个 TabularData实例的 TabularType定义
  - get
```
public CompositeData get(Object[] key)
```
    返回 CompositeData值，其指数是 关键 ，或 null如果没有值映射到 按键 ，在此 TabularData实例。
    
    Specified by:
    
    get在接口 TabularData
    
    参数
    
    key - 在这个TabularData实例中获取的值的索引; *必须与此TabularData实例的行类型定义一致; *不能为空。
    
    结果
    
    值对应的 键 。
    
    异常
    
    NullPointerException - 如果 密钥是 null
    
    InvalidKeyException - 如果 键不符合这个 TabularData实例的 TabularType类型定义。
  - put
```
public Object put(Object key,
                  Object value)
```
    该方法简单地调用 put((CompositeData) value) ，因此忽略其 关键参数，可以是 null 。
    
    Specified by:
    
    put中的 Map<Object,Object>
    
    参数
    
    key - 忽略的参数。
    
    value - 要放CompositeData 。
    
    结果
    
    放置的价值
    
    异常
    
    NullPointerException - 如果 值为 null
    
    ClassCastException - 如果 值不是类型 CompositeData
    
    InvalidOpenTypeException - 如果 值不符合这个 TabularData实例的 TabularType定义
    
    KeyAlreadyExistsException - 如果 值参数的键值，根据这个 TabularData实例的 TabularType定义已经映射到现有值
  - put
```
public void put(CompositeData value)
```
    描述从接口： TabularData复制
    
    为此TabularData实例添加值 。当复合型的值必须与此相同实例的行类型（即由this.getTabularType().getRowType()返回的复合类型），而且必须没有在这个TabularData实例，其指数是相同的值来计算的一个现有值被添加。 值的索引根据TabularData实例的TabularType定义（见TabularType.getIndexNames() ）计算。
    
    Specified by:
    
    put中的 TabularData
    
    参数
    
    value - 要添加到此TabularData实例的新行的复合数据值; 必须与此实例的行类型具有相同的复合类型; 不能为空。
  - remove
```
public Object remove(Object key)
```
    这种方法只需调用 remove((Object[]) key) 。
    
    Specified by:
    
    remove在接口 Map<Object,Object>
    
    参数
    
    key - 一个 Object[]代表删除的关键。
    
    结果
    
    与指定键相关联的上一个值，如果没有键的映射， 则为null 。
    
    异常
    
    NullPointerException - 如果 密钥是 null
    
    ClassCastException - 如果 键不是类型 Object[]
    
    InvalidKeyException - 如果 密钥不符合这个 TabularData实例的 TabularType定义
  - remove
```
public CompositeData remove(Object[] key)
```
    从该 TabularData实例中删除其索引为 关键字的 CompositeData值，并返回删除的值，如果没有索引为 关键字的值，则返回 null 。
    
    Specified by:
    
    remove在界面 TabularData
    
    参数
    
    key - 在这个TabularData实例中获取的值的索引; 必须使用此TabularData实例的行类型定义有效; 不能为空。
    
    结果
    
    与指定键相关联的上一个值，如果没有键的映射， 则为null 。
    
    异常
    
    NullPointerException - 如果 键是 null
    
    InvalidKeyException - 如果 密钥不符合这个 TabularData实例的 TabularType定义
  - putAll
```
public void putAll(Map<?,?> t)
```
    将指定映射t中包含的所有值添加到此TabularData实例。此方法包含在此映射值的集合转换为CompositeData个值时，如果可能的阵列，然后调用该方法putAll(CompositeData[])。 请注意，在指定的映射t中使用的键将被忽略。该方法允许例如将具有相同行类型（但可能不同的索引名称）的另一个TabularData实例的内容添加到该实例中。
    
    Specified by:
    
    putAll在界面 Map<Object,Object>
    
    参数
    
    t - 其值将作为新行添加到此TabularData实例的映射 ; 如果t为null或为空，则此方法返回而不做任何事情。
    
    异常
    
    NullPointerException - 如果 t中的 值为null 。
    
    ClassCastException - 如果 t中的值不是 CompositeData的实例。
    
    InvalidOpenTypeException - 如果 t中的值不符合此 TabularData实例的行类型定义。
    
    KeyAlreadyExistsException - 如果根据这个 TabularData实例的 TabularType定义计算出的值 t的索引已经映射到此实例中的现有值，或 t中的两个值具有相同的索引。
  - putAll
```
public void putAll(CompositeData[] values)
```
    将值中的所有元素添加到此TabularData实例中。如果值中的任何元素不满足put中定义的约束，或者如果值中的任何两个元素具有根据此TabularData实例的TabularType定义计算的相同索引，则抛出描述失败的异常，并且不添加值元素，从而使这个TabularData实例保持不变。
    
    Specified by:
    
    putAll在接口 TabularData
    
    参数
    
    values - 要作为新行添加到此TabularData实例的复合数据值数组; 如果值为 null或为空，则此方法返回而不做任何事情。
    
    异常
    
    NullPointerException - 如果 值的元素是 null
    
    InvalidOpenTypeException - 如果一个 值的元素不符合这个 TabularData实例的行类型定义（即它的 TabularType定义）
    
    KeyAlreadyExistsException - 如果根据这个 TabularData实例的 TabularType定义 计算的值元素的索引已经映射到此实例中的现有值，或两个 值的元素具有相同的索引
  - clear
```
public void clear()
```
    从此 TabularDataSupport实例中删除所有行。
    
    Specified by:
    
    clear在接口 Map<Object,Object>
    
    Specified by:
    
    clear中的 TabularData
  - size
```
public int size()
```
    返回此 TabularDataSupport实例中的行数。
    
    Specified by:
    
    size在接口 Map<Object,Object>
    
    Specified by:
    
    size在接口 TabularData
    
    结果
    
    这个 TabularDataSupport实例中的行数。
  - isEmpty
```
public boolean isEmpty()
```
    如果此 TabularDataSupport实例不包含任何行，则返回 true 。
    
    Specified by:
    
    isEmpty在接口 Map<Object,Object>
    
    Specified by:
    
    isEmpty在接口 TabularData
    
    结果
    
    true如果这个 TabularDataSupport实例不包含任何行。
  - keySet
```
public Set<Object> keySet()
```
    返回用于对行进行索引的此TabularDataSupport实例的底层映射中包含的键的集视图。包含在此的每个键Set是一个不可修改List<?>因此返回设置视图是Set<List<?>> ，但被声明为Set<Object>兼容性的原因。该集合由此TabularDataSupport实例的底层映射支持，因此对该TabularDataSupport更改将反映在TabularDataSupport实例中，反之亦然。该组支持元件移除，即从该相应的行TabularDataSupport例如，经由Iterator.remove() ， Set.remove(java.lang.Object) ， Set.removeAll(java.util.Collection<?>) ， Set.retainAll(java.util.Collection<?>)和Set.clear()操作。它不支持Set.add(E)或Set.addAll(java.util.Collection<? extends E>)操作。
    
    Specified by:
    
    keySet在接口 Map<Object,Object>
    
    Specified by:
    
    keySet在接口 TabularData
    
    结果
    
    用于为此 TabularDataSupport实例的行索引设置的视图（ Set<List<?>> ）。
  - values
```
public Collection<Object> values()
```
    返回此TabularDataSupport实例中包含的行的集合视图。返回Collection是Collection<CompositeData> ，但被声明为Collection<Object>兼容性的原因。返回的集合可以用于迭代值。该集合由底层映射支持，因此对TabularDataSupport将反映在TabularDataSupport实例中，反之亦然。集合支持元素移除，从而消除了相应的索引到行从该映射TabularDataSupport例如，经由Iterator.remove() ， Collection.remove(java.lang.Object) ， Collection.removeAll(java.util.Collection<?>) ， Collection.retainAll(java.util.Collection<?>)和Collection.clear()操作。它不支持Collection.add(E)或Collection.addAll(java.util.Collection<? extends E>)操作。
    
    Specified by:
    
    values在接口 Map<Object,Object>
    
    Specified by:
    
    values在接口 TabularData
    
    结果
    
    这个 TabularDataSupport实例中包含的值的集合视图（ Collection<CompositeData> ）。
  - entrySet
```
public Set<Map.Entry<Object,Object>> entrySet()
```
    返回此TabularDataSupport实例中TabularDataSupport行映射索引的集合视图。返回的集合中的每个元素是Map.Entry<List<?>,CompositeData> ，但被声明为Map.Entry<Object,Object>兼容性的原因。每个地图条目键是一个不可List<?> 。该集合由此TabularDataSupport实例的底层映射支持，因此对TabularDataSupport中的更改将反映在TabularDataSupport实例中，反之亦然。该collection支持元素移除，即从映射中相应的映射，经由Iterator.remove() ， Collection.remove(java.lang.Object) ， Collection.removeAll(java.util.Collection<?>) ， Collection.retainAll(java.util.Collection<?>)和Collection.clear()操作。它不支持Collection.add(E)或Collection.addAll(java.util.Collection<? extends E>)操作。
    重要通知 ：不要使用返回的集合视图中包含的Map.Entry元素的setValue方法。这样做会损坏此TabularDataSupport实例中TabularDataSupport行映射的索引。
    
    Specified by:
    
    entrySet在接口 Map<Object,Object>
    
    结果
    
    该地图中包含的映射的集合视图（ Set<Map.Entry<List<?>,CompositeData>> ）。
    
    另请参见：
    
    Map.Entry
  - clone
```
public Object clone()
```
    返回此TabularDataSupport实例的克隆：通过调用super.clone()获取克隆，然后克隆底层地图。仅生成底层地图的浅克隆，即不进行索引和行值的克隆，因为它们是不可变的。
    
    重写：
    
    clone在 Object
    
    结果
    
    这个实例的一个克隆。
    
    另请参见：
    
    Cloneable
  - equals
```
public boolean equals(Object obj)
```
    将指定的obj参数与此TabularDataSupport实例进行比较以获得相等性。
    返回true当且仅当以下所有语句都为真时：
    - obj是非空，
    - obj还实现了TabularData接口，
    - 它们的表格类型是相等的
    - 它们的内容（即所有的CompositeData值）相等。
    这确保了这个equals方法适用于对象参数，这些参数是TabularData接口的TabularData实现。
    Specified by:
    
    equals在接口 Map<Object,Object>
    
    Specified by:
    
    equals在接口 TabularData
    
    重写：
    
    equals在 Object类
    
    参数
    
    obj - 要与此 TabularDataSupport实例相等的对象;
    
    结果
    
    true如果指定的对象等于这个 TabularDataSupport实例。
    
    另请参见：
    
    Object.hashCode() ， HashMap
  - hashCode
```
public int hashCode()
```
    返回此TabularDataSupport实例的哈希码值。
    一个的哈希码TabularDataSupport实例中使用的所有信息元素的哈希码的总和equals比较（即：它的表格类型和它的内容，其中内容被定义为所有的CompositeData值）。
    
    这确保了t1.equals(t2)意味着t1.hashCode()==t2.hashCode()对于任何两个TabularDataSupport实例t1和t2 ，所要求的方法的常规合同Object.hashCode() 。
    
    但是，请注意，实现TabularData接口的类的另一个实例可能与TabularDataSupport定义的TabularDataSupport实例相同，但是如果不同的计算方式可能具有不同的哈希码。
    
    Specified by:
    
    hashCode在接口 Map<Object,Object>
    
    Specified by:
    
    hashCode在接口 TabularData
    
    重写：
    
    hashCode在 Object
    
    结果
    
    这个 TabularDataSupport实例的哈希码值
    
    另请参见：
    
    Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    返回此TabularDataSupport实例的字符串表示形式。
    字符串表示由此类的名称（即javax.management.openmbean.TabularDataSupport ），此实例的表格类型的字符串表示形式和内容的字符串表示形式（即列出通过调用返回的键=值映射dataMap. toString() ）。
    
    Specified by:
    
    toString在接口 TabularData
    
    重写：
    
    toString在 Object类
    
    结果
    
    这个 TabularDataSupport实例的字符串表示形式

Class TabularDataSupport

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Map

构造方法详细信息

TabularDataSupport

TabularDataSupport

方法详细信息

getTabularType

calculateIndex

containsKey

containsKey

containsValue

containsValue

get

get

put

put

remove

remove

putAll

putAll

clear

size

isEmpty

keySet

values

entrySet

clone

equals

hashCode

toString