java.lang.ref

クラス Reference<T>

java.lang.Object

java.lang.ref.Reference<T>

直系の既知のサブクラス:

PhantomReference, SoftReference, WeakReference

public abstract class Reference<T>
extends Object

参照オブジェクトための抽象基底クラスです。このクラスは、すべての参照オブジェクトに対して共通のオペレーションを定義します。参照オブジェクトはガベージコレクタと密接に連携して実装されるので、このクラスを直接サブクラス化することはできません。

導入されたバージョン:

1.2

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	clear() この参照オブジェクトをクリアします。
boolean	enqueue() 参照オブジェクトを、それが登録されているキューに追加します。
T	get() 参照オブジェクトのリファレントを返します。
boolean	isEnqueued() この参照オブジェクトが、プログラムまたはガベージコレクタによってキューに入れられているかどうかを判定します。

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

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

メソッドの詳細

get

public T get()

参照オブジェクトのリファレントを返します。プログラムまたはガベージコレクタによって、この参照オブジェクトがすでにクリアされている場合、このメソッドは null を返します。

戻り値:

この参照が表すオブジェクト。この参照オブジェクトがクリアされている場合は null

clear

public void clear()

この参照オブジェクトをクリアします。このメソッドを呼び出しても、このオブジェクトはキューに入りません。

このメソッドは Java コードによってのみ呼び出されます。ガベージコレクタが参照をクリアするときは、このメソッドを呼び出さずに直接行います。

isEnqueued

public boolean isEnqueued()

この参照オブジェクトが、プログラムまたはガベージコレクタによってキューに入れられているかどうかを判定します。この参照オブジェクトが生成されたときにキューに登録されていない場合、このメソッドは常に false を返します。

戻り値:

この参照オブジェクトがキューに入れられている場合にだけ true

enqueue

public boolean enqueue()

参照オブジェクトを、それが登録されているキューに追加します。

このメソッドは Java コードによってのみ呼び出されます。ガベージコレクタが参照をキューに入れるときは、このメソッドを呼び出さずに直接行います。

戻り値:

この参照オブジェクトがキューに入れられた場合は true。すでにキューに入れられているか、作成時にキューに登録されなかった場合は false