public ConcurrentHashMap(int initialCapacity,
             float loadFactor, int concurrencyLevel) {
  if (!(loadFactor > 0) || initialCapacity < 0 || concurrencyLevel <= 0)
    throw new IllegalArgumentException();
  if (concurrencyLevel > MAX_SEGMENTS)
    concurrencyLevel = MAX_SEGMENTS;
  // Find power-of-two sizes best matching arguments
  int sshift = 0;
  int ssize = 1;
  // 計算并行級別 ssize，因為要保持并行級別是 2 的 n 次方
  while (ssize < concurrencyLevel) {
    ++sshift;
    ssize <<= 1;
  }
  // 我們這里先不要那么燒腦，用默認值，concurrencyLevel 為 16，sshift 為 4
  // 那么計算出 segmentShift 為 28，segmentMask 為 15，后面會用到這兩個值
  this.segmentShift = 32 - sshift;
  this.segmentMask = ssize - 1;
  if (initialCapacity > MAXIMUM_CAPACITY)
    initialCapacity = MAXIMUM_CAPACITY;
  // initialCapacity 是設置整個 map 初始的大小，
  // 這里根據(jù) initialCapacity 計算 Segment 數(shù)組中每個位置可以分到的大小
  // 如 initialCapacity 為 64，那么每個 Segment 或稱之為"槽"可以分到 4 個
  int c = initialCapacity / ssize;
  if (c * ssize < initialCapacity)
    ++c;
  // 默認 MIN_SEGMENT_TABLE_CAPACITY 是 2，這個值也是有講究的，因為這樣的話，對于具體的槽上，
  // 插入一個元素不至于擴容，插入第二個的時候才會擴容
  int cap = MIN_SEGMENT_TABLE_CAPACITY; 
  while (cap < c)
    cap <<= 1;
  // 創(chuàng)建 Segment 數(shù)組，
  // 并創(chuàng)建數(shù)組的第一個元素 segment[0]
  Segment<K,V> s0 =
    new Segment<K,V>(loadFactor, (int)(cap * loadFactor),
             (HashEntry<K,V>[])new HashEntry[cap]);
  Segment<K,V>[] ss = (Segment<K,V>[])new Segment[ssize];
  // 往數(shù)組寫入 segment[0]
  UNSAFE.putOrderedObject(ss, SBASE, s0); // ordered write of segments[0]
  this.segments = ss;
}

static class Segment<K,V> extends ReentrantLock implements Serializable {
  transient volatile HashEntry<K,V>[] table;
  transient int count;
  transient int modCount;
  
}

public V put(K key, V value) {
  Segment<K,V> s;
  if (value == null)
    throw new NullPointerException();
  // 1. 計算 key 的 hash 值
  int hash = hash(key);
  // 2. 根據(jù) hash 值找到 Segment 數(shù)組中的位置 j
  //  hash 是 32 位，無符號右移 segmentShift(28) 位，剩下高 4 位，
  //  然后和 segmentMask(15) 做一次與操作，也就是說 j 是 hash 值的高 4 位，也就是槽的數(shù)組下標
  int j = (hash >>> segmentShift) & segmentMask;
  // 剛剛說了，初始化的時候初始化了 segment[0]，但是其他位置還是 null，
  // ensureSegment(j) 對 segment[j] 進行初始化
  if ((s = (Segment<K,V>)UNSAFE.getObject     // nonvolatile; recheck
     (segments, (j << SSHIFT) + SBASE)) == null) // in ensureSegment
    s = ensureSegment(j);
  // 3. 插入新值到 槽 s 中
  return s.put(key, hash, value, false);
}

private Segment<K,V> ensureSegment(int k) {
  final Segment<K,V>[] ss = this.segments;
  long u = (k << SSHIFT) + SBASE; // raw offset
  Segment<K,V> seg;
  if ((seg = (Segment<K,V>)UNSAFE.getObjectVolatile(ss, u)) == null) {
    // 這里看到為什么之前要初始化 segment[0] 了，
    // 使用當前 segment[0] 處的數(shù)組長度和負載因子來初始化 segment[k]
    // 為什么要用“當前”，因為 segment[0] 可能早就擴容過了
    Segment<K,V> proto = ss[0];
    int cap = proto.table.length;
    float lf = proto.loadFactor;
    int threshold = (int)(cap * lf);
    // 初始化 segment[k] 內部的數(shù)組
    HashEntry<K,V>[] tab = (HashEntry<K,V>[])new HashEntry[cap];
    if ((seg = (Segment<K,V>)UNSAFE.getObjectVolatile(ss, u))
      == null) { // 再次檢查一遍該槽是否被其他線程初始化了。
      Segment<K,V> s = new Segment<K,V>(lf, threshold, tab);
      // 使用 while 循環(huán)，內部用 CAS，當前線程成功設值或其他線程成功設值后，退出,如果其他線程成功設置后，這里獲取到直接返回
      while ((seg = (Segment<K,V>)UNSAFE.getObjectVolatile(ss, u))
          == null) {
        if (UNSAFE.compareAndSwapObject(ss, u, null, seg = s))
          break;
      }
    }
  }
  return seg;
}

