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	如果键为空。