Java WeakHashMap 源码解析

发布: 2015-09-27   上次更新: 2026-02-22   分类: 编程语言   标签: Java

文章目录

前面把基于特定数据结构的Map介绍完了,它们分别利用了相应数据结构的特点来实现特殊的目的,像HashMap利用哈希表的快速插入、查找实现O(1)的增删改查,TreeMap则利用了红黑树来保证key的有序性的同时,使得增删改查的时间复杂度为O(log(n))

今天要介绍的WeakHashMap并没有基于某种特殊的数据结构,它的主要目的是为了优化JVM,使JVM中的垃圾回收器(garbage collector,后面简写为 GC)更智能的回收“无用”的对象。

本文源码分析基于Oracle JDK 1.7.0_71,请知悉。

$ java -version
java version "1.7.0_71"
Java(TM) SE Runtime Environment (build 1.7.0_71-b14)
Java HotSpot(TM) 64-Bit Server VM (build 24.71-b01, mixed mode)

引用类型

WeakHashMap与其他 Map 最主要的不同之处在于其 key 是弱引用类型,其他 Map 的 key 均为强引用类型,说到这里,必须强调下:Java 中,引用有四种类型,分别为:强(strong)引用、软(soft)引用、弱(weak)引用、虚(phantom,本意为幽灵👻)引用。我相信对于 Java 初学者来说,不一定听过这几种引用类似,下面先介绍下这几种类型。

强引用

这是最常用的引用类型,在执行下面的语句时,变量 o 即为一个强引用。

1Object o = new Object();

强引用指向的对象无论在何时,都不会被GC 清理掉。

一般来说,对于常驻类应用(比如server),随着时间的增加,所占用的内存往往会持续上升,如果程序中全部使用强引用,那么很容易造成内存泄漏,最终导致Out Of Memory (OOM),所以 Java 中提供了除强引用之外的其他三种引用,它们全部位于java.lang.ref包中,下面一一介绍。

java.lang.ref.Reference

java.lang.ref.Reference 为 软(soft)引用、弱(weak)引用、虚(phantom)引用的父类。

Reference类继承关系

下面分析下Reference的源码(其他三种引用都是其子类,区分不是很大)。

构造函数

 1    //referent 为引用指向的对象
 2    Reference(T referent) {
 3        this(referent, null);
 4    }
 5    //ReferenceQueue对象,可以简单理解为一个队列
 6    //GC 在检测到appropriate reachability changes之后,
 7    //会把引用对象本身添加到这个queue中,便于清理引用对象本身
 8    Reference(T referent, ReferenceQueue<? super T> queue) {
 9        this.referent = referent;
10        this.queue = (queue == null) ? ReferenceQueue.NULL : queue;
11    }

如果我们在创建一个引用对象时,指定了ReferenceQueue,那么当引用对象指向的对象达到合适的状态(根据引用类型不同而不同)时,GC 会把引用对象本身添加到这个队列中,方便我们处理它,因为

引用对象指向的对象 GC 会自动清理,但是引用对象本身也是对象(是对象就占用一定资源),所以需要我们自己清理。

举个例子:

1Object o = new Object();
2SoftReference<Object> sr = new SoftReference<>(o , queue);

sr 为软引用,指向 o 这个对象,o 会在一定时机被 GC 自动清理,但是 sr 对象本身的清理工作依赖于 queue,当 sr 出现在queue中时,说明其指向的对象已经无效,可以放心清理了。

从上面的分析大家应该对Reference类有了基本的认识,但是上面也提到了,不同的引用,添加到ReferenceQueue的时机是不一样。下面介绍具体引用时再进行说明。 这里有个问题,如果创建引用对象是没有指定ReferenceQueue,引用对象会怎么样呢?这里需要了解Reference类内部的四种状态。

四种状态

每一时刻,Reference对象都处于下面四种状态中。这四种状态用Reference的成员变量queuenext(类似于单链表中的next)来标示。

ReferenceQueue<? super T> queue;
Reference next;

有了这些约束,GC 只需要检测next字段就可以知道是否需要对该引用对象采取特殊处理

