|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object javax.management.openmbean.TabularDataSupport
public class TabularDataSupport
TabularDataSupport 类是实现 TabularData 和 Map 接口的开放数据 类,并且它是内部基于哈希映射数据结构的。
嵌套类摘要 |
---|
从接口 java.util.Map 继承的嵌套类/接口 |
---|
Map.Entry<K,V> |
构造方法摘要 | |
---|---|
TabularDataSupport(TabularType tabularType)
创建一个空 TabularDataSupport 实例,其开放类型是 tabularType,并且其基础 HashMap 具有默认初始容量 (101) 和默认加载因子 (0.75)。 |
|
TabularDataSupport(TabularType tabularType,
int initialCapacity,
float loadFactor)
创建一个空 TabularDataSupport 实例,其开放类型为 tabularType,其基础 HashMap 具有指定的初始容量和加载因子。 |
方法摘要 | |
---|---|
Object[] |
calculateIndex(CompositeData value)
计算将在此 TabularData 实例中使用的索引,以便在指定的复合数据 value 参数添加到此实例后引用该参数。 |
void |
clear()
从此 TabularDataSupport 实例中移除所有行。 |
Object |
clone()
返回此 TabularDataSupport 实例的一个副本:通过调用 super.clone(),然后克隆此基础映射,即可得到该副本。 |
boolean |
containsKey(Object key)
当且仅当此 TabularData 实例包含其索引为指定 key 的 CompositeData 值(即行)时,才返回 true。 |
boolean |
containsKey(Object[] key)
当且仅当此 TabularData 实例包含其索引为指定 key 的 CompositeData 值(即行)时,才返回 true。 |
boolean |
containsValue(CompositeData value)
当且仅当此 TabularData 实例包含指定的 CompositeData 值时才返回 true。 |
boolean |
containsValue(Object value)
当且仅当此 TabularData 实例包含指定的值时,才返回 true。 |
Set |
entrySet()
返回此 TabularDataSupport 实例中包含的行映射的索引的 collection 视图。 |
boolean |
equals(Object obj)
比较指定的 obj 参数与此 TabularDataSupport 实例的相等性。 |
Object |
get(Object key)
此方法仅调用 get((Object[]) key)。 |
CompositeData |
get(Object[] key)
返回此 TabularData 实例中其索引为 key 的 CompositeData 值,如果没有映射到 key 的值,则返回 null。 |
TabularType |
getTabularType()
返回描述此 TabularData 实例的表格类型。 |
int |
hashCode()
返回此 TabularDataSupport 实例的哈希码值。 |
boolean |
isEmpty()
如果此 TabularDataSupport 实例不包含任何行,则返回 true。 |
Set |
keySet()
返回包含在此 TabularDataSupport 实例的基础映射中的键的 set 视图,并用于索引行。 |
void |
put(CompositeData value)
将 value 添加到此 TabularData 实例。 |
Object |
put(Object key,
Object value)
此方法仅调用 put((CompositeData) value),因此忽略其可能为 null 的 key 参数。 |
void |
putAll(CompositeData[] values)
将 values 中的所有元素添加到此 TabularData 实例。 |
void |
putAll(Map t)
把包含在指定映射 t 中的所有值添加到此 TabularData 实例。 |
Object |
remove(Object key)
此方法仅调用 remove((Object[]) key)。 |
CompositeData |
remove(Object[] key)
从此 TabularData 实例中移除其索引为 key 的 CompositeData 值,并返回被移除的值,如果不存在索引为 key 的值,则返回 null。 |
int |
size()
返回此 TabularDataSupport 实例中的行数。 |
String |
toString()
返回此 TabularDataSupport 实例的字符串表示形式。 |
Collection |
values()
返回包含在此 TabularDataSupport 实例中的行的 collection 视图。 |
从类 java.lang.Object 继承的方法 |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
构造方法详细信息 |
---|
public TabularDataSupport(TabularType tabularType)
此构造方法仅调用 this(tabularType, 101, 0.75f);
tabularType
- 描述此 TabularData 实例的表格类型;不能为 null。
IllegalArgumentException
- 如果表格类型为 null。public TabularDataSupport(TabularType tabularType, int initialCapacity, float loadFactor)
tabularType
- 描述此 TabularData 实例的表格类型;不能为 null。initialCapacity
- HashMap 的初始容量。loadFactor
- HashMap 的加载因子
IllegalArgumentException
- 如果初始容量小于零或者加载因子为非正数,或者表格类型为 null。方法详细信息 |
---|
public TabularType getTabularType()
TabularData
中的 getTabularType
public Object[] calculateIndex(CompositeData value)
TabularData
中的 calculateIndex
value
- 要计算其在此 TabularData 实例中索引的复合数据值;必须是与此实例的行类型相同的复合类型;而且不能为 null。
NullPointerException
- 如果 value 为 null。
InvalidOpenTypeException
- 如果 value 不符合此 TabularData 实例的行类型定义。public boolean containsKey(Object key)
Map
中的 containsKey
key
- 将测试其在此 TabularData 实例中的存在性的索引值。
public boolean containsKey(Object[] key)
TabularData
中的 containsKey
key
- 将测试其在此 TabularData 实例中的存在性的索引值。
public boolean containsValue(CompositeData value)
TabularData
中的 containsValue
value
- 将测试其在此 TabularData 实例中的存在性的行值。
public boolean containsValue(Object value)
Map
中的 containsValue
value
- 将测试其在此 TabularData 实例中的存在性的行值。
public Object get(Object key)
Map
中的 get
key
- 要返回其相关值的键。
NullPointerException
- 如果 key 为 null
ClassCastException
- 如果 key 不属于 Object[] 类型
InvalidKeyException
- 如果 key 不符合此 TabularData 实例的 TabularType 定义。Map.containsKey(Object)
public CompositeData get(Object[] key)
TabularData
中的 get
key
- 要获取的此 TabularData 实例中值的索引;*必须对此 TabularData 实例的行类型定义有效;*并且不能为 null。
NullPointerException
- 如果 key 为 null
InvalidKeyException
- 如果 key 不符合此 TabularData 实例的 TabularType 类型定义。public Object put(Object key, Object value)
Map
中的 put
key
- 被忽略的参数。value
- 要放入的 CompositeData
。
NullPointerException
- 如果 value 为 null
ClassCastException
- 如果 value 不属于 CompositeData 类型
InvalidOpenTypeException
- 如果 value 不符合此 TabularData 实例的 TabularType 定义
KeyAlreadyExistsException
- 如果根据此 TabularData 实例的 TabularType 定义计算的 value 参数的键已经映射到一个现有的值。public void put(CompositeData value)
TabularData
复制的描述getRowType()
返回的复合类型)相同,并且此 TabularData 实例中现有值的索引不能与为要添加的 value 计算的索引相同。value 的索引是根据此 TabularData 实例的 TabularType 定义计算的(请参见 TabularType.getIndexNames()
)。
TabularData
中的 put
value
- 要作为新行添加到此 TabularData 实例中的复合数据值;必须是与此实例的行类型相同的复合类型;并且不能为 null。public Object remove(Object key)
Map
中的 remove
key
- 表示要移除键的 Object[]。
NullPointerException
- 如果 key 为 null
ClassCastException
- 如果 key 不属于 Object[] 类型
InvalidKeyException
- 如果 key 不符合此 TabularData 实例的 TabularType 定义。public CompositeData remove(Object[] key)
TabularData
中的 remove
key
- 要获取的此 TabularData 实例中值的索引;必须对此 TabularData 实例的行类型定义有效;并且不能为 null。
NullPointerException
- 如果 key 为 null
InvalidKeyException
- 如果 key 不符合此 TabularData 实例的 TabularType 定义public void putAll(Map t)
Map
中的 putAll
t
- 其值作为新行添加到此 TabularData 实例中的映射;如果 t 为 null 或空,则此方法直接返回而不执行任何操作。
NullPointerException
- 如果 t 中的值为 null。
ClassCastException
- 如果 t 中的值不是 CompositeData 的实例。
InvalidOpenTypeException
- 如果 t 中的值不符合此 TabularData 实例的行类型定义。
KeyAlreadyExistsException
- 如果根据此 TabularData 实例的 TabularType 定义计算的 t 中的值的索引已经映射到此实例中现有的值,或者 t 中的两个值具有相同的索引。public void putAll(CompositeData[] values)
put
中定义的约束,或者 values 中的任何两个元素具有相同的索引,则抛出一个描述失败的异常,并且不添加 values 的任何元素,因此,此 TabularData 实例保持不变。
TabularData
中的 putAll
values
- 作为新行添加到此 TabularData 实例的复合数据值的数组;如果 values 为 null 或者为空,则此方法直接返回且不执行任何操作。
NullPointerException
- 如果 values 的一个元素为 null
InvalidOpenTypeException
- 如果 values 的某个元素不符合此 TabularData 实例的行类型定义(即其 TabularType 定义)
KeyAlreadyExistsException
- 如果根据此 TabularData 实例的 TabularType 定义计算的 values 的某个元素的索引已经映射到此实例中现有的值,或者 values 的两个元素具有相同的索引public void clear()
TabularDataSupport
实例中移除所有行。
Map
中的 clear
TabularData
中的 clear
public int size()
TabularDataSupport
实例中的行数。
Map
中的 size
TabularData
中的 size
TabularDatasupport
实例中的行数。public boolean isEmpty()
TabularDataSupport
实例不包含任何行,则返回 true。
Map
中的 isEmpty
TabularData
中的 isEmpty
TabularDataSupport
实例不包含任何行,则返回 true。public Set keySet()
TabularDataSupport
实例的基础映射中的键的 set 视图,并用于索引行。此 set 中包含的每个键都是一个不可修改的列表。该 set 受此 TabularDataSupport
实例的基础映射支持,所以对 TabularDataSupport
实例的更改可在此 set 中反映出来,反之亦然。
该 set 支持元素的移除,通过 Iterator.remove、Set.remove、removeAll、retainAll 和 clear 操作,从此 TabularDataSupport
实例中移除相应的行。它不支持 add 或 addAll 操作。
Map
中的 keySet
TabularData
中的 keySet
TabularDataSupport
实例的行进行索引的键的 set 视图。public Collection values()
TabularDataSupport
实例中的行的 collection 视图。该 collection 受基础映射支持,所以对 TabularDataSupport
实例的更改可在此 collection 中反映出来,反之亦然。
该集合支持元素的移除,通过 Iterator.remove、Collection.remove、removeAll、retainAll 和 clear 操作,从此 TabularDataSupport
实例中移除相应的行映射索引。它不支持 add 或 addAll 操作。
Map
中的 values
TabularData
中的 values
TabularDataSupport
实例中包含的值的 collection 视图。public Set entrySet()
TabularDataSupport
实例中包含的行映射的索引的 collection 视图。在返回的集合中,每个元素都是一个 Map.Entry。该 collection 受此 TabularDataSupport
实例的基础映射支持,因此对 TabularDataSupport
实例的更改会在该集合中反映出来,反之亦然。该集合支持元素的移除,通过 Iterator.remove、Collection.remove、removeAll、retainAll 和 clear 操作,从该映射中移除相应的映射关系。它不支持 add 或 addAll 操作。
重要注意事项:不要使用返回的 collection 视图中包含的 Map.Entry 元素的 SetValue 方法。这样做会破坏此 TabularDataSupport
实例中包含的行映射的索引。
Map
中的 entrySet
Map.Entry
public Object clone()
TabularDataSupport
实例的一个副本:通过调用 super.clone(),然后克隆此基础映射,即可得到该副本。仅对此基础映射进行浅表复制,也就是说,由于索引和行值是不可改变的,因此不克隆它们。
Object
中的 clone
Cloneable
public boolean equals(Object obj)
TabularDataSupport
实例的相等性。
当且仅当下面的所有语句均为 true 时,才返回 true:
TabularData
接口,TabularData
接口的不同实现的 obj 参数正常工作。
Map
中的 equals
TabularData
中的 equals
Object
中的 equals
obj
- 与此 TabularDataSupport
实例进行相等性比较的对象;
TabularDataSupport
实例,则返回 true
。Object.hashCode()
,
Hashtable
public int hashCode()
TabularDataSupport
实例的哈希码值。
TabularDataSupport
实例的哈希码是 equals
比较中使用的信息的所有元素的哈希码总和(即:其表格类型 及其内容,其中内容被定义为所有 CompositeData 值)。
这确保 t1.equals(t2)
意味着对于任何两个 TabularDataSupport
实例 t1
和 t2
而言,都存在 t1.hashCode()==t2.hashCode()
,这是方法 Object.hashCode()
的通用协定所要求的。
不过请注意,根据 equals(java.lang.Object)
中的定义,实现 TabularData
接口的类的其他实例可能与此 TabularDataSupport
实例相等,但是如果它的计算方法不同,可能会有不同的哈希码。
Map
中的 hashCode
TabularData
中的 hashCode
Object
中的 hashCode
TabularDataSupport
实例的哈希码值Object.equals(java.lang.Object)
,
Hashtable
public String toString()
TabularDataSupport
实例的字符串表示形式。
该字符串表示形式由此类(即,javax.management.openmbean.TabularDataSupport
)的名称、此实例的表格类型的字符串表示形式、内容的字符串表示形式(即,列出按照对 dataMap.toString()
的调用所返回的 key=value 映射关系)组成。
TabularData
中的 toString
Object
中的 toString
TabularDataSupport
实例的字符串表示形式
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。