com.google.common.base
Class FinalizableSoftReference<T>

java.lang.Object
  java.lang.ref.Reference<T>
      java.lang.ref.SoftReference<T>
          com.google.common.base.FinalizableSoftReference<T>

All Implemented Interfaces:

FinalizableReference

public abstract class FinalizableSoftReference<T>
extends SoftReference<T>
implements FinalizableReference

Soft reference with a finalizeReferent() method which a background thread invokes after the garbage collector reclaims the referent. This is a simpler alternative to using a ReferenceQueue.

Since:

2.0 (imported from Google Collections Library)

Author:

Bob Lee

Constructor Summary

protected

FinalizableSoftReference(T referent, FinalizableReferenceQueue queue) Deprecated. FinalizableReferenceQueue is an unsound mechanism for cleaning up references, because (1) it's single thread can be easily overloaded, and (2) it's insistance on running a background thread is problematic in certain environments. This class is scheduled for deletion in December 2012.

Method Summary

Methods inherited from class java.lang.ref.SoftReference

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

Methods inherited from interface com.google.common.base.FinalizableReference

finalizeReferent

Constructor Detail

FinalizableSoftReference

@Deprecated
protected FinalizableSoftReference(T referent,
                                              FinalizableReferenceQueue queue)

Deprecated. FinalizableReferenceQueue is an unsound mechanism for cleaning up references, because (1) it's single thread can be easily overloaded, and (2) it's insistance on running a background thread is problematic in certain environments. This class is scheduled for deletion in December 2012.

Constructs a new finalizable soft reference.

Parameters:

referent - to softly reference

queue - that should finalize the referent