- java.lang.Object
-
- java.util.Dictionary<K,V>
-
- 已知直接子类:
-
Hashtable
public abstract class Dictionary<K,V> extends Object
Dictionary
类是任何类的抽象父类,例如Hashtable
,它将键映射到值。 每个键和每个值都是一个对象。 在任何一个Dictionary
对象中,每个键最多与一个值相关联。 给定Dictionary
和一个键,可以查找关联的元素。 任何非null
对象都可以用作键和值。通常,
equals
的实现应使用equals
方法来确定两个键是否相同。注意:此类已过时。 新实现应该实现Map接口,而不是扩展此类。
- 从以下版本开始:
- 1.0
- 另请参见:
-
Map
,Object.equals(java.lang.Object)
,Object.hashCode()
,Hashtable
-
-
构造方法摘要
构造方法 构造器 描述 Dictionary()
唯一的构造函数。
-
方法摘要
所有方法 实例方法 抽象方法 变量和类型 方法 描述 abstract Enumeration<V>
elements()
返回此字典中值的枚举。abstract V
get(Object key)
返回键在此字典中映射到的值。abstract boolean
isEmpty()
测试此字典是否将键没有映射到值。abstract Enumeration<K>
keys()
返回此字典中键的枚举。abstract V
put(K key, V value)
将指定的key
映射到此字典中的指定value
。abstract V
remove(Object key)
从此词典中删除key
(及其对应的value
)。abstract int
size()
返回此字典中的条目数(不同的键)。
-
-
-
方法详细信息
-
size
public abstract int size()
返回此字典中的条目数(不同的键)。- 结果
- 这本词典中的键数。
-
isEmpty
public abstract boolean isEmpty()
测试此字典是否将键没有映射到值。isEmpty
方法的常规合同是,当且仅当此字典不包含任何条目时,结果为true。- 结果
-
true
如果此字典没有将键映射到值; 否则为false
。
-
keys
public abstract Enumeration<K> keys()
返回此字典中键的枚举。 keys方法的一般合同是返回一个Enumeration
对象,它将生成此字典包含条目的所有键。- 结果
- 此字典中键的枚举。
- 另请参见:
-
elements()
,Enumeration
-
elements
public abstract Enumeration<V> elements()
返回此字典中值的枚举。elements
方法的常规合同是返回Enumeration
,它将生成此词典中条目中包含的所有元素。- 结果
- 此字典中的值的枚举。
- 另请参见:
-
keys()
,Enumeration
-
get
public abstract V get(Object key)
返回键在此字典中映射到的值。isEmpty
方法的常规合同是,如果此字典包含指定键的条目,则返回相关值; 否则,返回null
。- 参数
-
key
- 这本词典中的一个关键词。null
如果密钥未映射到此字典中的任何值。 - 结果
- 键在此字典中映射的值;
- 异常
-
NullPointerException
- 如果key
是null
。 - 另请参见:
-
put(java.lang.Object, java.lang.Object)
-
put
public abstract V put(K key, V value)
将指定的key
映射到此字典中的指定value
。 密钥和值都不能是null
。如果此字典已包含指定的
key
的条目,则在修改包含新元素的条目后,将返回此字典中该key
的值。如果此字典还没有指定
key
的条目,则会为指定的key
和value
创建一个条目,并返回null
。该
value
可以通过调用被检索get
方法与key
等于原始key
。- 参数
-
key
- 哈希表键。 -
value
- 价值。 - 结果
-
key
在此字典中映射到的上一个值,如果该键没有先前的映射,null
。 - 异常
-
NullPointerException
- 如果key
或value
是null
。 - 另请参见:
-
Object.equals(java.lang.Object)
,get(java.lang.Object)
-
remove
public abstract V remove(Object key)
从此词典中删除key
(及其对应的value
)。 如果key
不在此词典中,则此方法不执行任何操作。- 参数
-
key
- 需要删除的密钥。 - 结果
-
key
在此字典中映射的值,如果密钥没有映射,null
。 - 异常
-
NullPointerException
- 如果key
是null
。
-
-