模块  java.base
软件包  java.util

Class Dictionary<K,​V>

  • 已知直接子类：
    Hashtable 
    public abstract class Dictionary<K,​V>
extends Object
    Dictionary类是任何类的抽象父类，例如Hashtable ，它将键映射到值。 每个键和每个值都是一个对象。 在任何一个Dictionary对象中，每个键最多与一个值相关联。 给定Dictionary和一个键，可以查找关联的元素。 任何非null对象都可以用作键和值。

    通常， equals的实现应使用equals方法来确定两个键是否相同。

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

    从以下版本开始：
    1.0
    另请参见：
    Map ， Object.equals(java.lang.Object) ， Object.hashCode() ， Hashtable

    • 构造方法详细信息

      • Dictionary

        public Dictionary()
        唯一的构造函数。 （对于子类构造函数的调用，通常是隐式的。）

    • 方法详细信息

      • size

        public abstract int size()
        返回此字典中的条目数（不同的键）。
        结果
        这本词典中的键数。

      • isEmpty

        public abstract boolean isEmpty()
        测试此字典是否将键没有映射到值。 isEmpty方法的常规合同是，当且仅当此字典不包含任何条目时，结果为true。
        结果
        true如果此字典没有将键映射到值; 否则为false 。

      • keys

        public abstract Enumeration<K> keys()
        返回此字典中键的枚举。 keys方法的一般合同是返回一个Enumeration对象，它将生成此字典包含条目的所有键。
        结果
        此字典中键的枚举。
        另请参见：
        elements() ， Enumeration

      • elements

        public abstract Enumeration<V> elements()
        返回此字典中值的枚举。 elements方法的常规合同是返回Enumeration ，它将生成此词典中条目中包含的所有元素。
        结果
        此字典中的值的枚举。
        另请参见：
        keys() ， Enumeration

      • get

        public abstract V get​(Object key)
        返回键在此字典中映射到的值。 isEmpty方法的常规合同是，如果此字典包含指定键的条目，则返回相关值; 否则，返回null 。
        参数
        key - 这本词典中的一个关键词。 null如果密钥未映射到此字典中的任何值。
        结果
        键在此字典中映射的值;
        异常
        NullPointerException - 如果 key是 null 。
        另请参见：
        put(java.lang.Object, java.lang.Object)

      • put

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

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

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

        该value可以通过调用被检索get方法与key等于原始key 。

        参数
        key - 哈希表键。
        value - 价值。
        结果
        key在此字典中映射到的上一个值，如果该键没有先前的映射， null 。
        异常
        NullPointerException - 如果 key或 value是 null 。
        另请参见：
        Object.equals(java.lang.Object) ， get(java.lang.Object)

      • remove

        public abstract V remove​(Object key)
        从此词典中删除key （及其对应的value ）。 如果key不在此词典中，则此方法不执行任何操作。
        参数
        key - 需要删除的密钥。
        结果
        key在此字典中映射的值，如果密钥没有映射， null 。
        异常
        NullPointerException - 如果 key是 null 。