//hash桶中的結(jié)點(diǎn)Node,實(shí)現(xiàn)了Map.Entry
static class Node<K,V> implements Map.Entry<K,V> {
    final int hash;
    final K key;
    V value;
    Node<K,V> next; //鏈表的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; }
    //重寫(xiě)Object的hashCode
    public final int hashCode() {
        return Objects.hashCode(key) ^ Objects.hashCode(value);
    }
    public final V setValue(V newValue) {
        V oldValue = value;
        value = newValue;
        return oldValue;
    }
    //equals方法
    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;
    }
}
//轉(zhuǎn)變?yōu)榧t黑樹(shù)后的結(jié)點(diǎn)類(lèi)
static final class TreeNode<k,v> extends LinkedHashMap.Entry<k,v> {
    TreeNode<k,v> parent;  // 父節(jié)點(diǎn)
    TreeNode<k,v> left; //左子樹(shù)
    TreeNode<k,v> right;//右子樹(shù)
    TreeNode<k,v> prev;    // needed to unlink next upon deletion
    boolean red;    //顏色屬性
    TreeNode(int hash, K key, V val, Node<k,v> next) {
        super(hash, key, val, next);
    }
    //返回當(dāng)前節(jié)點(diǎn)的根節(jié)點(diǎn)
    final TreeNode<k,v> root() {
        for (TreeNode<k,v> r = this, p;;) {
            if ((p = r.parent) == null)
                return r;
            r = p;
        }
    }
}

//默認(rèn)初始化容量初始化=16
static final int DEFAULT_INITIAL_CAPACITY = 1 << 4; // aka 16
//最大容量 = 1 << 30
static final int MAXIMUM_CAPACITY = 1 << 30;
//默認(rèn)加載因子.一般HashMap的擴(kuò)容的臨界點(diǎn)是當(dāng)前HashMap的大小 > DEFAULT_LOAD_FACTOR * 
//DEFAULT_INITIAL_CAPACITY = 0.75F * 16
static final float DEFAULT_LOAD_FACTOR = 0.75f;
//當(dāng)hash桶中的某個(gè)bucket上的結(jié)點(diǎn)數(shù)大于該值的時(shí)候，會(huì)由鏈表轉(zhuǎn)換為紅黑樹(shù)
static final int TREEIFY_THRESHOLD = 8;
//當(dāng)hash桶中的某個(gè)bucket上的結(jié)點(diǎn)數(shù)小于該值的時(shí)候，紅黑樹(shù)轉(zhuǎn)變?yōu)殒湵?
static final int UNTREEIFY_THRESHOLD = 6;
//桶中結(jié)構(gòu)轉(zhuǎn)化為紅黑樹(shù)對(duì)應(yīng)的table的最小大小
static final int MIN_TREEIFY_CAPACITY = 64;
//hash算法,計(jì)算傳入的key的hash值，下面會(huì)有例子說(shuō)明這個(gè)計(jì)算的過(guò)程
static final int hash(Object key) {
    int h;
    return (key == null) ? 0 : (h = key.hashCode()) ^ (h >>> 16);
} 
//tableSizeFor(initialCapacity)返回大于initialCapacity的最小的二次冪數(shù)值。下面會(huì)有例子說(shuō)明
static final int tableSizeFor(int cap) {
    int n = cap - 1;
    n |= n >>> 1;
    n |= n >>> 2;
    n |= n >>> 4;
    n |= n >>> 8;
    n |= n >>> 16;
    return (n < 0) ? 1 : (n >= MAXIMUM_CAPACITY) ? MAXIMUM_CAPACITY : n + 1;
}
//hash桶
transient Node<K,V>[] table;
//保存緩存的entrySet
transient Set<Map.Entry<K,V>> entrySet;
//桶的實(shí)際元素個(gè)數(shù) != table.length
transient int size;
//擴(kuò)容或者更改了map的計(jì)數(shù)器。含義：表示這個(gè)HashMap結(jié)構(gòu)被修改的次數(shù)，結(jié)構(gòu)修改是那些改變HashMap中的映射數(shù)量或者
//修改其內(nèi)部結(jié)構(gòu)（例如，重新散列rehash）的修改。 該字段用于在HashMap失敗快速（fast-fail）的Collection-views
//上創(chuàng)建迭代器。
transient int modCount;
//臨界值，當(dāng)實(shí)際大小（cap*loadFactor）大于該值的時(shí)候，會(huì)進(jìn)行擴(kuò)充
int threshold;
//加載因子
final float loadFactor;

