compact1, compact2, compact3

java.lang.ref

Class SoftReference<T>

java.lang.Object

java.lang.ref.Reference<T>

java.lang.ref.SoftReference<T>

public class SoftReference<T>
extends Reference<T>

软参考对象，由垃圾收集器根据内存需求自行清除。 软引用通常用于实现内存敏感缓存。

假设垃圾收集器在某个时间点确定对象是softly reachable 。 那时候，它可能会选择原子地清除对该对象的所有软引用，以及对任何其他可轻松访问的对象的所有软引用，该对象可以通过一个强引用链来访问该对象。 在同一时间或稍后的时间，它将排入在引用队列中注册的新清除的软引用。

在虚拟机抛出OutOfMemoryError之前，所有软引用对象可以保证被清除。 否则，在清除软引用的时间或者对一组对不同对象的引用将被清除的顺序没有约束。 但是，鼓励虚拟机实现偏离清除最近创建或最近使用的软参考。

此类的直接实例可用于实现简单的缓存; 此类或派生子类也可用于较大的数据结构以实现更复杂的高速缓存。 只要软参考的指示是强有力的，即实际使用中，软参考将不会被清除。 因此，复杂的缓存可以例如阻止其最近使用的条目被丢弃，通过保持对这些条目的强烈的指示，使剩余的条目由垃圾收集器判断丢弃。

从以下版本开始：

1.2

构造方法摘要

构造方法

Constructor and Description
SoftReference(T referent) 创建引用给定对象的新的软参考。
SoftReference(T referent, ReferenceQueue<? super T> q) 创建引用给定对象并在给定队列中注册的新软引用。

方法摘要

Modifier and Type	Method and Description
T	get() 返回此引用对象的指示。

Methods inherited from class java.lang.ref.Reference

clear, enqueue, isEnqueued

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

SoftReference

public SoftReference(T referent)

创建引用给定对象的新的软参考。 新引用未注册到任何队列。

参数

referent - 对新的软参考将参考

SoftReference

public SoftReference(T referent,
                     ReferenceQueue<? super T> q)

创建引用给定对象并在给定队列中注册的新软引用。

参数

referent - 对象新的软参考将参考

q - 要注册参考的队列，如果不需要注册， 则为 null

方法详细信息

get

public T get()

返回此引用对象的指示。 如果此引用对象已被清除，无论是程序还是垃圾收集器，则此方法返回null 。

重写：

get在类别 Reference<T>

结果

The object to which this reference refers, or null if this reference object has been cleared