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

java.lang.Object
  java.lang.ref.Reference<T>
      java.lang.ref.PhantomReference<T>
          com.google.common.base.FinalizablePhantomReference<T>

All Implemented Interfaces:

FinalizableReference

public abstract class FinalizablePhantomReference<T>
extends PhantomReference<T>
implements FinalizableReference

Phantom 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.

Unlike a normal phantom reference, this reference will be cleared automatically.

Since:

2.0 (imported from Google Collections Library)

Author:

Bob Lee

Constructor Summary

protected

FinalizablePhantomReference(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.PhantomReference

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

FinalizablePhantomReference

@Deprecated
protected FinalizablePhantomReference(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 phantom reference.

Parameters:

referent - to phantom reference

queue - that should finalize the referent