模块  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
    另请参见:
    MapObject.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 - 如果 keynull
        另请参见:
        put(java.lang.Object, java.lang.Object)
      • put

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

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

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

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

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

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