//hash算法
static final int hash(Object key) {
    int h;
    //key == null : 返回hash=0
    //key != null 
    //（1）得到key的hashCode：h=key.hashCode()
    //（2）將h無(wú)符號(hào)右移16位
    //（3）異或運(yùn)算：h ^ h>>>16
    return (key == null) ? 0 : (h = key.hashCode()) ^ (h >>> 16);
}   

//n=cap-1=5; 5的二進(jìn)制0101B。>>> 操作符表示無(wú)符號(hào)右移，高位取0
//n |= n>>>1: (1)n=0101 | 0101>>>1; (2)n=0101 | 0010; (3)n = 0111B 
//n |= n>>>2: (1)n=0111 | 0111>>>2; (2)n=0111 | 0011; (3)n = 0111B
//n |= n>>>4: (1)n=0111 | 0111>>>4; (2)n=0111 | 0000; (3)n = 0111B
//n |= n>>>8: (1)n=0111 | 0111>>>8; (2)n=0111 | 0000; (3)n = 0111B
//n |= n>>>16:(1)n=0111 | 0111>>>16;(2)n=0111 | 0000; (3)n = 0111B
static final int tableSizeFor(int cap) {
    int n = cap - 1;
    n |= n >>> 1;
    n |= n >>> 2;
    n |= n >>> 4;
    n |= n >>> 8;
    n |= n >>> 16;
    //n<0返回1
    //n>最大容量，返回最大容量
    //否則返回n+1(0111B+1B=1000B=8)
    return (n < 0) ? 1 : (n >= MAXIMUM_CAPACITY) ? MAXIMUM_CAPACITY : n + 1;
}

//至于這里為什么減1，當(dāng)傳入的cap為2的整數(shù)次冪的時(shí)候，減1即保證最后的計(jì)算結(jié)果還是cap，而不是大于cap的另一個(gè)2的
//整數(shù)次冪，例如我們傳入cap=16=10000B.按照上面那樣計(jì)算
//n=cap-1=15=1111B.按照上面的方法計(jì)算得到：
// n |= n>>>1: n=1111|0111=1111;后面還是相同的結(jié)果最后n=1111B=15.
//所以返回的時(shí)候?yàn)閞eturn 15+1;
int n = cap - 1; 

//（1）參數(shù)為初始化容量和加載因子的構(gòu)造函數(shù)
public HashMap(int initialCapacity, float loadFactor) {
    if (initialCapacity < 0)
        throw new IllegalArgumentException("Illegal initial capacity: " +
                                           initialCapacity);
    if (initialCapacity > MAXIMUM_CAPACITY)
        initialCapacity = MAXIMUM_CAPACITY;
    if (loadFactor <= 0 || Float.isNaN(loadFactor))
        throw new IllegalArgumentException("Illegal load factor: " +
                                           loadFactor);
    this.loadFactor = loadFactor;
    this.threshold = tableSizeFor(initialCapacity); //閾值為大于initialCapacity的最小二次冪
}
//（2）只給定初始化容量，那么加載因子就是默認(rèn)的加載因子：0.75
public HashMap(int initialCapacity) {
    this(initialCapacity, DEFAULT_LOAD_FACTOR);
}
//（3）加載因子為默認(rèn)的加載因子，但是這個(gè)時(shí)候的初始化容量是沒(méi)有指定的，后面調(diào)用put或者get方法的時(shí)候才resize
public HashMap() {
    this.loadFactor = DEFAULT_LOAD_FACTOR; // all other fields defaulted
}
//（4）將傳遞的map中的值調(diào)用putMapEntries加入新的map集合中，其中加載因子是默認(rèn)的加載因子
public HashMap(Map<? extends K, ? extends V> m) {
    this.loadFactor = DEFAULT_LOAD_FACTOR;
    putMapEntries(m, false);
}

