java.lang.ref
クラス WeakReference

java.lang.Object
  |
  +--java.lang.ref.Reference
        |
        +--java.lang.ref.WeakReference

public class WeakReference

extends Reference

弱参照オブジェクトです。弱参照オブジェクトは、その弱参照オブジェクトのリファレントがファイナライズ可能になり、ファイナライズされ、そして再生されることを阻止することはありません。弱参照は、ほとんどの場合で標準化マッピングを実装するために使用されます。

ある時点で、オブジェクトが弱到達可能であると、ガベージコレクタが判断したとします。その時点で、ガベージコレクタは、そのオブジェクトへの弱参照すべてと、強参照およびソフト参照のチェーンを経由してそのオブジェクトに到達できるような、弱到達可能なほかのオブジェクトへの弱参照すべてを、自動的にクリアします。同時に、ガベージコレクタは以前に弱到達可能だったオブジェクトがすべてファイナライズ可能であることを宣言します。同時にまたはあとで、ガベージコレクタは、参照キューに登録されているそれらの新しくクリアされた弱参照をキューに入れます。

導入されたバージョン:

JDK1.2

コンストラクタの概要

WeakReference(Object referent)
指定されたオブジェクトを参照する、新しい弱参照を作成します。

WeakReference(Object referent, ReferenceQueue q)
指定されたオブジェクトを参照し、指定されたキューに登録されている新しい弱参照を作成します。

クラス java.lang.ref.Reference から継承したメソッド

clear, enqueue, get, isEnqueued

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

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

コンストラクタの詳細

WeakReference

public WeakReference(Object referent)

指定されたオブジェクトを参照する、新しい弱参照を作成します。新しい参照は、どのキューにも登録されません。

WeakReference

public WeakReference(Object referent,
                     ReferenceQueue q)

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

例外:

NullPointerException - queue 引数が null の場合