当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
java.util
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
Dictionary (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
java.util
类 Dictionary<K,V>
java.lang.Objectjava.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 |
| 构造方法详细信息 |
|---|
Dictionary
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。
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。