一、源码
1. 重要成员变量默认值
public class HashMap<K,V> extends AbstractMap<K,V>
implements Map<K,V>, Cloneable, Serializable {
// 默认数组长度,数组长度必须是2的n次方
static final int DEFAULT_INITIAL_CAPACITY = 1 << 4; // aka 16
// 最大数组长度
static final int MAXIMUM_CAPACITY = 1 << 30;
// 负载因子默认值
static final float DEFAULT_LOAD_FACTOR = 0.75f;
// 数组转换为红黑树的阈值
static final int TREEIFY_THRESHOLD = 8;
// 红黑树转换为数组的阈值
static final int UNTREEIFY_THRESHOLD = 6;
// 树的最小值
static final int MIN_TREEIFY_CAPACITY = 64;
}
2. 构造方法
// 空参构造方法
public HashMap() {
// 默认负载因子为0.75f
this.loadFactor = DEFAULT_LOAD_FACTOR;
}
// 有参构造方法
public HashMap(int initialCapacity, float loadFactor) {
// 如果指定的数组长度<0,抛异常
if (initialCapacity < 0)
throw new IllegalArgumentException("Illegal initial capacity: " + initialCapacity);
// 指定的数组长度>2^30,取2^30
if (initialCapacity > MAXIMUM_CAPACITY)
initialCapacity = MAXIMUM_CAPACITY;
// 如果负载因子<=0 或 参数值非数字,抛异常
if (loadFactor <= 0 || Float.isNaN(loadFactor))
throw new IllegalArgumentException("Illegal load factor: " + loadFactor);
// 负载因子赋值
this.loadFactor = loadFactor;
// 扩容阈值赋值,值为大于等于指定数组长度的2的n次方
this.threshold = tableSizeFor(initialCapacity);
}
3. put方法
// key值存在,则替换value
public V put(K key, V value) {
return putVal(hash(key), key, value, false, true);
}
// key值存在并且对应的value不为null,则不进行操作
public V putIfAbsent(K key, V value) {
return putVal(hash(key), key, value, true, true);
}
putVal
方法
final V putVal(int hash, K key, V value, boolean onlyIfAbsent, boolean evict) {
Node<K,V>[] tab; Node<K,V> p; int n, i;
// 如果数组为null 或 数组长度为0
if ((tab = table) == null || (n = tab.length) == 0)
// 调用扩容方法进行数组的初始化
n = (tab = resize()).length;
// 根据hash值计算数组下标,如果下标位置为null,表示没有链表元素
if ((p = tab[i = (n - 1) & hash]) == null)
// 直接创建一个元素放入下标位置
tab[i] = newNode(hash, key, value, null);
// 下标位置不为null
else {
Node<K,V> e; K k;
// 如果存在相同的key值
if (p.hash == hash && ((k = p.key) == key || (key != null && key.equals(k))))
// 保存下标位置的元素
e = p;
// 如果是红黑树,调用对应的方法保存
else if (p instanceof TreeNode)
e = ((TreeNode<K,V>)p).putTreeVal(this, tab, hash, key, value);
// 如果是链表
else {
for (int binCount = 0; ; ++binCount) {
// 判断元素的下一个位置是否为null
if ((e = p.next) == null) {
// 找到链表尾部,把新元素插入进去(尾插法)
p.next = newNode(hash, key, value, null);
// binCount从0开始,大于等于7的时候转换调用方法将数组转换为红黑树,数组长度
if (binCount >= TREEIFY_THRESHOLD - 1)
// 数组转换为红黑树
treeifyBin(tab, hash);
break;
}
// 链表中存在相同的key
if (e.hash == hash && ((k = e.key) == key || (key != null && key.equals(k))))
break;
p = e;
}
}
// 如果e不为null,说明下标位置的链表中存在相同的key值
if (e != null) {
// 保存旧value
V oldValue = e.value;
// 如果允许替换,或者旧value为空
if (!onlyIfAbsent || oldValue == null)
// 新value替换旧value
e.value = value;
// 空方法,LinkedHashMap中使用
afterNodeAccess(e);
// 将旧value返回
return oldValue;
}
}
// 修改次数+1
++modCount;
// 如果数组长度大于扩容阈值
if (++size > threshold)
// 扩容
resize();
// 空方法,LinkedHashMap中使用
afterNodeInsertion(evict);
// 没有对应的key值,返回null
return null;
}
resize()
方法,初始化数组 / 扩容
final Node<K,V>[] resize() {
// 旧数组
Node<K,V>[] oldTab = table;
// 旧数组的长度
int oldCap = (oldTab == null) ? 0 : oldTab.length;
// 旧的扩容阈值,初始化数组时此变量为新数组长度
int oldThr = threshold;
// 新数组的长度和扩容阈值,初始为0
int newCap, newThr = 0;
// 如果旧数组长度>0
if (oldCap > 0) {
// 如果旧数组长度>=2^30,不进行数组扩容,将扩容阈值提升为2^31-1
if (oldCap >= MAXIMUM_CAPACITY) {
threshold = Integer.MAX_VALUE;
// 返回旧数组
return oldTab;
}
// 新数组长度=旧数组长度*2,新数组长度<2^30 并且旧数组长度>=16
else if ((newCap = oldCap << 1) < MAXIMUM_CAPACITY && oldCap >= DEFAULT_INITIAL_CAPACITY)
// 新扩容阈值=旧扩容阈值*2
newThr = oldThr << 1; // double threshold
}
// 如果旧数组的扩容阈值>0
// 有参构造方法,初始化的扩容阈值为数组初始化长度
else if (oldThr > 0)
newCap = oldThr;
// 空参初始化时,数组长度为0,扩容阈值也为0
else {
// 新数组长度为默认长度16
newCap = DEFAULT_INITIAL_CAPACITY;
// 新数组扩容阈值为16*0.75f = 12
newThr = (int)(DEFAULT_LOAD_FACTOR * DEFAULT_INITIAL_CAPACITY);
}
// 如果新数组的扩容阈值为0
if (newThr == 0) {
// 根据新数组长度和负载因子计算新数组的扩容阈值
float ft = (float)newCap * loadFactor;
// 新数组长度>=2^30时,扩容阈值为2^31-1,否则使用上面计算的数值
newThr = (newCap < MAXIMUM_CAPACITY && ft < (float)MAXIMUM_CAPACITY ? (int)ft : Integer.MAX_VALUE);
}
// 数组扩容阈值赋值
threshold = newThr;
@SuppressWarnings({"rawtypes","unchecked"})
// 创建数组
Node<K,V>[] newTab = (Node<K,V>[])new Node[newCap];
// 赋值为HashMap的table属性
table = newTab;
// 如果就数组不为null,表示不是初始化数组,需要转移元素
if (oldTab != null) {
// 遍历旧数组
for (int j = 0; j < oldCap; ++j) {
Node<K,V> e;
// 数组下标位置不为null,表示存在元素,先将元素保存
if ((e = oldTab[j]) != null) {
// 将原数组下标位置设置为null
oldTab[j] = null;
// 如果元素的下一位为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);
// 元素下一位不为null,表示还有元素
else {
// 新数组中低位的链表头、链表尾
Node<K,V> loHead = null, loTail = null;
// 新数组中高位的链表头、链表尾
Node<K,V> hiHead = null, hiTail = null;
Node<K,V> next;
// 循环遍历链表,根据链表中每个元素的hash值,计算出在新数组中的位置
// 将原链表拆分成为两个即将放入新数组中的新链表
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);
// 如果低位链表不为null
if (loTail != null) {
// 将链表尾部的next设置为null
loTail.next = null;
// 将低位链表头的元素放入新数组中,相当于将低位链表放入新数组中
newTab[j] = loHead;
}
// 如果高位链表不为null
if (hiTail != null) {
// 将链表尾部的next设置为null
hiTail.next = null;
// 将高位链表头的元素放入新数组中,相当于将高位链表放入新数组中
newTab[j + oldCap] = hiHead;
}
}
}
}
}
// 返回新数组
return newTab;
}
treeifyBin
方法,将链表转换为红黑树
final void treeifyBin(Node<K,V>[] tab, int hash) {
int n, index; Node<K,V> e;
// 如果数组为null 或 数组长度<64,不进行转换,将原数组扩容
if (tab == null || (n = tab.length) < MIN_TREEIFY_CAPACITY)
resize();
// 如果数组下标位置不为null
else if ((e = tab[index = (n - 1) & hash]) != null) {
// 双向链表的头元素和尾元素
TreeNode<K,V> hd = null, tl = null;
// 将原链表(单向链表)转换为双向链表
do {
// 将原Node节点转换为TreeNode节点,TreeNode节点既可以保存前后节点的地址(双向链表),也可以保存父节点和左右子节点地址(红黑树)
TreeNode<K,V> p = replacementTreeNode(e, null);
// 设置头元素
if (tl == null)
hd = p;
// 设置后续元素的前后节点地址
else {
p.prev = tl;
tl.next = p;
}
tl = p;
} while ((e = e.next) != null);
// 在数组下标位置放入双向链表的头元素
if ((tab[index] = hd) != null)
// 转换为红黑树
hd.treeify(tab);
}
}
// treeify方法
final void treeify(Node<K,V>[] tab) {
// 红黑树根节点
TreeNode<K,V> root = null;
// x为双向链表的头元素,遍历双向链表元素
for (TreeNode<K,V> x = this, next; x != null; x = next) {
// 链表中下一个元素
next = (TreeNode<K,V>)x.next;
// 初始化根节点的左右元素为null
x.left = x.right = null;
// 如果根节点为null,将双向链表的头元素设置为根节点(黑色)
if (root == null) {
x.parent = null;
x.red = false;
root = x;
}
// 根节点不为null,将链表中剩余元素放入红黑树中
else {
K k = x.key;
int h = x.hash;
Class<?> kc = null;
// 遍历红黑树,找到元素对应的位置
for (TreeNode<K,V> p = root;;) {
int dir, ph;
K pk = p.key;
if ((ph = p.hash) > h)
dir = -1;
else if (ph < h)
dir = 1;
else if ((kc == null &&
(kc = comparableClassFor(k)) == null) ||
(dir = compareComparables(kc, k, pk)) == 0)
dir = tieBreakOrder(k, pk);
TreeNode<K,V> xp = p;
if ((p = (dir <= 0) ? p.left : p.right) == null) {
x.parent = xp;
if (dir <= 0)
xp.left = x;
else
xp.right = x;
// 将元素放入红黑树中
root = balanceInsertion(root, x);
break;
}
}
}
}
// 调整双向链表的链表头元素,如果红黑树的平衡时根节点变化了,调整为新的根节点元素
moveRootToFront(tab, root);
}
putTreeVal
方法,向红黑树中放入元素
final TreeNode<K,V> putTreeVal(HashMap<K,V> map, Node<K,V>[] tab,int h, K k, V v) {
Class<?> kc = null;
boolean searched = false;
// 当前数组
TreeNode<K,V> root = (parent != null) ? root() : this;
// 遍历红黑树,找到元素对应位置
for (TreeNode<K,V> p = root;;) {
int dir, ph; K pk;
if ((ph = p.hash) > h)
dir = -1;
else if (ph < h)
dir = 1;
// 如果存在相同的key,返回对应节点
else if ((pk = p.key) == k || (k != null && k.equals(pk)))
return p;
else if ((kc == null &&
(kc = comparableClassFor(k)) == null) ||
(dir = compareComparables(kc, k, pk)) == 0) {
if (!searched) {
TreeNode<K,V> q, ch;
searched = true;
if (((ch = p.left) != null &&
(q = ch.find(h, k, kc)) != null) ||
((ch = p.right) != null &&
(q = ch.find(h, k, kc)) != null))
return q;
}
dir = tieBreakOrder(k, pk);
}
// 红黑树中不存在对应的key值,创建新Node节点插入红黑树中,返回null
TreeNode<K,V> xp = p;
if ((p = (dir <= 0) ? p.left : p.right) == null) {
Node<K,V> xpn = xp.next;
TreeNode<K,V> x = map.newTreeNode(h, k, v, xpn);
if (dir <= 0)
xp.left = x;
else
xp.right = x;
xp.next = x;
x.parent = x.prev = xp;
if (xpn != null)
((TreeNode<K,V>)xpn).prev = x;
moveRootToFront(tab, balanceInsertion(root, x));
return null;
}
}
}