//計(jì)算map中key的hash值
static final int hash(Object key) {
    int h;
    return (key == null) ? 0 : (h = key.hashCode()) ^ (h >>> 16);
}
//這一小段代碼就是定位元素在桶中的位置。具體做法就是：容量n-1 & hash. 
//其中n是一個(gè)2的整數(shù)冪，而(n - 1) & hash其實(shí)質(zhì)就是hash%n,但
//是取余運(yùn)算的效率不如位運(yùn)算與，并且(n - 1) & hash也能保證散列均勻，不會(huì)產(chǎn)生只有偶數(shù)位有值的現(xiàn)象
p = tab[i = (n - 1) & hash];

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;
    //table == null 或者table的長(zhǎng)度為0，調(diào)用resize方法進(jìn)行擴(kuò)容
    //這里也說(shuō)明：table 被延遲到插入新數(shù)據(jù)時(shí)再進(jìn)行初始化
    if ((tab = table) == null || (n = tab.length) == 0)
        n = (tab = resize()).length;
    // 這里就是調(diào)用了Hash算法的地方，具體的計(jì)算可參考后面寫(xiě)到的例子
    //這里定位坐標(biāo)的做法在上面也已經(jīng)說(shuō)到過(guò)
    if ((p = tab[i = (n - 1) & hash]) == null)
        // 如果計(jì)算得到的桶下標(biāo)值中的Node為null，就新建一個(gè)Node加入該位置(這個(gè)新的結(jié)點(diǎn)是在
        //table數(shù)組中)。而該位置的hash值就是調(diào)用hash()方法計(jì)算得到的key的hash值
        tab[i] = newNode(hash, key, value, null);
    //這里表示put的元素用自己key的hash值計(jì)算得到的下表和桶中的第一個(gè)位置元素產(chǎn)生了沖突，具體就是
    //(1)key相同，value不同
    //(2)只是通過(guò)hash值計(jì)算得到的下標(biāo)相同，但是key和value都不同。這里處理的方法就是鏈表和紅黑樹(shù)
    else {
        Node<K,V> e; K k;
        //上面已經(jīng)計(jì)算得到了該hash對(duì)應(yīng)的下標(biāo)i，這里p=tab[i]。這里比較的有：
        //(1)tab[i].hash是否等于傳入的hash。這里的tab[i]就是桶中的第一個(gè)元素
        //(2)比較傳入的key和該位置的key是否相同
        //(3)如果都相同，說(shuō)明是同一個(gè)key，那么直接替換對(duì)應(yīng)的value值(在后面會(huì)進(jìn)行替換)
        if (p.hash == hash && ((k = p.key) == key || (key != null && key.equals(k))))
            //將桶中的第一個(gè)元素賦給e，用來(lái)記錄第一個(gè)位置的值
            e = p;
        //這里判斷為紅黑樹(shù)。hash值不相等，key不相等；為紅黑樹(shù)結(jié)點(diǎn)
        else if (p instanceof TreeNode)
            e = ((TreeNode<K,V>)p).putTreeVal(this, tab, hash, key, value); //加入紅黑樹(shù)
        //判斷為鏈表結(jié)點(diǎn)
        else {
            for (int binCount = 0; ; ++binCount) {
                //如果達(dá)到鏈表的尾部
                if ((e = p.next) == null) {
                    //在尾部插入新的結(jié)點(diǎn)
                    p.next = newNode(hash, key, value, null);
                    //前面的binCount是記錄鏈表長(zhǎng)度的，如果該值大于8，就會(huì)轉(zhuǎn)變?yōu)榧t黑樹(shù)
                    if (binCount >= TREEIFY_THRESHOLD - 1) // -1 for 1st
                        treeifyBin(tab, hash);
                    break;
                }
                //如果在遍歷鏈表的時(shí)候，判斷得出要插入的結(jié)點(diǎn)的key和鏈表中間的某個(gè)結(jié)點(diǎn)的key相
                //同，就跳出循環(huán),后面也會(huì)更新舊的value值
                if (e.hash == hash &&
                    ((k = e.key) == key || (key != null && key.equals(k))))
                    break;
                //e = p.next。遍歷鏈表所用
                p = e;
            }
        }
        //判斷插入的是否存在HashMap中，上面e被賦值，不為空，則說(shuō)明存在，更新舊的鍵值對(duì)
        if (e != null) { // existing mapping for key
            V oldValue = e.value;
            if (!onlyIfAbsent || oldValue == null)
                e.value = value; //用傳入的參數(shù)value更新舊的value值
            afterNodeAccess(e);
            return oldValue; //返回舊的value值
        }
    }
    //modCount修改
    ++modCount;
    //容量超出就擴(kuò)容
    if (++size > threshold)
        resize();
    afterNodeInsertion(evict);
    return null;
}

