public class HashMap<K,V> extends AbstractMap<K,V>  implements Map<K,V>, Cloneable, Serializable {

// table的初始大小默認(rèn)值，即桶個(gè)數(shù)，必須是2的乘方
    static final int DEFAULT_INITIAL_CAPACITY = 1 << 4; // aka 16
	// table的大小的最大值，即桶數(shù)的最大值
    static final int MAXIMUM_CAPACITY = 1 << 30;
	// 負(fù)載因子，建議0.5-1.5
    static final float DEFAULT_LOAD_FACTOR = 0.75f;
    // 當(dāng)某個(gè)桶內(nèi)元素個(gè)數(shù)大于等于此數(shù)，并且桶數(shù)大于64時(shí)，會(huì)將桶內(nèi)元素的存儲(chǔ)結(jié)構(gòu)由單鏈表改為紅黑樹
    static final int TREEIFY_THRESHOLD = 8;
    // 當(dāng)桶內(nèi)元素個(gè)數(shù)小于或者等于此數(shù)時(shí)，會(huì)將桶內(nèi)元素的存儲(chǔ)結(jié)構(gòu)由紅黑樹改為單鏈表
    static final int UNTREEIFY_THRESHOLD = 6;
     // 若table的大小小于MIN_TREEIFY_CAPACITY 時(shí)，即便某個(gè)桶內(nèi)的元素個(gè)數(shù)達(dá)到了TREEIFY_THRESHOLD 后，也并不會(huì)對(duì)這個(gè)桶做樹化操作，而是對(duì)map進(jìn)行擴(kuò)容resize()
    static final int MIN_TREEIFY_CAPACITY = 64;

static class Node<K,V> implements Map.Entry<K,V> {
        final int hash;
        final K key;
        V value;
        Node<K,V> next;
        Node(int hash, K key, V value, Node<K,V> next) {
            this.hash = hash;
            this.key = key;
            this.value = value;
            this.next = next;
        }
        public final K getKey()        { return key; }
        public final V getValue()      { return value; }
        public final String toString() { return key + "=" + value; }
        public final int hashCode() {
            return Objects.hashCode(key) ^ Objects.hashCode(value);
        }
        public final V setValue(V newValue) {
            V oldValue = value;
            value = newValue;
            return oldValue;
        }
        public final boolean equals(Object o) {
            if (o == this)
                return true;
            if (o instanceof Map.Entry) {
                Map.Entry<?,?> e = (Map.Entry<?,?>)o;
                if (Objects.equals(key, e.getKey()) &&
                    Objects.equals(value, e.getValue()))
                    return true;
            }
            return false;
        }
    }

 /* ---------------- Fields -------------- */
	// 裝桶的數(shù)組，存儲(chǔ)每個(gè)桶內(nèi)的單鏈表的頭結(jié)點(diǎn)或者樹的根節(jié)點(diǎn)
    transient Node<K,V>[] table;
    transient Set<Map.Entry<K,V>> entrySet;
    // Map中當(dāng)前實(shí)際存儲(chǔ)的元素個(gè)數(shù)
    transient int size;
	// 每次remove,add等都會(huì)++modCount，當(dāng)并發(fā)時(shí)，發(fā)現(xiàn)自己的modCount不是原來(lái)的了，就會(huì)拋出異常，表示并行修改失敗
    transient int modCount;
	// 閾值：當(dāng)map中的元素個(gè)數(shù)大于等于threshold時(shí)，會(huì)觸發(fā)resize()操作進(jìn)行擴(kuò)容。
    int threshold;
	// 負(fù)載因子：當(dāng)用戶調(diào)用的默認(rèn)無(wú)參構(gòu)造函數(shù)、或者map自動(dòng)擴(kuò)容時(shí)，新的threshold=新table的capacity*loadFactor;
    final float loadFactor;

