TabularData (Java Platform SE 8 )

所有已知实现类：

TabularDataSupport
```
public interface TabularData
```
TabularData接口指定了表示 表格数据结构的特定类型的复杂 开放数据对象的行为。

从以下版本开始：

1.5

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`Object[]`	`calculateIndex(CompositeData value)` 计算此 `TabularData`实例中将使用的索引，以引用指定的复合数据 `值`参数（如果已添加到此实例）。
`void`	`clear()` 从这个 `TabularData`实例中删除所有 `CompositeData个`值（即行）。
`boolean`	`containsKey(Object[] key)` 返回 `true`当且仅当此 `TabularData`实例包含 `CompositeData`值（即行），其指数为指定的 `键` 。
`boolean`	`containsValue(CompositeData value)` 当且仅当此 `TabularData`实例包含指定的 `CompositeData`值时返回 `true` 。
`boolean`	`equals(Object obj)` 将指定的 `obj`参数与此 `TabularData`实例进行比较以获得相等性。
`CompositeData`	`get(Object[] key)` 返回 `CompositeData`值，其指数是 `关键` ，或 `null`如果没有值映射到 `按键` ，在此 `TabularData`实例。
`TabularType`	`getTabularType()` 返回描述此 `TabularData`实例的表格类型。
`int`	`hashCode()` 返回此 `TabularData`实例的哈希码值。
`boolean`	`isEmpty()` 返回 `true` `CompositeData个`如果值的包含在此 `TabularData`实例的数目（即行的数目）为零。
`Set<?>`	`keySet()` 返回此 `TabularData`实例中包含的 `CompositeData`值（即行）的键的集合视图（即索引值）。
`void`	`put(CompositeData value)` 为此 `TabularData`实例添加 `值` 。
`void`	`putAll(CompositeData[] values)` 将 `值`中的所有元素添加到此 `TabularData`实例中。
`CompositeData`	`remove(Object[] key)` 从此 `TabularData`实例中删除其索引为 `关键字`的 `CompositeData`值，并返回删除的值，如果没有索引为 `键的`值，则返回 `null` 。
`int`	`size()` 返回此 `TabularData`实例中 `包含的CompositeData个`值（即行数）。
`String`	`toString()` 返回此 `TabularData`实例的字符串表示形式。
`Collection<?>`	`values()` 返回此 `TabularData`实例中包含的 `CompositeData`值（即行）的集合 `TabularData` 。

- 方法详细信息
  - getTabularType
```
TabularType getTabularType()
```
    返回描述此 TabularData实例的 表格类型 。
    
    结果
    
    表格类型。
  - calculateIndex
```
Object[] calculateIndex(CompositeData value)
```
    计算将在此TabularData实例中使用的索引，以引用指定的复合数据值参数（如果已添加到此实例）。此方法检查指定值的类型有效性，但不检查计算的索引是否已用于引用此TabularData实例中的值。
    
    参数
    
    value - 要计算此TabularData实例中的索引的复合数据值; 必须与此实例的行类型具有相同的复合类型; 不能为空。
    
    结果
    
    指定 值在该 TabularData实例中具有的索引。
    
    异常
    
    NullPointerException - 如果 值为 null
    
    InvalidOpenTypeException - 如果 值不符合此 TabularData实例的行类型定义。
  - size
```
int size()
```
    返回此 TabularData实例中 包含的CompositeData个值（即行数）。
    
    结果
    
    包含的值的数量。
  - isEmpty
```
boolean isEmpty()
```
    返回 true CompositeData个如果值的包含在此 TabularData实例的数目（即行的数目）为零。
    
    结果
    
    如果这 TabularData为空，则为true。
  - containsKey
```
boolean containsKey(Object[] key)
```
    返回true当且仅当此TabularData实例包含CompositeData值（即行），其指数为指定的键 。如果键是null或者不符合这个TabularData实例的TabularType定义，这个方法只需返回false 。
    
    参数
    
    key - 要测试其在此 TabularData实例中的索引值。
    
    结果
    
    true如果这 TabularData用指定的键索引行值。
  - containsValue
```
boolean containsValue(CompositeData value)
```
    当且仅当此TabularData实例包含指定的CompositeData值时返回true 。如果值为 null或不符合此TabularData实例的行类型定义，则此方法只返回false 。
    
    参数
    
    value - 要测试此 TabularData实例中的行值。
    
    结果
    
    true如果这个 TabularData实例包含指定的行值。
  - get
```
CompositeData get(Object[] key)
```
    返回 CompositeData值，其指数是 关键 ，或 null如果没有值映射到 按键 ，在此 TabularData实例。
    
    参数
    
    key - 要返回的行的键。
    
    结果
    
    值对应的 键 。
    
    异常
    
    NullPointerException - 如果 密钥是 null
    
    InvalidKeyException - 如果 密钥不符合这个 TabularData实例的* TabularType定义
  - put
