public abstract class Dictionary
extends Object
java.lang.Object | |
↳ | java.util.Dictionary<K, V> |
Known Direct Subclasses
Hashtable<K, V>
|
Known Indirect Subclasses |
Dictionary
类是任何类的抽象父级,例如Hashtable
,它将键映射到值。 每个关键和每个值都是一个对象。 在任何一个Dictionary对象中,每个键最多与一个值关联。 给定一个Dictionary和一个关键字,可以查找关联的元素。 任何非null
对象都可以用作键和值。
通常, equals
的实现应该使用 equals
方法来确定两个键是否相同。
注意:此课程已过时。 新的实现应该实现Map接口,而不是扩展这个类。
Public constructors |
|
---|---|
Dictionary() 唯一的构造函数。 |
Public methods |
|
---|---|
abstract Enumeration<V> |
elements() 返回此字典中值的枚举。 |
abstract V |
get(Object key) 返回此字典中键映射到的值。 |
abstract boolean |
isEmpty() 测试该字典是否将任何键映射到值。 |
abstract Enumeration<K> |
keys() 返回此字典中键的枚举。 |
abstract V |
put(K key, V value) 将指定的 |
abstract V |
remove(Object key) 从此字典中删除 |
abstract int |
size() 返回此字典中的条目数(不同的键)。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
Enumeration<V> elements ()
返回此字典中值的枚举。 elements方法的一般合同是返回Enumeration ,它将生成此字典中条目中包含的所有元素。
Returns | |
---|---|
Enumeration<V> |
an enumeration of the values in this dictionary. |
也可以看看:
V get (Object key)
返回此字典中键映射到的值。 isEmpty方法的一般合同是,如果此字典包含指定键的条目,则返回关联值; 否则,返回null 。
Parameters | |
---|---|
key |
Object : a key in this dictionary. null if the key is not mapped to any value in this dictionary. |
Returns | |
---|---|
V |
the value to which the key is mapped in this dictionary; |
Throws | |
---|---|
NullPointerException |
if the key is null. |
boolean isEmpty ()
测试该字典是否将任何键映射到值。 isEmpty方法的一般合同是,当且仅当此字典不包含条目时,结果才为真。
Returns | |
---|---|
boolean |
true if this dictionary maps no keys to values; false otherwise. |
Enumeration<K> keys ()
返回此字典中键的枚举。 键方法的一般合约是返回一个Enumeration对象,该对象将生成此字典中包含条目的所有键。
Returns | |
---|---|
Enumeration<K> |
an enumeration of the keys in this dictionary. |
也可以看看:
V put (K key, V value)
将指定的key
映射到此字典中指定的value
。 关键和价值都不是null
。
如果这个字典已经包含指定 key的条目,在本字典为 key已经值返回,修改为包含新的元素加入后。
如果此字典中没有指定 key的条目,则会为指定的 key和 value创建条目,并返回 null 。
value
可以通过调用 get
方法检索 key
,它等于原始 key
。
Parameters | |
---|---|
key |
K : the hashtable key. |
value |
V : the value. |
Returns | |
---|---|
V |
the previous value to which the key was mapped in this dictionary, or null if the key did not have a previous mapping. |
Throws | |
---|---|
NullPointerException |
if the key or value is null . |
V remove (Object key)
从此字典中删除key
(及其相应的value
)。 如果key
不在此字典中,此方法不起作用。
Parameters | |
---|---|
key |
Object : the key that needs to be removed. |
Returns | |
---|---|
V |
the value to which the key had been mapped in this dictionary, or null if the key did not have a mapping. |
Throws | |
---|---|
NullPointerException |
if key is null. |
int size ()
返回此字典中的条目数(不同的键)。
Returns | |
---|---|
int |
the number of keys in this dictionary. |