JDK8 HashMap.put()方法解读

复习一下基础,顺便给HashMap的Put方法加一个详细的注释

final V putVal(int hash, K key, V value, boolean onlyIfAbsent,
                   boolean evict) {
        //这个tab就是成员变量里的table
        HashMap.Node<K,V>[] tab; 
        //这个就是数组上的链表,当桶上的对象太多的时候 就会转换成红黑树
        HashMap.Node<K,V> p; 
        int n, i;
        // 如果tab数组未被初始化,初始化该数组
        if ((tab = table) == null || (n = tab.length) == 0)
            n = (tab = resize()).length;
        // 如果key没有存在过直接放到tab数组中
        if ((p = tab[i = (n - 1) & hash]) == null){
            tab[i] = newNode(hash, key, value, null);
        }else {
            //新的链表
            HashMap.Node<K,V> e; 
            K k;
            //如果put的key和hash恰好与对应桶的首个对象一样,那么可以不用考虑直接替换
            if (p.hash == hash && ((k = p.key) == key || (key != null && key.equals(k))))
                e = p;
            //如果Node的类型是红黑树将值更新到树中
            else if (p instanceof HashMap.TreeNode)
                e = ((HashMap.TreeNode<K,V>)p).putTreeVal(this, tab, hash, key, value);
            else {
                // 依次遍历链表,binCount主要用来判断什么时候由链表转换成红黑树
                for (int binCount = 0; ; ++binCount) {
                    // 如果遍历到链表末端,还没有插到链表中
                    if ((e = p.next) == null) {
                        //生成一个新的节点,放到链表的末尾
                        p.next = newNode(hash, key, value, null);
                        // 如果链表长度大于 8-1 则转换成红黑树
                        if (binCount >= TREEIFY_THRESHOLD - 1) // -1 for 1st
                            treeifyBin(tab, hash);
                        break;
                    }
                    // e.hash就是p.next,那么e.hash如果与要put的key碰撞到,那么跟直接跳出,此处的逻辑判断与桶首个对象的判断逻辑一样
                    if (e.hash == hash && ((k = e.key) == key || (key != null && key.equals(k))))
                        break;
                    //如果没找到相同的key和hash 那么将e赋值为当前p,让他到下次循环中
                    p = e;
                }
            }
            // e!=null 代表原来Map中存在这个key
            if (e != null) { // existing mapping for key
                V oldValue = e.value;
                // 如果onlyIfAbsent=false,或者old_Value=null,不产生新的对象,直接替换value,默认是直接替换
                if (!onlyIfAbsent || oldValue == null)
                    e.value = value;
                //将这个元素放到链表尾部 1.7之前是头插
                afterNodeAccess(e);
                return oldValue;
            }
        }
        ++modCount;
        // 如果桶的数量超过阈值
        if (++size > threshold)
            //重新分布桶,如果多线程的时候  会出现循环链表的情况,造成CPU升高,值错乱
            resize();
        afterNodeInsertion(evict);
        return null;
    }