java.lang.ref

クラス ReferenceQueue<T>

java.lang.Object

java.lang.ref.ReferenceQueue<T>

public class ReferenceQueue<T>
extends Object

参照キューです。到達可能性が適切に変更されたことが検出されると、登録されている参照オブジェクトはガベージコレクタによって参照キューに追加されます。

導入されたバージョン:

1.2

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

コンストラクタ

コンストラクタと説明
ReferenceQueue() 新しい参照オブジェクトキューを構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
Reference<? extends T>	poll() このキューをポーリングして、参照オブジェクトが利用可能かどうかを確認します。
Reference<? extends T>	remove() このキューの次の参照オブジェクトを削除します。参照オブジェクトが利用可能になるまでブロックされます。
Reference<? extends T>	remove(long timeout) このキューの次の参照オブジェクトを削除します。参照オブジェクトが利用可能になるか、指定されたタイムアウトの期限が切れるまでブロックします。

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

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

コンストラクタの詳細

ReferenceQueue

public ReferenceQueue()

新しい参照オブジェクトキューを構築します。

メソッドの詳細

poll

public Reference<? extends T> poll()

このキューをポーリングして、参照オブジェクトが利用可能かどうかを確認します。参照オブジェクトが遅延なしで利用可能な場合、それがキューから削除されて、返されます。それ以外の場合、このメソッドは即座に null を返します。

戻り値:

利用可能な参照オブジェクトがあった場合はその参照オブジェクト、そうでない場合は null

remove

public Reference<? extends T> remove(long timeout)
                              throws IllegalArgumentException,
                                     InterruptedException

このキューの次の参照オブジェクトを削除します。参照オブジェクトが利用可能になるか、指定されたタイムアウトの期限が切れるまでブロックします。

このメソッドはリアルタイム保証を行いません。Object.wait(long) メソッドを呼び出した場合と同様にタイムアウトのスケジュールを作成します。

パラメータ:

timeout - 値が正の場合、このキューに参照が追加されるのを待つ間、timeout ミリ秒の間ブロックされる。0 の場合、無期限にブロックされる。

戻り値:

指定されたタイムアウト期間に利用可能になった場合は参照オブジェクト、そうでない場合は null

例外:

IllegalArgumentException - timeout 引数の値が負の場合

InterruptedException - タイムアウト待機中に割り込まれた場合

remove

public Reference<? extends T> remove()
                              throws InterruptedException

このキューの次の参照オブジェクトを削除します。参照オブジェクトが利用可能になるまでブロックされます。

戻り値:

参照オブジェクト。1 つが利用可能になるまでブロックを行う

例外:

InterruptedException - 待機中に割り込まれた場合