-
- 所有已知实现类:
-
TabularDataSupport
public interface TabularDataTabularData接口指定了表示 表格数据结构的特定类型的复杂 开放数据对象的行为。- 从以下版本开始:
- 1.5
-
-
方法摘要
所有方法 接口方法 抽象方法 Modifier and Type 方法 描述 Object[]calculateIndex(CompositeData value)计算将在此TabularData实例中使用的索引,以引用指定的复合数据 值参数(如果已添加到此实例)。voidclear()从此TabularData实例中删除所有CompositeData值(即行)。booleancontainsKey(Object[] key)如果且仅当此TabularData实例包含索引为指定 键的CompositeData值(即一行),则返回true。booleancontainsValue(CompositeData value)如果此TabularData实例包含指定的CompositeData值,则返回true。booleanequals(Object obj)将指定的 obj参数与此TabularData实例进行比较以获得相等性。CompositeDataget(Object[] key)在这个TabularData实例中,如果没有值映射到 键 ,则返回其索引为 key的CompositeData值,或null。TabularTypegetTabularType()返回描述此TabularData实例的 表格类型 。inthashCode()返回此TabularData实例的哈希码值。booleanisEmpty()如果此TabularData实例中包含的CompositeData值(即行数)true则返回true。Set<?>keySet()返回TabularData实例中包含的CompositeData值(即行)的键的集合视图(即索引值)。voidput(CompositeData value)将 值添加到此TabularData实例。voidputAll(CompositeData[] values)将 值中的所有元素添加到此TabularData实例中。CompositeDataremove(Object[] key)从TabularData实例中删除索引为 关键字的CompositeData值,并返回已删除的值,如果没有索引为 key的值,则返回null。intsize()返回此TabularData实例中包含的CompositeData值(即行数)。StringtoString()返回此TabularData实例的字符串表示形式。Collection<?>values()返回TabularData实例中包含的CompositeData值(即行)的集合视图。
-
-
-
方法详细信息
-
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()
如果此TabularData实例中包含的CompositeData值(即行数)true则返回true。- 结果
-
如果这个
TabularData为空,TabularDatatrue。
-
containsKey
boolean containsKey(Object[] key)
如果此TabularData实例包含索引为指定键的值为CompositeData值(即一行),则返回true。 如果键是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)
在这个TabularData实例中,如果没有值映射到 键 ,则返回其索引为 key的CompositeData值,或null。- 参数
-
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值(即行)的集合视图。 由于兼容性原因,所返回的Collection是Collection<CompositeData>但被声明为Collection<?>。 返回的集合可以用于迭代值。- 结果
-
该
TabularData实例中包含的行的集合视图(Collection<CompositeData>)。
-
equals
boolean equals(Object obj)
将指定的obj参数与此TabularData实例进行比较以获得相等性。如果且仅当以下所有语句均为真时,则返回
true:- obj是非空,
- obj还实现了
TabularData接口, - 他们的行类型是相等的
- 它们的内容(即索引到值映射)是相等的
equals方法适用于对象参数,这是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)
-
-