Module  java.base
软件包  java.util

Class Dictionary<K,V>

  • 已知直接子类：
    Hashtable 

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

    通常，这个类的实现应该使用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如果这个字典不把键映射到值; false否则。

      • keys

        public abstract Enumeration<K> 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的条目， value为指定的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 。