Dictionary
java.lang.Object
|—java.util.Dictionary<K,V&
public abstract class Dictionary<K,V>
extends Object
Dictionary 类是任何类的抽象父类,例如 Hashtable,它将键映射到值。 每个键和每个值都是一个对象。 在任何一个 Dictionary 对象中,每个键最多与一个值相关联。 给定一个字典和一个键,可以查找相关的元素。 任何非空对象都可以用作键和值。
通常,此类的实现应使用 equals 方法来确定两个键是否相同。
注意:此类已过时。 新的实现应该实现 Map 接口,而不是扩展这个类。
构造函数摘要
构造函数 | 描述 |
---|---|
Dictionary() | 唯一的构造函数 |
方法总结
修饰符和类型 | 方法 | 描述 |
---|---|---|
abstract EnumerationV | elements() | 返回此字典中值的枚举。 |
abstract V | get(Object key) | 返回此字典中键映射到的值。 |
abstract boolean | isEmpty() | 测试此字典是否没有将键映射到值。 |
abstract EnumerationK | keys() | 返回此字典中键的枚举。 |
abstract V | put(K key, V value) | 将指定的键映射到此字典中的指定值。 |
abstract V | remove(Object key) | 从此字典中删除键(及其对应的值)。 |
abstract int | size() | 返回此字典中的条目数(不同的键)。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
构造函数详细信息
Dictionary
public Dictionary()
唯一的构造函数。 (用于子类构造函数的调用,通常是隐式的。)
方法详情
size
public abstract int size()
返回此字典中的条目数(不同的键)。
返回:
此字典中的键数。
isEmpty
public abstract boolean isEmpty()
测试此字典是否没有将键映射到值。 isEmpty 方法的一般约定是,当且仅当此字典不包含条目时,结果才为true。
返回:
如果此字典没有将键映射到值,则为 true; 否则为false。
keys
public abstract EnumerationK keys()
返回此字典中键的枚举。 keys 方法的一般约定是返回一个 Enumeration 对象,该对象将生成该字典包含条目的所有键。
返回:
此字典中键的枚举。
elements
public abstract EnumerationV elements()
返回此字典中值的枚举。 elements 方法的一般约定是返回一个 Enumeration ,它将生成该字典中条目中包含的所有元素。
返回:
此字典中的值的枚举。
get
public abstract V get(Object key)
返回此字典中键映射到的值。 isEmpty 方法的一般约定是,如果此字典包含指定键的条目,则返回关联的值; 否则,返回 null。
参数:
参数名称 | 参数描述 |
---|---|
key | 这本词典中的一个键。 如果键未映射到此字典中的任何值,则为 null。 |
返回:
键在此字典中映射到的值;
Throws:
Throw名称 | Throw描述 |
---|---|
NullPointerException | 如果键为空。 |
put
public abstract V put(K key, V value)
将指定的键映射到此字典中的指定值。 键和值都不能为空。
如果此字典已包含指定键的条目,则在修改条目以包含新元素后,返回此字典中已存在的该键的值。
如果此字典还没有指定键的条目,则为指定的键和值创建一个条目,并返回 null。
可以通过使用与原始键相同的键调用 get 方法来检索该值。
参数:
参数名称 | 参数描述 |
---|---|
key | 哈希表键。 |
value | 值 |
返回:
键在此字典中映射到的前一个值,如果键没有前一个映射,则返回 null。
Throws:
Throw名称 | Throw描述 |
---|---|
NullPointerException | 如果键或值为空。 |
remove
public abstract V remove(Object key)
从此字典中删除键(及其对应的值)。 如果键不在此字典中,则此方法不执行任何操作。
参数:
参数名称 | 参数描述 |
---|---|
key | 需要删除的密钥。 |
返回:
键在此字典中映射到的值,如果键没有映射,则返回 null。
Throws:
Throw名称 | Throw描述 |
---|---|
NullPointerException | 如果键为空。 |