final V put(K key, int hash, V value, boolean onlyIfAbsent) {
  // 在往該 segment 寫入前，需要先獲取該 segment 的獨占鎖
  //  先看主流程，后面還會具體介紹這部分內容
  HashEntry<K,V> node = tryLock() ? null :
    scanAndLockForPut(key, hash, value);
  V oldValue;
  try {
    // 這個是 segment 內部的數(shù)組
    HashEntry<K,V>[] tab = table;
    // 再利用 hash 值，求應該放置的數(shù)組下標
    int index = (tab.length - 1) & hash;
    // first 是數(shù)組該位置處的鏈表的表頭
    HashEntry<K,V> first = entryAt(tab, index);

    // 下面這串 for 循環(huán)雖然很長，不過也很好理解，想想該位置沒有任何元素和已經存在一個鏈表這兩種情況
    for (HashEntry<K,V> e = first;;) {
      if (e != null) {
        K k;
        if ((k = e.key) == key ||
          (e.hash == hash && key.equals(k))) {
          oldValue = e.value;
          if (!onlyIfAbsent) {
            // 覆蓋舊值
            e.value = value;
            ++modCount;
          }
          break;
        }
        // 繼續(xù)順著鏈表走
        e = e.next;
      }
      else {
        // node 到底是不是 null，這個要看獲取鎖的過程，不過和這里都沒有關系。
        // 如果不為 null，那就直接將它設置為鏈表表頭；如果是null，初始化并設置為鏈表表頭。
        if (node != null)
          node.setNext(first);
        else
          node = new HashEntry<K,V>(hash, key, value, first);

        int c = count + 1;
        // 如果超過了該 segment 的閾值，這個 segment 需要擴容
        if (c > threshold && tab.length < MAXIMUM_CAPACITY)
          rehash(node); // 擴容后面也會具體分析
        else
          // 沒有達到閾值，將 node 放到數(shù)組 tab 的 index 位置，
          // 其實就是將新的節(jié)點設置成原鏈表的表頭
          setEntryAt(tab, index, node);
        ++modCount;
        count = c;
        oldValue = null;
        break;
      }
    }
  } finally {
    // 解鎖
    unlock();
  }
  return oldValue;
}

private HashEntry<K,V> scanAndLockForPut(K key, int hash, V value) {
  HashEntry<K,V> first = entryForHash(this, hash);
  HashEntry<K,V> e = first;
  HashEntry<K,V> node = null;
  int retries = -1; // negative while locating node
  // 循環(huán)獲取鎖
  while (!tryLock()) {
    HashEntry<K,V> f; // to recheck first below
    if (retries < 0) {
      if (e == null) {
        if (node == null) // speculatively create node
          // 進到這里說明數(shù)組該位置的鏈表是空的，沒有任何元素
          // 當然，進到這里的另一個原因是 tryLock() 失敗，所以該槽存在并發(fā)，不一定是該位置
          node = new HashEntry<K,V>(hash, key, value, null);
        retries = 0;
      }
      else if (key.equals(e.key))
        retries = 0;
      else
        // 順著鏈表往下走
        e = e.next;
    }
    // 重試次數(shù)如果超過 MAX_SCAN_RETRIES（單核1多核64），那么不搶了，進入到阻塞隊列等待鎖
    //  lock() 是阻塞方法，直到獲取鎖后返回
    else if (++retries > MAX_SCAN_RETRIES) {
      lock();
      break;
    }
    else if ((retries & 1) == 0 &&
         // 這個時候是有大問題了，那就是有新的元素進到了鏈表，成為了新的表頭
         //   所以這邊的策略是，相當于重新走一遍這個 scanAndLockForPut 方法
         (f = entryForHash(this, hash)) != first) {
      e = first = f; // re-traverse if entry changed
      retries = -1;
    }
  }
  return node;
}

