​

    public V put(K key, V value) {
        return putVal(hash(key), key, value, false, true);
    }


    final V putVal(int hash, K key, V value, boolean onlyIfAbsent,
                   boolean evict) {
        Node<K,V>[] tab; Node<K,V> p; int n, i;
        // 判断数组是否未初始化
        if ((tab = table) == null || (n = tab.length) == 0)
            // 未初始化，调用resize()方法，进行初始化操作
            n = (tab = resize()).length;
        // 通过 & 计算出该数据（key）的数组下标并判断该下标位置是否有数据
        if ((p = tab[i = (n - 1) & hash]) == null)
            // 如果没有，直接将数据放在该下标位置
            tab[i] = newNode(hash, key, value, null);
        else {// 该数组下标有数据的情况
            Node<K,V> e; K k;
            // 判断该位置数据的key是否和待插入Key匹配
            if (p.hash == hash &&
                ((k = p.key) == key || (key != null && key.equals(k))))
                /*
                 * 如果一样，证明为修改操作，该节点的数据赋值给e,后面会用
                 * 注：
                 *    变量 e 是 Node<K,V> 类型，用于存储匹配到的旧节点
                 *    若 e != null，说明 Key 已存在，后续会覆盖旧值；若 e == null，说明 Key 不存在，会新增节点
                 * */
                e = p;
            else if (p instanceof TreeNode)// 判断是否为红黑树
                // 如果为红黑树，执行红黑树的操作
                e = ((TreeNode<K,V>)p).putTreeVal(this, tab, hash, key, value);
            else {
                // 待插入的key与当前位置数据的key不相同，也不是红黑树节点，则为链表，
                // 遍历链表
                for (int binCount = 0; ; ++binCount) {
                    // 判断next节点，如果为空的话，证明遍历到链表尾部了
                    if ((e = p.next) == null) {
                        // 把新值放入到链表尾部
                        p.next = newNode(hash, key, value, null);
                        // 因为插入了一条数据，所以判断链表长度是不是大于等于8
                        if (binCount >= TREEIFY_THRESHOLD - 1) // -1 for 1st
                            // 如果是，进行红黑树的转换操作
                            treeifyBin(tab, hash);
                        break;
                    }
                    // 判断链表当中有数据相同的值，如果一样，证明为修改操作
                    if (e.hash == hash &&
                        ((k = e.key) == key || (key != null && key.equals(k))))
                        break;
                    // 把下一个节点赋值为当前节点
                    p = e;
                }
            }
            // 判断e是否为空（变量 e 是 Node<K,V> 类型，用于存储匹配到的旧节点）
            if (e != null) { // existing mapping for key
                // 不为空的话证明是修改操作，取出旧值
                V oldValue = e.value;
                // 一定会执行（因为onlyIfAbsent 传进方法来的是false）
                if (!onlyIfAbsent || oldValue == null)
                    // 将新值赋值当前节点
                    e.value = value;
                afterNodeAccess(e);
                // 返回旧值
                return oldValue;
            }
        }
        // 计数器，计算当前节点的修改次数
        ++modCount;
        // 当前数组中的数据数量如果大于扩容阈值
        if (++size > threshold)
            // 进行扩容操作
            resize();
        // 一个空方法，方法中无代码
        afterNodeInsertion(evict);
        // 添加操作时，返回空值
        return null;
    }