Java集合源码分析（二十）-Dictionary

持续创作，加速成长！这是我参与「掘金日新计划 · 6 月更文挑战」的第11天，点击查看活动详情

源码

package java.util;

public abstract
class Dictionary<K,V> {

    public Dictionary() {
    }

    abstract public int size();

    abstract public boolean isEmpty();

    abstract public Enumeration<K> keys();

    abstract public Enumeration<V> elements();

    abstract public V get(Object key);

    abstract public V put(K key, V value);

    abstract public V remove(Object key);
}

注释内容

• Dictionary 类是任何类的抽象父类，例如 Hashtable，映射 key 到 value。每个 key 和每个 value 是对象。在任何一个 Dictionary 对象，每个 key 最多关联一个 value。给一个 Dictionary 和一个 key，可以查找关联的元素，任何 non-null 对象都可以被用作 key 和 value
• 通常，这个类的实现使用 equals 方法去判断两个 key 是否相等
• 注意：此类已废弃。新的实现应该实现 Map 接口，而不是扩展这个类

方法

• public Dictionary()：唯一构造器（对于子类构造器的调用，通常是隐式的）
• abstract public int size()：返回的这个 dictionary 中 （不同 key）entry 的数量
• abstract public boolean isEmpty()：测试这个字典是否没有映射 key 到 value。isEmpty 方法的通常约定是，当且仅当这个 dictionary 没有包含 entry 时，结果为 true
• abstract public Enumeration<K> keys()：返回这个 dictionary 中 key 的枚举值。keys 方法一般约定返回 Enumeration 对象，这个枚举对象将生成这个 dictionary 包含所有 entry 的 key
• abstract public Enumeration<V> elements()：返回这个 dictionary 中 value 的枚举值。elements 方法一般约定返回一个 Enumeration，这个 Enumeration 将生成所有被这个 dictionary 的 entry 包含的 element
• abstract public V get(Object key)：返回在这个 dictionary 中 key 映射的 value。isEmpty 方法一般约定是，如果这个 dictionary 包含指定 key 的 entry，返回关联值，否则返回 null
• abstract public V put(K key, V value)：映射指定 key 到这个 dictionary 的指定 value。key 和 value 不能为 null
  • 如果这个 dictionary 已经包含了指定 key 的 entry，返回已经在这个 dictionary 该 key 的 value ，修改后，entry 包含新元素。如果这个 dictionary 还没有指定 key 的 entry，为指定 key 和 value 创建一个 entry，并且返回 null
  • value 可以通过使用与初始 key 相同的 key 调用 get 方法获取
• abstract public V remove(Object key)：从这个 dictionary 移除 key（和它相应的值）。这个方法不做任何事，如果 key 不在这个 dictionary