我自己根据Reference.ReferenceHandler.runReferenceQueue.enqueue这两个方法,画出了这四种状态的转移图,供大家参考:

Reference状态转移图

要理解这个状态 GC 到底做了什么事,需要看 JVM 的代码,我这里时间、能力都不够,就不献丑了,后面有机会再来填坑。 对于一般程序员来说,这四种状态完全可以不用管。最后简单两句话总结上面的四种状态:

  1. 如果构造函数中指定了ReferenceQueue,那么事后程序员可以通过该队列清理引用
  2. 如果构造函数中没有指定了ReferenceQueue,那么 GC 会自动清理引用

get

调用Reference.get方法可以得到该引用指向的对象,但是由于指向的对象随时可能被 GC 清理,所以即使在同一个线程中,不同时刻的调用可能返回不一样的值。

软引用(soft reference)

软引用“保存”对象的能力稍逊于强引用,但是高于弱引用,一般用来实现memory-sensitive caches。

软引用指向的对象会在程序即将触发OOM时被GC 清理掉,之后,引用对象会被放到ReferenceQueue中。

弱引用(weak reference)

软引用“保存”对象的能力稍逊于弱引用,但是高于虚引用,一般用来实现canonicalizing mapping,也就是本文要讲的WeakHashMap😊。

当弱引用指向的对象只能通过弱引用(没有强引用或弱引用)访问时,GC会清理掉该对象,之后,引用对象会被放到ReferenceQueue中。

虚引用(phantom reference)

虚引用是“保存”对象能力最弱的引用,一般用来实现scheduling pre-mortem cleanup actions in a more flexible way than is possible with the Java finalization mechanism

调用虚引用的get方法,总会返回null,与软引用和弱引用不同的是,虚引用被enqueued时,GC 并不会自动清理虚引用指向的对象,只有当指向该对象的所有虚引用全部被清理(enqueued后)后或其本身不可达时,该对象才会被清理。

WeakHashMap.Entry

上面介绍了很多引用的知识点,其实WeakHashMap本身没什么好说的,只要是把引用的作用与使用场景搞清楚了,再来分析基于这些引用的对象就会很简单了。 WeakHashMapHashMap的签名与构造函数一样,这里就不介绍了,这里重点介绍下Entry这个内部对象,因为其保存具体key-value对,所以把它弄清楚了,其他的就问题不大了。

 1   /**
 2     * The entries in this hash table extend WeakReference, using its main ref
 3     * field as the key.
 4     */
 5    private static class Entry<K,V> extends WeakReference<Object> implements Map.Entry<K,V> {
 6        V value;
 7        int hash;
 8        Entry<K,V> next;
 9
10        /**
11         * Creates new entry.
12         */
13        Entry(Object key, V value,
14              ReferenceQueue<Object> queue,
15              int hash, Entry<K,V> next) {
16            //这里把key传给了父类WeakReference,说明key为弱引用(没有显式的 this.key = key)
17            //所有如果key只有通过弱引用访问时,key会被 GC 清理掉
18            //同时该key所代表的Entry会进入queue中,等待被处理
19            //还可以看到value为强引用(有显式的 this.value = value ),但这并不影响
20            //后面可以看到WeakHashMap.expungeStaleEntries方法是如何清理value的
21            super(key, queue);
22            this.value = value;
23            this.hash  = hash;
24            this.next  = next;
25        }
26
27        @SuppressWarnings("unchecked")
28        //在获取key时需要unmaskNull,因为对于null的key,是用WeakHashMap的内部成员属性来表示的
29        public K getKey() {
30            return (K) WeakHashMap.unmaskNull(get());
31        }
32
33        public V getValue() {
34            return value;
35        }
36
37        public V setValue(V newValue) {
38            V oldValue = value;
39            value = newValue;
40            return oldValue;
41        }
42        public boolean equals(Object o) {
43            if (!(o instanceof Map.Entry))
44                return false;
45            Map.Entry<?,?> e = (Map.Entry<?,?>)o;
46            K k1 = getKey();
47            Object k2 = e.getKey();
48            if (k1 == k2 || (k1 != null && k1.equals(k2))) {
49                V v1 = getValue();
50                Object v2 = e.getValue();
51                if (v1 == v2 || (v1 != null && v1.equals(v2)))
52                    return true;
53            }
54            return false;
55        }
56
57        public int hashCode() {
58            K k = getKey();
59            V v = getValue();
60            return ((k==null ? 0 : k.hashCode()) ^
61                    (v==null ? 0 : v.hashCode()));
62        }
63
64        public String toString() {
65            return getKey() + "=" + getValue();
66        }
67    }

