JavaTM 2 Platform
Std. Ed. v1.3

java.lang.ref
クラス ReferenceQueue

java.lang.Object
  |
  +--java.lang.ref.ReferenceQueue

public class ReferenceQueue
extends Object

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

導入されたバージョン:
1.2

コンストラクタの概要
ReferenceQueue()
          新しい参照オブジェクトキューを構築します。
 
メソッドの概要
 Reference poll()
          このキューをポーリングして参照オブジェクトが利用可能かどうかを判定し、利用可能であればただちにそれを返します。
 Reference remove()
          このキューの次の参照オブジェクトを削除します。
 Reference remove(long timeout)
          このキューの次の参照オブジェクトを削除します。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

ReferenceQueue

public ReferenceQueue()
新しい参照オブジェクトキューを構築します。
メソッドの詳細

poll

public Reference poll()
このキューをポーリングして参照オブジェクトが利用可能かどうかを判定し、利用可能であればただちにそれを返します。キューが空の場合、このメソッドはすぐに null を返します。
戻り値:
利用可能な参照オブジェクトがあった場合は、その参照オブジェクト。そうでない場合は null

remove

public Reference remove(long timeout)
                 throws IllegalArgumentException,
                        InterruptedException
このキューの次の参照オブジェクトを削除します。参照オブジェクトが利用可能になるか、指定されたタイムアウトの期限が切れるまでブロックします。
パラメータ:
timeout - 値が正の場合、このキューに参照が追加されるのを待つ間、timeout ミリ秒の間ブロックされる。0 の場合、無期限にブロックされる
戻り値:
指定されたタイムアウト期間に利用可能になった場合は参照オブジェクト、そうでない場合は null
例外:
IllegalArgumentException - timeout 引数の値が負の場合
InterruptedException - タイムアウト待機中に割り込まれた場合

remove

public Reference remove()
                 throws InterruptedException
このキューの次の参照オブジェクトを削除します。参照オブジェクトが利用可能になるまでブロックされます。
例外:
InterruptedException - 待機中に割り込まれた場合

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.