//該方法有2種使用情況：1.初始化哈希表(table==null) 2.當(dāng)前數(shù)組容量過(guò)小，需擴(kuò)容
final Node<K,V>[] resize() {
    Node<K,V>[] oldTab = table; //oldTab指向舊的table數(shù)組
    //oldTab不為null的話(huà)，oldCap為原table的長(zhǎng)度
    //oldTab為null的話(huà)，oldCap為0
    int oldCap = (oldTab == null) ? 0 : oldTab.length; 
    int oldThr = threshold; //閾值
    int newCap, newThr = 0;
    if (oldCap > 0) { 
        //這里表明oldCap！=0，oldCap=原table.length();
        if (oldCap >= MAXIMUM_CAPACITY) {
            threshold = Integer.MAX_VALUE; //如果大于最大容量了，就賦值為整數(shù)最大的閥值
            return oldTab;
        }
        // 如果數(shù)組的長(zhǎng)度在擴(kuò)容后小于最大容量 并且oldCap大于默認(rèn)值16(這里的newCap也是在原來(lái)的
        //長(zhǎng)度上擴(kuò)展兩倍)
        else if ((newCap = oldCap << 1) < MAXIMUM_CAPACITY &&
                 oldCap >= DEFAULT_INITIAL_CAPACITY)
            newThr = oldThr << 1; // double threshold雙倍擴(kuò)展threshhold
    }
    else if (oldThr > 0) // initial capacity was placed in threshold
        //	這里的oldThr=tabSizeFor(initialCapacity),從上面的構(gòu)造方法看出，如果不是調(diào)用的
        //無(wú)參構(gòu)造，那么threshhold肯定都會(huì)是經(jīng)過(guò)tabSizeFor運(yùn)算得到的2的整數(shù)次冪的,所以可以將
        //其作為Node數(shù)組的長(zhǎng)度(個(gè)人理解)
        newCap = oldThr; 
    else { // zero initial threshold signifies using defaults(零初始閾值表示使用默認(rèn)值)
        //這里說(shuō)的是我們調(diào)用無(wú)參構(gòu)造函數(shù)的時(shí)候(table == null,threshhold = 0)，新的容量等于默
        //認(rèn)的容量，并且threshhold也等于默認(rèn)加載因子*默認(rèn)初始化容量
        newCap = DEFAULT_INITIAL_CAPACITY;
        newThr = (int)(DEFAULT_LOAD_FACTOR * DEFAULT_INITIAL_CAPACITY);
    }
    // 計(jì)算新的resize上限
    if (newThr == 0) {
        float ft = (float)newCap * loadFactor; //容量 * 加載因子
        newThr = (newCap < MAXIMUM_CAPACITY && ft < (float)MAXIMUM_CAPACITY ?
                  (int)ft : Integer.MAX_VALUE);
    }
    threshold = newThr;
    @SuppressWarnings({"rawtypes","unchecked"})
    //以新的容量作為長(zhǎng)度，創(chuàng)建一個(gè)新的Node數(shù)組存放結(jié)點(diǎn)元素
    //當(dāng)然，桶數(shù)組的初始化也是在這里完成的
    Node<K,V>[] newTab = (Node<K,V>[])new Node[newCap]; 
    table = newTab;
    //原來(lái)的table不為null
    if (oldTab != null) {
        // 把每個(gè)bucket都移動(dòng)到新的buckets中
        for (int j = 0; j < oldCap; ++j) {
            Node<K,V> e;
            //原table中下標(biāo)j位置不為null
            if ((e = oldTab[j]) != null) {
                oldTab[j] = null; //將原來(lái)的table[j]賦為null，及時(shí)GC？
                if (e.next == null) //如果該位置沒(méi)有鏈表，即只有數(shù)組中的那個(gè)元素
                    //通過(guò)新的容量計(jì)算在新的table數(shù)組中的下標(biāo)：(n-1)&hash
                    newTab[e.hash & (newCap - 1)] = e; 
                else if (e instanceof TreeNode) 
                    //如果是紅黑樹(shù)結(jié)點(diǎn)，重新映射時(shí)，需要對(duì)紅黑樹(shù)進(jìn)行拆分
                    ((TreeNode<K,V>)e).split(this, newTab, j, oldCap);
                else { // 鏈表優(yōu)化重hash的代碼塊
                    Node<K,V> loHead = null, loTail = null;
                    Node<K,V> hiHead = null, hiTail = null;
                    Node<K,V> next;
                    do {//上面判斷不是紅黑樹(shù)，那就是鏈表，這里就遍歷鏈表，進(jìn)行重新映射
                        next = e.next;
                        // 原位置
                        if ((e.hash & oldCap) == 0) {
                            //loTail處為null，那么直接加到該位置
                            if (loTail == null) 
                                loHead = e;
                            //loTail為鏈表尾結(jié)點(diǎn)，添加到尾部
                            else
                                loTail.next = e;
                            //添加后，將loTail指向鏈表尾部，以便下次從尾部添加
                            loTail = e;
                        }
                        // 原位置+舊容量
                        else {
                            //hiTail處為null，就直接點(diǎn)添加到該位置
                            if (hiTail == null)
                                hiHead = e;
                            //hiTail為鏈表尾結(jié)點(diǎn)，尾插法添加
                            else
                                hiTail.next = e;
                            hiTail = e;
                        }
                    } while ((e = next) != null);
                    // 將分組后的鏈表映射到新桶中
                    // 原索引放到bucket里
                    if (loTail != null) {
                        //舊鏈表遷移新鏈表,鏈表元素相對(duì)位置沒(méi)有變化; 
                        //實(shí)際是對(duì)對(duì)象的內(nèi)存地址進(jìn)行操作 
                        loTail.next = null;//鏈表尾元素設(shè)置為null
                        newTab[j] = loHead; //數(shù)組中位置為j的地方存放鏈表的head結(jié)點(diǎn)
                    }
                    // 原索引+oldCap放到bucket里
                    if (hiTail != null) {
                        hiTail.next = null;
                        newTab[j + oldCap] = hiHead;
                    }
                }
            }
        }
    }
    return newTab;
}