  /* --------------------------構(gòu)造函數(shù)，不會(huì)初始化table數(shù)組，table數(shù)組只有在首次調(diào)用put方法時(shí)才會(huì)被初始化------ */
    // 默認(rèn)構(gòu)造函數(shù)，只設(shè)置了負(fù)載因子的默認(rèn)值
   public HashMap() {
        this.loadFactor = DEFAULT_LOAD_FACTOR; // all other fields defaulted
    }
	public HashMap(int initialCapacity) {
        this(initialCapacity, DEFAULT_LOAD_FACTOR);
    }    
    // 初始化loadFactor 、threshold 的值
    // threshold = 大于initialCapacity的最小的2乘方（如，15 ->16 ,13->16）
 public HashMap(int initialCapacity, float loadFactor) {
       ...
        this.loadFactor = loadFactor;
        this.threshold = tableSizeFor(initialCapacity);
    }
    // 計(jì)算出大于cap的最小的2的乘方
    static final int tableSizeFor(int cap) {
        int n = cap - 1;
        n |= n >>> 1;  // 00001 0010 | 0000 1001 -> 11011
        n |= n >>> 2;  //  0001 1011 | 0000 0110 -> 11111
        n |= n >>> 4;  //  0001 1111 | 0000 0001 -> 11111
        n |= n >>> 8;  //  
        n |= n >>> 16;
        return (n < 0) ? 1 : (n >= MAXIMUM_CAPACITY) ? MAXIMUM_CAPACITY : n + 1;
    }

