共计 7762 个字符，预计需要花费 20 分钟才能阅读完成。
简介
WeakHashMap 是一种弱引用 map，内部的 key 会存储为弱引用，当 jvm gc 的时候，如果这些 key 没有强引用存在的话，会被 gc 回收掉，下一次当我们操作 map 的时候会把对应的 Entry 整个删除掉，基于这种特性，WeakHashMap 特别适用于缓存处理。
继承体系
可见，WeakHashMap 没有实现 Clone 和 Serializable 接口，所以不具有克隆和序列化的特性。
存储结构
WeakHashMap 因为 gc 的时候会把没有强引用的 key 回收掉，所以注定了它里面的元素不会太多，因此也就不需要像 HashMap 那样元素多的时候转化为红黑树来处理了。
因此，WeakHashMap 的存储结构只有（数组 + 链表）。
源码解析
属性
/**
* 默认初始容量为 16
*/
private static final int DEFAULT_INITIAL_CAPACITY = 16;
/**
* 最大容量为 2 的 30 次方
*/
private static final int MAXIMUM_CAPACITY = 1 << 30;
/**
* 默认装载因子
*/
private static final float DEFAULT_LOAD_FACTOR = 0.75f;
/**
* 桶
*/
Entry<K,V>[] table;
/**
* 元素个数
*/
private int size;
/**
* 扩容门槛，等于 capacity * loadFactor
*/
private int threshold;
/**
* 装载因子
*/
private final float loadFactor;
/**
* 引用队列，当弱键失效的时候会把 Entry 添加到这个队列中
*/
private final ReferenceQueue<Object> queue = new ReferenceQueue<>();（1）容量
容量为数组的长度，亦即桶的个数，默认为 16，最大为 2 的 30 次方。
（2）装载因子
装载因子用来计算容量达到多少时才进行扩容，默认装载因子为 0.75。
（3）引用队列
当弱键失效的时候会把 Entry 添加到这个队列中，当下次访问 map 的时候会把失效的 Entry 清除掉。
Entry 内部类
WeakHashMap 内部的存储节点, 没有 key 属性。
private static class Entry<K,V> extends WeakReference<Object> implements Map.Entry<K,V> {
// 可以发现没有 key, 因为 key 是作为弱引用存到 Referen 类中
V value;
final int hash;
Entry<K,V> next;
Entry(Object key, V value,
ReferenceQueue<Object> queue,
int hash, Entry<K,V> next) {
// 调用 WeakReference 的构造方法初始化 key 和引用队列
super(key, queue);
this.value = value;
this.hash = hash;
this.next = next;
}
}
public class WeakReference<T> extends Reference<T> {public WeakReference(T referent, ReferenceQueue<? super T> q) {
// 调用 Reference 的构造方法初始化 key 和引用队列
super(referent, q);
}
}
public abstract class Reference<T> {
// 实际存储 key 的地方
private T referent; /* Treated specially by GC */
// 引用队列【本篇文章由公众号“彤哥读源码”原创】volatile ReferenceQueue<? super T> queue;
Reference(T referent, ReferenceQueue<? super T> queue) {
this.referent = referent;
this.queue = (queue == null) ? ReferenceQueue.NULL : queue;
}
}从 Entry 的构造方法我们知道，key 和 queue 最终会传到到 Reference 的构造方法中，这里的 key 就是 Reference 的 referent 属性，它会被 gc 特殊对待，即当没有强引用存在时，当下一次 gc 的时候会被清除。
构造方法
public WeakHashMap(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);
int capacity = 1;
while (capacity < initialCapacity)
capacity <<= 1;
table = newTable(capacity);
this.loadFactor = loadFactor;
threshold = (int)(capacity * loadFactor);
}
public WeakHashMap(int initialCapacity) {this(initialCapacity, DEFAULT_LOAD_FACTOR);
}
public WeakHashMap() {this(DEFAULT_INITIAL_CAPACITY, DEFAULT_LOAD_FACTOR);
}
public WeakHashMap(Map<? extends K, ? extends V> m) {this(Math.max((int) (m.size() / DEFAULT_LOAD_FACTOR) + 1,
DEFAULT_INITIAL_CAPACITY),
DEFAULT_LOAD_FACTOR);
putAll(m);
}构造方法与 HashMap 基本类似，初始容量为大于等于传入容量最近的 2 的 n 次方，扩容门槛 threshold 等于 capacity * loadFactor。
put(K key, V value) 方法
添加元素的方法。
public V put(K key, V value) {
// 如果 key 为空，用空对象代替
Object k = maskNull(key);
// 计算 key 的 hash 值
int h = hash(k);
// 获取桶
Entry<K,V>[] tab = getTable();
// 计算元素在哪个桶中，h & (length-1)
int i = indexFor(h, tab.length);
// 遍历桶对应的链表
for (Entry<K,V> e = tab[i]; e != null; e = e.next) {if (h == e.hash && eq(k, e.get())) {
// 如果找到了元素就使用新值替换旧值，并返回旧值
V oldValue = e.value;
if (value != oldValue)
e.value = value;
return oldValue;
}
}
modCount++;
// 如果没找到就把新值插入到链表的头部
Entry<K,V> e = tab[i];
tab[i] = new Entry<>(k, value, queue, h, e);
// 如果插入元素后数量达到了扩容门槛就把桶的数量扩容为 2 倍大小
if (++size >= threshold)
resize(tab.length * 2);
return null;
}（1）计算 hash；
这里与 HashMap 有所不同，HashMap 中如果 key 为空直接返回 0，这里是用空对象来计算的。
另外打散方式也不同，HashMap 只用了一次异或，这里用了四次，HashMap 给出的解释是一次够了，而且就算冲突了也会转换成红黑树，对效率没什么影响。
（2）计算在哪个桶中；
（3）遍历桶对应的链表；
（4）如果找到元素就用新值替换旧值，并返回旧值；
（5）如果没找到就在链表头部插入新元素；
HashMap 就插入到链表尾部。
（6）如果元素数量达到了扩容门槛，就把容量扩大到 2 倍大小；
HashMap 中是大于 threshold 才扩容，这里等于 threshold 就开始扩容了。
resize(int newCapacity) 方法
扩容方法。
void resize(int newCapacity) {// 获取旧桶，getTable() 的时候会剔除失效的 Entry
Entry<K,V>[] oldTable = getTable();
// 旧容量
int oldCapacity = oldTable.length;
if (oldCapacity == MAXIMUM_CAPACITY) {
threshold = Integer.MAX_VALUE;
return;
}
// 新桶
Entry<K,V>[] newTable = newTable(newCapacity);
// 把元素从旧桶转移到新桶
transfer(oldTable, newTable);
// 把新桶赋值桶变量
table = newTable;
/*
* If ignoring null elements and processing ref queue caused massive
* shrinkage, then restore old table. This should be rare, but avoids
* unbounded expansion of garbage-filled tables.
*/
// 如果元素个数大于扩容门槛的一半，则使用新桶和新容量，并计算新的扩容门槛
if (size >= threshold / 2) {threshold = (int)(newCapacity * loadFactor);
} else {
// 否则把元素再转移回旧桶，还是使用旧桶
// 因为在 transfer 的时候会清除失效的 Entry，所以元素个数可能没有那么大了，就不需要扩容了
expungeStaleEntries();
transfer(newTable, oldTable);
table = oldTable;
}
}
private void transfer(Entry<K,V>[] src, Entry<K,V>[] dest) {
// 遍历旧桶
for (int j = 0; j < src.length; ++j) {Entry<K,V> e = src[j];
src[j] = null;
while (e != null) {
Entry<K,V> next = e.next;
Object key = e.get();
// 如果 key 等于了 null 就清除，说明 key 被 gc 清理掉了，则把整个 Entry 清除
if (key == null) {
e.next = null; // Help GC
e.value = null; // " "
size--;
} else {
// 否则就计算在新桶中的位置并把这个元素放在新桶对应链表的头部
int i = indexFor(e.hash, dest.length);
e.next = dest[i];
dest[i] = e;
}
e = next;
}
}
}（1）判断旧容量是否达到最大容量；
（2）新建新桶并把元素全部转移到新桶中；
（3）如果转移后元素个数不到扩容门槛的一半，则把元素再转移回旧桶，继续使用旧桶，说明不需要扩容；
（4）否则使用新桶，并计算新的扩容门槛；
（5）转移元素的过程中会把 key 为 null 的元素清除掉，所以 size 会变小；
get(Object key) 方法
获取元素。
public V get(Object key) {Object k = maskNull(key);
// 计算 hash
int h = hash(k);
Entry<K,V>[] tab = getTable();
int index = indexFor(h, tab.length);
Entry<K,V> e = tab[index];
// 遍历链表，找到了就返回
while (e != null) {if (e.hash == h && eq(k, e.get()))
return e.value;
e = e.next;
}
return null;
}（1）计算 hash 值【本篇文章由公众号“彤哥读源码”原创】；
（2）遍历所在桶对应的链表；
（3）如果找到了就返回元素的 value 值；
（4）如果没找到就返回空；
remove(Object key) 方法
移除元素。
public V remove(Object key) {Object k = maskNull(key);
// 计算 hash
int h = hash(k);
Entry<K,V>[] tab = getTable();
int i = indexFor(h, tab.length);
// 元素所在的桶的第一个元素
Entry<K,V> prev = tab[i];
Entry<K,V> e = prev;
// 遍历链表
while (e != null) {
Entry<K,V> next = e.next;
if (h == e.hash && eq(k, e.get())) {
// 如果找到了就删除元素
modCount++;
size--;
if (prev == e)
// 如果是头节点，就把头节点指向下一个节点
tab[i] = next;
else
// 如果不是头节点，删除该节点
prev.next = next;
return e.value;
}
prev = e;
e = next;
}
return null;
}（1）计算 hash；
（2）找到所在的桶；
（3）遍历桶对应的链表；
（4）如果找到了就删除该节点，并返回该节点的 value 值；
（5）如果没找到就返回 null；
expungeStaleEntries() 方法
剔除失效的 Entry。
private void expungeStaleEntries() {
// 遍历引用队列
for (Object x; (x = queue.poll()) != null; ) {synchronized (queue) {@SuppressWarnings("unchecked")
Entry<K,V> e = (Entry<K,V>) x;
int i = indexFor(e.hash, table.length);
// 找到所在的桶
Entry<K,V> prev = table[i];
Entry<K,V> p = prev;
// 遍历链表
while (p != null) {
Entry<K,V> next = p.next;
// 找到该元素
if (p == e) {
// 删除该元素
if (prev == e)
table[i] = next;
else
prev.next = next;
// Must not null out e.next;
// stale entries may be in use by a HashIterator
e.value = null; // Help GC
size--;
break;
}
prev = p;
p = next;
}
}
}
}（1）当 key 失效的时候 gc 会自动把对应的 Entry 添加到这个引用队列中；
（2）所有对 map 的操作都会直接或间接地调用到这个方法先移除失效的 Entry，比如 getTable()、size()、resize()；
（3）这个方法的目的就是遍历引用队列，并把其中保存的 Entry 从 map 中移除掉，具体的过程请看类注释；
（4）从这里可以看到移除 Entry 的同时把 value 也一并置为 null 帮助 gc 清理元素，防御性编程。
使用案例
说了这么多，不举个使用的例子怎么过得去。
package com.coolcoding.code;
import java.util.Map;
import java.util.WeakHashMap;
public class WeakHashMapTest {public static void main(String[] args) {Map<String, Integer> map = new WeakHashMap<>(3);
// 放入 3 个 new String() 声明的字符串
map.put(new String("1"), 1);
map.put(new String("2"), 2);
map.put(new String("3"), 3);
// 放入不用 new String() 声明的字符串
map.put("6", 6);
// 使用 key 强引用 "3" 这个字符串
String key = null;
for (String s : map.keySet()) {// 这个 "3" 和 new String("3") 不是一个引用
if (s.equals("3")) {key = s;}
}
// 输出 {6=6, 1=1, 2=2, 3=3}，未 gc 所有 key 都可以打印出来
System.out.println(map);
// gc 一下
System.gc();
// 放一个 new String() 声明的字符串
map.put(new String("4"), 4);
// 输出 {4=4, 6=6, 3=3}，gc 后放入的值和强引用的 key 可以打印出来
System.out.println(map);
// key 与 "3" 的引用断裂
key = null;
// gc 一下【本篇文章由公众号“彤哥读源码”原创】System.gc();
// 输出 {6=6}，gc 后强引用的 key 可以打印出来
System.out.println(map);
}
}
在这里通过 new String() 声明的变量才是弱引用，使用 ”6″ 这种声明方式会一直存在于常量池中，不会被清理，所以 ”6″ 这个元素会一直在 map 里面，其它的元素随着 gc 都会被清理掉。
总结
（1）WeakHashMap 使用（数组 + 链表）存储结构；
（2）WeakHashMap 中的 key 是弱引用，gc 的时候会被清除；
（3）每次对 map 的操作都会剔除失效 key 对应的 Entry；
（4）使用 String 作为 key 时，一定要使用 new String() 这样的方式声明 key，才会失效，其它的基本类型的包装类型是一样的；
（5）WeakHashMap 常用来作为缓存使用；
带详细注释的源码地址
WeakHashMap.java
彩蛋
强、软、弱、虚引用知多少？
（1）强引用
使用最普遍的引用。如果一个对象具有强引用，它绝对不会被 gc 回收。如果内存空间不足了，gc 宁愿抛出 OutOfMemoryError，也不是会回收具有强引用的对象。
（2）软引用
如果一个对象只具有软引用，则内存空间足够时不会回收它，但内存空间不够时就会回收这部分对象。只要这个具有软引用对象没有被回收，程序就可以正常使用。
（3）弱引用
如果一个对象只具有弱引用，则不管内存空间够不够，当 gc 扫描到它时就会回收它。
（4）虚引用
如果一个对象只具有虚引用，那么它就和没有任何引用一样，任何时候都可能被 gc 回收。
软（弱、虚）引用必须和一个引用队列（ReferenceQueue）一起使用，当 gc 回收这个软（弱、虚）引用引用的对象时，会把这个软（弱、虚）引用放到这个引用队列中。
比如，上述的 Entry 是一个弱引用，它引用的对象是 key，当 key 被回收时，Entry 会被放到 queue 中。
欢迎关注我的公众号“彤哥读源码”，查看更多源码系列文章, 与彤哥一起畅游源码的海洋。
