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

5
final V putVal(int hash, K key, V value, boolean onlyIfAbsent,
6
                   boolean evict) {
7
    Node<K,V>[] tab; Node<K,V> p; int n, i;
8
    //判断数组是否未初始化
9
    if ((tab = table) == null || (n = tab.length) == 0)
10
        //如果未初始化，调用resize方法 进行初始化
11
        n = (tab = resize()).length;
12
    //通过 & 运算求出该数据（key）的数组下标并判断该下标位置是否有数据
13
    if ((p = tab[i = (n - 1) & hash]) == null)
14
        //如果没有，直接将数据放在该下标位置
15
        tab[i] = newNode(hash, key, value, null);
16
    //该数组下标有数据的情况
17
    else {
18
        Node<K,V> e; K k;
19
        //判断该位置数据的key和新来的数据是否一样
20
        if (p.hash == hash &&
21
            ((k = p.key) == key || (key != null && key.equals(k))))
22
            //如果一样，证明为修改操作，该节点的数据赋值给e,后边会用到
23
            e = p;
24
        //判断是不是红黑树
25
        else if (p instanceof TreeNode)
26
            //如果是红黑树的话，进行红黑树的操作
27
            e = ((TreeNode<K,V>)p).putTreeVal(this, tab, hash, key, value);
28
        //新数据和当前数组既不相同，也不是红黑树节点，证明是链表
29
        else {
30
            //遍历链表
31
            for (int binCount = 0; ; ++binCount) {
32
                //判断next节点，如果为空的话，证明遍历到链表尾部了
33
                if ((e = p.next) == null) {
34
                    //把新值放入链表尾部
35
                    p.next = newNode(hash, key, value, null);
36
                    //因为新插入了一条数据，所以判断链表长度是不是大于等于8
37
                    if (binCount >= TREEIFY_THRESHOLD - 1) // -1 for 1st
38
                        //如果是，进行转换红黑树操作
39
                        treeifyBin(tab, hash);
40
                    break;
41
                }
42
                //判断链表当中有数据相同的值，如果一样，证明为修改操作
43
                if (e.hash == hash &&
44
                    ((k = e.key) == key || (key != null && key.equals(k))))
45
                    break;
46
                //把下一个节点赋值为当前节点
47
                p = e;
48
            }
49
        }
50
        //判断e是否为空（e值为修改操作存放原数据的变量）
51
        if (e != null) { // existing mapping for key
52
            //不为空的话证明是修改操作，取出老值
53
            V oldValue = e.value;
54
            //一定会执行  onlyIfAbsent传进来的是false
55
            if (!onlyIfAbsent || oldValue == null)
56
                //将新值赋值当前节点
57
                e.value = value;
58
            afterNodeAccess(e);
59
            //返回老值
60
            return oldValue;
61
        }
62
    }
63
    //计数器，计算当前节点的修改次数
64
    ++modCount;
65
    //当前数组中的数据数量如果大于扩容阈值
66
    if (++size > threshold)
67
        //进行扩容操作
68
        resize();
69
    //空方法
70
    afterNodeInsertion(evict);
71
    //添加操作时 返回空值
72
    return null;
73
}