    /* ------------------------------put方法------------------------------------------ */
    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;   // 頭結(jié)點(diǎn)
        int n, i;  // n：table的大小。i：新節(jié)點(diǎn)的桶號(hào)
        // 如果還未被初始化過(guò)，則調(diào)用resize(); HashMap在首次調(diào)用put方法之前，是不會(huì)初始化table的，因?yàn)槟菢拥脑挄?huì)浪費(fèi)一塊連續(xù)內(nèi)存。
        if ((tab = table) == null || (n = tab.length) == 0)
            n = (tab = resize()).length;
        // 根據(jù)key的哈希值，確定桶號(hào)，如果桶中還沒(méi)有元素，則直接將其作為頭結(jié)點(diǎn)存儲(chǔ)到桶中
        if ((p = tab[i = (n - 1) & hash]) == null)
            tab[i] = newNode(hash, key, value, null);
        // 獲取到了頭結(jié)點(diǎn)
        else {
            Node<K,V> e; // 目標(biāo)節(jié)點(diǎn)）
            K k;
            // 如果頭結(jié)點(diǎn)的key和新節(jié)點(diǎn)的key相同，則頭結(jié)點(diǎn)即為要被取代的目標(biāo)節(jié)點(diǎn)
            if (p.hash == hash &&
                ((k = p.key) == key || (key != null && key.equals(k))))
                e = p;
            // 如果頭結(jié)點(diǎn)是TreeNode類型的，則調(diào)用putTreeVal方法將新節(jié)點(diǎn)插入，并返回插入后的目標(biāo)節(jié)點(diǎn)
            else if (p instanceof TreeNode)
                e = ((TreeNode<K,V>)p).putTreeVal(this, tab, hash, key, value);
			// 桶還未滿
            else {
                for (int binCount = 0; ; ++binCount) {
                	// 目標(biāo)指針指向鏈表中的下一個(gè)元素
                    if ((e = p.next) == null) {
                    	// 如果沒(méi)有找到key相同的節(jié)點(diǎn)，就直接追加到鏈表尾部
                        p.next = newNode(hash, key, value, null);
                        // 如果桶中元素?cái)?shù)是達(dá)到了設(shè)定的變樹閾值（默認(rèn)值8），則需要將桶內(nèi)元素的存儲(chǔ)結(jié)構(gòu)更新為紅黑樹
                        if (binCount >= TREEIFY_THRESHOLD - 1) // -1 for 1st
                            treeifyBin(tab, hash);
                        break;
                    }
                    // 如果鏈表中有和新節(jié)點(diǎn)的key相同的元素
                    if (e.hash == hash &&
                        ((k = e.key) == key || (key != null && key.equals(k))))
                        break;
                    p = e;
                }
            }
            // map中有與新節(jié)點(diǎn)的key相同的元素，那么根據(jù)條件做一些操作，就返回
            if (e != null) { // existing mapping for key
                V oldValue = e.value;
                // onlyIfAbsent 是方法參數(shù)，表示只有不存在相同key的節(jié)點(diǎn)時(shí)，才進(jìn)行更新操作，如果有相同節(jié)點(diǎn)，則不做任何操作。
                if (!onlyIfAbsent || oldValue == null)
                    e.value = value;
                afterNodeAccess(e);  //此處是留給LinkedHashMap用的。
                return oldValue;
            }
        } // else結(jié)束
        // 更新了hashMap，就執(zhí)行++modCount;
        ++modCount;
        // 當(dāng)map中的元素?cái)?shù)量大于閾值，就要擴(kuò)容再散列
        if (++size > threshold)
            resize();
        afterNodeInsertion(evict);
        return null;
    }

    final Node<K,V>[] resize() {
    	// 當(dāng)前table
        Node<K,V>[] oldTab = table;
        // 當(dāng)前table的大小
        int oldCap = (oldTab == null) ? 0 : oldTab.length;
        // 當(dāng)前的閾值
        int oldThr = threshold;
        int newCap, newThr = 0;
        // oldCap>0，說(shuō)明是要做擴(kuò)容操作
        if (oldCap > 0) {
	        // 如果原本的table的大小已經(jīng)是最大值，無(wú)法繼續(xù)擴(kuò)容，直接退出
            if (oldCap >= MAXIMUM_CAPACITY) {
                threshold = Integer.MAX_VALUE;
                return oldTab;
            }
            // 擴(kuò)容：設(shè)置新的table的大小為原來(lái)的2倍，新的threshold也為原來(lái)的2背
            else if ((newCap = oldCap << 1) < MAXIMUM_CAPACITY &&
                     oldCap >= DEFAULT_INITIAL_CAPACITY)
                newThr = oldThr << 1; // double threshold
        }
        // oldCap<= 0，說(shuō)明table還未被初始化過(guò)，要進(jìn)行初始化table的操作；oldThr>0，說(shuō)明用戶調(diào)用的有參構(gòu)造函數(shù)，設(shè)置了threshold；直接將根據(jù)用戶參數(shù)計(jì)算出的閾值設(shè)定為table的大小
        else if (oldThr > 0) // initial capacity was placed in threshold
            newCap = oldThr;
        // oldCap<= 0，說(shuō)明是要進(jìn)行初始化table的操作；oldThr<0，說(shuō)明用戶調(diào)用的默認(rèn)無(wú)參構(gòu)造函數(shù)；則將各個(gè)域變量的值設(shè)置為默認(rèn)值。
        else {               // zero initial threshold signifies using defaults
            newCap = DEFAULT_INITIAL_CAPACITY;
            newThr = (int)(DEFAULT_LOAD_FACTOR * DEFAULT_INITIAL_CAPACITY);
        }
        // 如果經(jīng)過(guò)以上設(shè)置，newThr 仍為0,（什么情況下會(huì)出現(xiàn)？）
        if (newThr == 0) {
            float ft = (float)newCap * loadFactor;
            newThr = (newCap < MAXIMUM_CAPACITY && ft < (float)MAXIMUM_CAPACITY ?
                      (int)ft : Integer.MAX_VALUE);
        }
        threshold = newThr;
		// 無(wú)論是要初始化table，還是要對(duì)table進(jìn)行擴(kuò)容，經(jīng)過(guò)以上邏輯，都已經(jīng)確定了要新創(chuàng)建的table的大小、threshold 。
        @SuppressWarnings({"rawtypes","unchecked"})
            Node<K,V>[] newTab = (Node<K,V>[])new Node[newCap];
        table = newTab;
        // 如果當(dāng)前table不為null，說(shuō)明需要進(jìn)行擴(kuò)容操作
        if (oldTab != null) {
            for (int j = 0; j < oldCap; ++j) {
                Node<K,V> e;
                if ((e = oldTab[j]) != null) {
                    oldTab[j] = null;
                    if (e.next == null)
                        newTab[e.hash & (newCap - 1)] = e;
                    else if (e instanceof TreeNode)
                        ((TreeNode<K,V>)e).split(this, newTab, j, oldCap);
                    else { // preserve order
                        Node<K,V> loHead = null, loTail = null;
                        Node<K,V> hiHead = null, hiTail = null;
                        Node<K,V> next;
                        do {
                            next = e.next;
                            if ((e.hash & oldCap) == 0) {
                                if (loTail == null)
                                    loHead = e;
                                else
                                    loTail.next = e;
                                loTail = e;
                            }
                            else {
                                if (hiTail == null)
                                    hiHead = e;
                                else
                                    hiTail.next = e;
                                hiTail = e;
                            }
                        } while ((e = next) != null);
                        if (loTail != null) {
                            loTail.next = null;
                            newTab[j] = loHead;
                        }
                        if (hiTail != null) {
                            hiTail.next = null;
                            newTab[j + oldCap] = hiHead;
                        }
                    }
                }
            }
        }
        return newTab;
    }