java.lang.ref
クラス WeakReference

java.lang.Object
  java.lang.ref.Reference
      java.lang.ref.WeakReference

public class WeakReference
extends Reference

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

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

導入されたバージョン:

1.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)

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

パラメータ:

referent - 新しい弱参照が参照するオブジェクト

WeakReference

public WeakReference(Object referent,
                     ReferenceQueue q)

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

パラメータ:

referent - 新しい弱参照が参照するオブジェクト

q - 弱参照が登録されるキュー

例外:

NullPointerException - queue 引数が null の場合