Module java.base
Package java.util

Class Dictionary<K,V>

java.lang.Object
java.util.Dictionary<K,V>
类型参数:
K - 键的类型
V - 映射值的类型
直接已知子类:
Hashtable
public abstract class Dictionary<K,V> extends Object
Dictionary 类是任何类（如 Hashtable）的抽象父类，它将键映射到值。每个键和每个值都是对象。在任何一个 Dictionary 对象中，每个键最多关联一个值。给定一个 Dictionary 和一个键，可以查找关联的元素。任何非 null 对象都可以用作键和值。

通常情况下，此类的实现应该使用 equals 方法来判断两个键是否相同。

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

自 JDK 版本:
1.0
参见:

  • Constructor Summary

    Constructors
    Constructor
    Description
    Dictionary()
    唯一构造函数。

  • Method Summary

    Modifier and Type
    Method
    Description
    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()
    返回此字典中条目（不同键）的数量。

    Methods declared in class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Constructor Details

    • Dictionary

      public Dictionary()
      唯一构造函数。（通常由子类构造函数隐式调用。）

  • Method Details

    • size

      public abstract int size()
      返回此字典中条目（不同键）的数量。
      返回:
      此字典中键的数量。

    • isEmpty

      public abstract boolean isEmpty()
      检查此字典是否未将任何键映射到值。 isEmpty 方法的一般约定是，当且仅当此字典不包含任何条目时结果为 true。
      返回:
      如果此字典未将任何键映射到值，则返回 true；否则返回 false。

    • keys

      public abstract Enumeration<K> keys()
      返回此字典中键的枚举。 keys 方法的一般约定是返回一个 Enumeration 对象，该对象将生成此字典中包含条目的所有键。
      返回:
      此字典中键的枚举。
      参见:

    • elements

      public abstract Enumeration<V> elements()
      返回此字典中值的枚举。 elements 方法的一般约定是返回一个 Enumeration，该枚举将生成此字典中条目中包含的所有元素。
      返回:
      此字典中值的枚举。
      参见:

    • get

      public abstract V get(Object key)
      返回此字典中键映射的值。 isEmpty 方法的一般约定是，如果此字典包含指定键的条目，则返回关联的值；否则返回 null。
      参数:
      key - 此字典中的键。如果键未映射到此字典中的任何值，则为 null。
      返回:
      此字典中键映射的值；
      抛出:
      NullPointerException - 如果 key 为 null。
      参见:

    • put

      public abstract V put(K key, V value)
      在此字典中将指定的 key 映射到指定的 value。键和值都不能为 null。

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

      如果此字典尚未包含指定 key 的条目，则为指定的 key 和 value 创建一个条目，并返回 null。

      可以通过调用具有等于原始 key 的 key 的 get 方法来检索 value。

      参数:
      key - 哈希表的键。
      value - 值。
      返回:
      此字典中先前映射到 key 的值，如果键没有先前映射，则返回 null。
      抛出:
      NullPointerException - 如果 key 或 value 为 null。
      参见:

    • remove

      public abstract V remove(Object key)
      从此字典中删除 key（及其对应的 value）。如果 key 不在此字典中，则此方法不执行任何操作。
      参数:
      key - 需要被移除的键。
      返回:
      此字典中先前映射到 key 的值，如果键没有映射，则返回 null。
      抛出:
      NullPointerException - 如果 key 为 null。