1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
// HashMap的put方法
public V put(K key, V value) {
// 调用 putVal 方法
return putVal(hash(key), key, value, false, true);
}

/**
* Implements Map.put and related methods.
*
* @param hash hash for key
* @param key the key
* @param value the value to put
* @param onlyIfAbsent if true, don't change existing value
* @param evict if false, the table is in creation mode.
* @return previous value, or null if none
*/
final V putVal(int hash, K key, V value, boolean onlyIfAbsent,
boolean evict) {

// 哈希表的桶数组
Node<K,V>[] tab;
// 当前桶中链表或树的第一个节点,用于遍历和查找目标节点
Node<K,V> p;
// 哈希表的容量(桶数组的大小),计算得出的当前桶的位置(索引)
int n, i;

// 无参构造 初始化map,table为空
if ((tab = table) == null || (n = tab.length) == 0)
// 进行扩容和初始化 resize()方法会计算合适的哈希表大小并返回新的哈希表
n = (tab = resize()).length;

// 计算下标,并判断数组下标处为空,说明不存在节点
if ((p = tab[i = (n - 1) & hash]) == null)
// newNode创建新节点
tab[i] = newNode(hash, key, value, null);

// 处理出现Hash碰撞之后
else {
Node<K,V> e; K k;

// 发生hash碰撞且key相同,则直接覆盖原key值
if (p.hash == hash &&((k = p.key) == key || (key != null && key.equals(k))))
e = p;
// 发生hash碰撞但key不同,判断是否是红黑树,如果是则在红黑树插入节点
else if (p instanceof TreeNode)

e = ((TreeNode<K,V>)p).putTreeVal(this, tab, hash, key, value);

// 发生hash碰撞但key不同,不是红黑树,表明是链表
else {
for (int binCount = 0; ; ++binCount) {
// p.next 复值给e,判空
if ((e = p.next) == null) {
// 如果为null,表明该下标只有一个节点,新增节点放入尾部,尾插法。
p.next = newNode(hash, key, value, null);
// 判断此时链表长度。默认为8。如大于7,则转换链表为红黑树
if (binCount >= TREEIFY_THRESHOLD - 1) // -1 for 1st
// treeifyBin 方法将链表转化为红黑树。
treeifyBin(tab, hash);
break;
}
// 覆盖原值的判断
if (e.hash == hash &&((k = e.key) == key || (key != null && key.equals(k))))
break;
// 如果该下标不止一个节点,则重新赋值p接着循环,相当于在遍历链表。直至p.next为空
p = e;
}
}
// 更新已有键的值, 根据 onlyIfAbsent 参数, 默认传入false
if (e != null) { // existing mapping for key
V oldValue = e.value;
if (!onlyIfAbsent || oldValue == null)
e.value = value;
afterNodeAccess(e);
return oldValue;
}
}
// 记录修改次数
++modCount;
// 增加size,哈希表中元素数量,超过 threshold 阈值进行扩容
if (++size > threshold)
// 哈希表扩容操作
resize();
afterNodeInsertion(evict);
return null;
}
  1. 初始化/扩展hash表tab

  2. 计算hash表中的位置 i

    • 没有节点,为null,直接将新节点放在该位置

    • 已有节点进行其他处理

  3. 已有节点,即出现hash碰撞

    • hash值相同,key也相同。直接覆盖旧值

    • hash值相同,key不通,判断是否红黑树话

      1. 是红黑树,在红黑树进行节点插入

      2. 不是红黑树,说明是链表。遍历链表查找是否有相同的键,如果有则更新值,否则在链表末尾插入新的节点。

  4. 返回旧值,这么是为了符合Map.put() 的行为契约,调用者就能知道这个键之前的值是什么,可以处理一些业务逻辑。举例:用户余额,订单系统知道旧状态等。