Dictionary

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.util
类 Dictionary<K,V>

java.lang.Object
  java.util.Dictionary<K,V>

直接已知子类：: Hashtable

public abstract class Dictionary<K,V>
extends Object

Dictionary 类是任何可将键映射到相应值的类（如 Hashtable）的抽象父类。每个键和每个值都是一个对象。在任何一个 Dictionary 对象中，每个键至多与一个值相关联。给定一个 Dictionary 和一个键，就可以查找所关联的元素。任何非 null 对象都可以用作键或值。

通常，应该在此类的实现中使用 equals 方法，以决定两个键是否相同。

注：此类已过时。新的实现应该实现 Map 接口，而不是扩展此类。

从以下版本开始：: JDK1.0
另请参见：: Map, Object.equals(java.lang.Object), Object.hashCode(), Hashtable

构造方法摘要
`Dictionary()` 单独的构造方法。

方法摘要
`abstract Enumeration<V>`	`elements()` 返回此 dictionary 中值的枚举。
`abstract V`	`get(Object key)` 返回此 dictionary 中该键所映射到的值。
`abstract boolean`	`isEmpty()` 测试此 dictionary 是否不存在从键到值的映射。
`abstract Enumeration<K>`	`keys()` 返回此 dictionary 中的键的枚举。
`abstract V`	`put(K key, V value)` 将指定 `key` 映射到此 dictionary 中指定 `value`。
`abstract V`	`remove(Object key)` 从此 dictionary 中移除 `key` （及其相应的 `value`）。
`abstract int`	`size()` 返回此 dictionary 中条目（不同键）的数量。

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

构造方法详细信息

public Dictionary()

单独的构造方法。（由子类构造方法调用，通常是隐式的。）

方法详细信息

size

public abstract int size()

返回此 dictionary 中条目（不同键）的数量。

返回：: 此 dictionary 中的键数。

isEmpty

public abstract boolean isEmpty()

测试此 dictionary 是否不存在从键到值的映射。isEmpty 方法的常规协定是，当且仅当此 dictionary 不包含条目时，结果为 true。

返回：: 如果此 dictionary 不存在从键到值的映射，则返回 true；否则返回 false。

keys

public abstract Enumeration<K> keys()

返回此 dictionary 中的键的枚举。键方法的常规协定是返回 Enumeration 对象，该对象将生成此 dictionary 包含条目的所有键。

返回：: 此 dictionary 中键的枚举。
另请参见：: elements(), Enumeration

elements

public abstract Enumeration<V> elements()

返回此 dictionary 中值的枚举。elements 方法的常规协定是返回 Enumeration 对象，该对象将生成此 dictionary 中包含条目的所有元素。

返回：: 此 dictionary 中值的枚举。
另请参见：: keys(), Enumeration

get

public abstract V get(Object key)

返回此 dictionary 中该键所映射到的值。isEmpty 方法的常规协定是，如果此 dictionary 包含所指定键的条目，则返回该键所关联的值；否则，返回 null。

参数：: key - 此 dictionary 中的一个键。如果该键没有映射到此 dictionary 中任何值，则返回 null。
返回：: 此 dictionary 中该键所映射到的值；
抛出：: NullPointerException - 如果该 key 为 null。
另请参见：: put(java.lang.Object, java.lang.Object)

put

public abstract V put(K key,
                      V value)

将指定 key 映射到此 dictionary 中指定 value。键和值均不能为 null。

如果此 dictionary 已经包含指定 key 的条目，则在修改条目以包含新元素之后，返回该 key 在此 dictionary 中已有的值。

如果此 dictionary 还没有指定 key 的条目，则为指定 key 和 value 创建条目，并返回 null。

可以通过调用 get 方法来获取 value，使用的 key 与原来的 key 相等。

参数：: key - 哈希表键。; value - 值。

返回：

以前该 key 在此 dictionary 中被映射到的值，如果该键没有以前的映射关系，则返回 null。

抛出：

NullPointerException - 如果 key 或 value 为 null。

另请参见：

Object.equals(java.lang.Object), get(java.lang.Object)

remove

public abstract V remove(Object key)

从此 dictionary 中移除 key （及其相应的 value）。如果该 key 不在此 dictionary 中，则该方法不执行任何操作。

参数：: key - 需要移除的键。
返回：: 该 key 在此 dictionary 中被映射到的值，如果该键没有以前的映射关系，则返回 null。
抛出：: NullPointerException - 如果 key 为 null。

概述