// 方法參數(shù)上的 node 是這次擴容后，需要添加到新的數(shù)組中的數(shù)據(jù)。
private void rehash(HashEntry<K,V> node) {
  HashEntry<K,V>[] oldTable = table;
  int oldCapacity = oldTable.length;
  // 2 倍
  int newCapacity = oldCapacity << 1;
  threshold = (int)(newCapacity * loadFactor);
  // 創(chuàng)建新數(shù)組
  HashEntry<K,V>[] newTable =
    (HashEntry<K,V>[]) new HashEntry[newCapacity];
  // 新的掩碼，如從 16 擴容到 32，那么 sizeMask 為 31，對應二進制 ‘000...00011111'
  int sizeMask = newCapacity - 1;

  // 遍歷原數(shù)組，老套路，將原數(shù)組位置 i 處的鏈表拆分到 新數(shù)組位置 i 和 i+oldCap 兩個位置
  for (int i = 0; i < oldCapacity ; i++) {
    // e 是鏈表的第一個元素
    HashEntry<K,V> e = oldTable[i];
    if (e != null) {
      HashEntry<K,V> next = e.next;
      // 計算應該放置在新數(shù)組中的位置，
      // 假設原數(shù)組長度為 16，e 在 oldTable[3] 處，那么 idx 只可能是 3 或者是 3 + 16 = 19
      int idx = e.hash & sizeMask;
      if (next == null)  // 該位置處只有一個元素，那比較好辦
        newTable[idx] = e;
      else { // Reuse consecutive sequence at same slot
        // e 是鏈表表頭
        HashEntry<K,V> lastRun = e;
        // idx 是當前鏈表的頭結點 e 的新位置
        int lastIdx = idx;

        // 下面這個 for 循環(huán)會找到一個 lastRun 節(jié)點，這個節(jié)點之后的所有元素是將要放到一起的
        for (HashEntry<K,V> last = next;
           last != null;
           last = last.next) {
          int k = last.hash & sizeMask;
          if (k != lastIdx) {
            lastIdx = k;
            lastRun = last;
          }
        }
        // 將 lastRun 及其之后的所有節(jié)點組成的這個鏈表放到 lastIdx 這個位置
        newTable[lastIdx] = lastRun;
        // 下面的操作是處理 lastRun 之前的節(jié)點，
        //  這些節(jié)點可能分配在另一個鏈表中，也可能分配到上面的那個鏈表中
        for (HashEntry<K,V> p = e; p != lastRun; p = p.next) {
          V v = p.value;
          int h = p.hash;
          int k = h & sizeMask;
          HashEntry<K,V> n = newTable[k];
          newTable[k] = new HashEntry<K,V>(h, p.key, v, n);
        }
      }
    }
  }
  // 將新來的 node 放到新數(shù)組中剛剛的 兩個鏈表之一 的 頭部
  int nodeIndex = node.hash & sizeMask; // add the new node
  node.setNext(newTable[nodeIndex]);
  newTable[nodeIndex] = node;
  table = newTable;
}

public V get(Object key) {
  Segment<K,V> s; // manually integrate access methods to reduce overhead
  HashEntry<K,V>[] tab;
  // 1. hash 值
  int h = hash(key);
  long u = (((h >>> segmentShift) & segmentMask) << SSHIFT) + SBASE;
  // 2. 根據(jù) hash 找到對應的 segment
  if ((s = (Segment<K,V>)UNSAFE.getObjectVolatile(segments, u)) != null &&
    (tab = s.table) != null) {
    // 3. 找到segment 內部數(shù)組相應位置的鏈表，遍歷
    for (HashEntry<K,V> e = (HashEntry<K,V>) UNSAFE.getObjectVolatile
         (tab, ((long)(((tab.length - 1) & h)) << TSHIFT) + TBASE);
       e != null; e = e.next) {
      K k;
      if ((k = e.key) == key || (e.hash == h && key.equals(k)))
        return e.value;
    }
  }
  return null;
}

public int size() {
 final Segment<K,V>[] segments = this.segments;
 int size;
 boolean overflow; // true if size overflows 32 bits
 long sum;     // sum of modCounts
 long last = 0L;  // previous sum
 int retries = -1; // first iteration isn't retry
 try {
  for (;;) {
   if (retries++ == RETRIES_BEFORE_LOCK) {
    for (int j = 0; j < segments.length; ++j)
     ensureSegment(j).lock(); // force creation
   }
   sum = 0L;
   size = 0;
   overflow = false;
   for (int j = 0; j < segments.length; ++j) {
    Segment<K,V> seg = segmentAt(segments, j);
    if (seg != null) {
     sum += seg.modCount;
     int c = seg.count;
     if (c < 0 || (size += c) < 0)
      overflow = true;
    }
   }
   if (sum == last)
    break;
   last = sum;
  }
 } finally {
  if (retries > RETRIES_BEFORE_LOCK) {
   for (int j = 0; j < segments.length; ++j)
    segmentAt(segments, j).unlock();
  }
 }
 return overflow ? Integer.MAX_VALUE : size;
}