java.lang.ref

クラス PhantomReference<T>

java.lang.Object

java.lang.ref.Reference<T>

java.lang.ref.PhantomReference<T>

public class PhantomReference<T>
extends Reference<T>

ファントム参照オブジェクトです。 ファントム参照オブジェクトがキューに入れられるのは、キューに入れておかないとそれらのリファレントが再生される可能性があるとコレクタが判断したときです。ファントム参照オブジェクトは、ほとんどの場合、Java のファイナライズメカニズムよりも柔軟な方法で、プリモルテムクリーンアップアクションのスケジューリングを行うために使用されます。

ある時点で、ファントム参照のリファレントがファントム到達可能であるとガベージコレクタが判断した場合、その時点またはそのしばらくあとにガベージコレクタはその参照をキューに入れます。

再生可能なオブジェクトをそのままにしておくために、ファントム参照のリファレントを取り出すことはできません。ファントム参照の get メソッドは、常に null を返します。

ソフト参照および弱参照と違って、ファントム参照はそれらがキューに入れられるときにガベージコレクタによって自動的にクリアされません。ファントム参照を介して到達可能なオブジェクトは、すべてのファントム参照がクリアされるか、ファントム参照自身が到達不可能になるまで到達可能です。

導入されたバージョン:

1.2

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
PhantomReference(T referent, ReferenceQueue<? super T> q) 指定されたオブジェクトを参照し、指定されたキューに登録されている新しいファントム参照を作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
T	get() 参照オブジェクトのリファレントを返します。

クラス java.lang.ref.Reference から継承されるメソッド

clear, enqueue, isEnqueued

クラス java.lang.Object から継承されたメソッド

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

コンストラクタの詳細

PhantomReference

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

指定されたオブジェクトを参照し、指定されたキューに登録されている新しいファントム参照を作成します。

null キューでファントム参照を作成できますが、作成された参照はまったく役に立ちません。作成された参照の get メソッドは常に null を返します。また、キューを持たないので、キューに入りません。

パラメータ:

referent - 新しいファントム参照が参照するオブジェクト

q - 参照が登録されるキュー。登録が必要ない場合は null

メソッドの詳細

get

public T get()

参照オブジェクトのリファレントを返します。ファントム参照のリファレントは常にアクセス不可能なため、このメソッドは常に null を返します。

オーバーライド:

get、クラス: Reference<T>

戻り値:

null