// 原位置
if ((e.hash & oldCap) == 0) {
    //loTail處為null，那么直接加到該位置
    if (loTail == null) 
        loHead = e;
    //loTail為鏈表尾結(jié)點(diǎn)，添加到尾部
    else
        loTail.next = e;
    //添加后，將loTail指向鏈表尾部，以便下次從尾部添加
    loTail = e;
}
// 原位置+舊容量
else {
    //hiTail處為null，就直接點(diǎn)添加到該位置
    if (hiTail == null)
        hiHead = e;
    //hiTail為鏈表尾結(jié)點(diǎn)，尾插法添加
    else
        hiTail.next = e;
    hiTail = e;
}

public V get(Object key) {
    Node<K,V> e;
    return (e = getNode(hash(key), key)) == null ? null : e.value;
}

final Node<K,V> getNode(int hash, Object key) {
    Node<K,V>[] tab; Node<K,V> first, e; int n; K k;
    //計(jì)算存放在數(shù)組table中的位置.具體計(jì)算方法上面也已經(jīng)介紹了
    if ((tab = table) != null && (n = tab.length) > 0 &&
        (first = tab[(n - 1) & hash]) != null) {
        //先查找是不是就是數(shù)組中的元素
        if (first.hash == hash && // always check first node
            ((k = first.key) == key || (key != null && key.equals(k))))
            return first;
        //該位置為紅黑樹(shù)根節(jié)點(diǎn)或者鏈表頭結(jié)點(diǎn)
        if ((e = first.next) != null) {
            //如果first為紅黑樹(shù)結(jié)點(diǎn)，就在紅黑樹(shù)中遍歷查找
            if (first instanceof TreeNode)
                return ((TreeNode<K,V>)first).getTreeNode(hash, key);
            //不是樹(shù)結(jié)點(diǎn)，就在鏈表中遍歷查找
            do {
                if (e.hash == hash &&
                    ((k = e.key) == key || (key != null && key.equals(k))))
                    return e;
            } while ((e = e.next) != null);
        }
    }
    return null;
}