```
void put(CompositeData value)
```
    为此TabularData实例添加值 。当复合型的值必须与此相同实例的行类型（即由this.getTabularType().getRowType()返回的复合类型），而且必须没有在这个TabularData实例，其指数是相同的值来计算的一个现有值被添加。 价值指数根据TabularData实例的TabularType定义计算（见TabularType.getIndexNames() ）。
    
    参数
    
    value - 要添加到此TabularData实例的新行的复合数据值; 必须与此实例的行类型具有相同的复合类型; 不能为空。
    
    异常
    
    NullPointerException - 如果 值为 null
    
    InvalidOpenTypeException - 如果 值不符合这个 TabularData实例的行类型定义。
    
    KeyAlreadyExistsException - 如果根据此 TabularData实例的 TabularType定义 计算的值的索引已经映射到底层HashMap中的现有值。
  - remove
```
CompositeData remove(Object[] key)
```
    从该 TabularData实例中删除其索引为 关键字的 CompositeData值，并返回删除的值，如果没有索引为 key的值，则返回 null 。
    
    参数
    
    key - 在这个TabularData实例中获取的值的索引; 必须使用此TabularData实例的行类型定义有效; 不能为空。
    
    结果
    
    与指定键相关联的上一个值，如果没有键的映射， 则为null 。
    
    异常
    
    NullPointerException - 如果 密钥是 null
    
    InvalidKeyException - 如果 键不符合这个 TabularData实例的 TabularType定义
  - putAll
```
void putAll(CompositeData[] values)
```
    将值中的所有元素添加到此TabularData实例。如果值中的任何元素不满足put中定义的约束，或者如果值中的任何两个元素具有根据此TabularData实例的TabularType定义计算的相同索引，则抛出描述失败的异常，并且不添加值元素，从而使这个TabularData实例保持不变。
    
    参数
    
    values - 要添加到此TabularData实例的新行的复合数据值数组; 如果值为 null或为空，则此方法返回而不做任何操作。
    
    异常
    
    NullPointerException - 如果 值的元素是 null
    
    InvalidOpenTypeException - 如果 值的元素不符合此 TabularData实例的行类型定义
    
    KeyAlreadyExistsException - 如果根据此 TabularData实例的 TabularType定义 计算的一个元素的索引已经映射到此实例中的现有值，或两个 值的元素具有相同的索引。
  - clear
```
void clear()
```
    从这个 TabularData实例中删除所有 CompositeData个值（即行）。
  - keySet
```
Set<?> keySet()
```
    返回此TabularData实例中包含的CompositeData值（即行）的键的集合视图（即索引值）。返回Set是Set<List<?>> ，但被声明为Set<?>兼容性的原因。返回的集合可用于遍历键。
    
    结果
    
    该 TabularData实例中使用的索引值的设置视图（ Set<List<?>> ）。
  - values
```
Collection<?> values()
```
    返回此TabularData实例中包含的CompositeData值（即行）的集合TabularData 。返回Collection是Collection<CompositeData> ，但被声明为Collection<?>兼容性的原因。返回的集合可以用于迭代值。
    
    结果
    
    这个 TabularData实例中包含的行的集合视图（ Collection<CompositeData> ）。
  - equals
```
boolean equals(Object obj)
```
    将指定的obj参数与此TabularData实例相比较。
    返回true当且仅当以下所有语句都为真时：
    - obj是非空，
    - obj也实现了TabularData接口，
    - 他们的行类型是相等的
    - 它们的内容（即索引到值映射）是相等的
    这确保了此equals方法正常工作对作为不同实现的obj参数TabularData接口。
    重写：
    
    equals在 Object
    
    参数
    
    obj - 要与此 TabularData实例相等的对象;
    
    结果
    
    true如果指定的对象等于这个 TabularData实例。
    
    另请参见：
    
    Object.hashCode() ， HashMap
  - hashCode
```
int hashCode()
```
    返回此TabularData实例的哈希码值。
    一个的哈希码TabularData实例中使用的所有信息元素的哈希码的总和equals比较（即：它的表格类型和它的内容，其中内容被定义为所有的索引值映射）。
    
    这确保了t1.equals(t2)意味着t1.hashCode()==t2.hashCode()对于任何两个TabularDataSupport实例t1和t2 ，所要求的方法的常规合同Object.hashCode() 。
    
    重写：
    
    hashCode在 Object
    
    结果
    
    这个 TabularDataSupport实例的哈希码值
    
    另请参见：
    
    Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)
  - toString
```
String toString()
```
    返回此TabularData实例的字符串表示形式。
    字符串表示由实现类的名称和此实例的表格类型组成。
    
    重写：
    
    toString在 Object
    
    结果
    
    a string representation of this TabularData instance

Interface TabularData

方法摘要

方法详细信息

getTabularType

calculateIndex

size

isEmpty

containsKey

containsValue

get

put

remove

putAll

clear

keySet

values

equals

hashCode

toString