WeakHashMap.expungeStaleEntries

 1    /**
 2     * Reference queue for cleared WeakEntries
 3     */
 4    // 所有Entry在构造时都传入该queue
 5    private final ReferenceQueue<Object> queue = new ReferenceQueue<>();
 6
 7    /**
 8     * Expunges stale entries from the table.
 9     */
10    private void expungeStaleEntries() {
11        for (Object x; (x = queue.poll()) != null; ) {
12            synchronized (queue) {
13                // e 为要清理的对象
14                @SuppressWarnings("unchecked")
15                    Entry<K,V> e = (Entry<K,V>) x;
16                int i = indexFor(e.hash, table.length);
17
18                Entry<K,V> prev = table[i];
19                Entry<K,V> p = prev;
20                // while 循环遍历冲突链
21                while (p != null) {
22                    Entry<K,V> next = p.next;
23                    if (p == e) {
24                        if (prev == e)
25                            table[i] = next;
26                        else
27                            prev.next = next;
28                        // Must not null out e.next;
29                        // stale entries may be in use by a HashIterator
30                        // 可以看到这里把value赋值为null,来帮助 GC 回收强引用的value
31                        e.value = null; // Help GC
32                        size--;
33                        break;
34                    }
35                    prev = p;
36                    p = next;
37                }
38            }
39        }
40    }

知道了expungeStaleEntries方法的作用,下面看看它是何时被调用的

expungeStaleEntries调用链

可以看到,在对WeakHashMap进行增删改查时,都调用了expungeStaleEntries方法。

实战

上面说了,下面来个具体的例子帮助大家消化

 1import java.util.WeakHashMap;
 2
 3class KeyHolder {
 4    @Override
 5    protected void finalize() throws Throwable {
 6        System.out.println("I am over from key");
 7        super.finalize();
 8    }
 9}
10class ValueHolder {
11    @Override
12    protected void finalize() throws Throwable {
13        System.out.println("I am over from value");
14        super.finalize();
15    }
16}
17
18public class RefTest {
19    public static void main(String[] args) {
20        WeakHashMap<KeyHolder, ValueHolder> weakMap = new WeakHashMap<KeyHolder, ValueHolder>();
21
22        KeyHolder kh = new KeyHolder();    
23        ValueHolder vh = new ValueHolder();
24
25        weakMap.put(kh, vh);
26
27        while (true) {
28            for (KeyHolder key : weakMap.keySet()) {
29                System.out.println(key + " : " + weakMap.get(key));
30            }
31            try {
32                Thread.sleep(2000);
33            } catch (InterruptedException e) {
34                e.printStackTrace();
35            }
36            System.out.println("here...");
37            //这里把kh设为null,这样一来就只有弱引用指向kh指向的对象
38            kh = null;
39            System.gc();
40        }
41    }
42}

输出

KeyHolder@a15670a : ValueHolder@20e1ed5b
here...
I am over from key   //输出这句话说明,该key对应的Entry已经被 GC 清理
here...
here...
here...
...
...
...

总结

说实话,之前我是没怎么了解过引用,更是没有用过WeakHashMap这个类,这次算是把这个坑给填上了。引用的使用场景应该是在常驻类或消耗内存较大应用中才用得上,我自己确实没怎么经历过这种类型的项目,只能现在打好基础,以后有机会在尝试。

其实关于引用,本文重点介绍了弱引用的使用场景,其他的没怎么介绍,感兴趣的可以阅读参考中给出的链接。😊

参考

评论

欢迎读者通过邮件与我交流,也可以在 MastodonTwitter 上关注我。