パッケージ java.lang.ref

参照オブジェクトクラスを提供し、限定されたレベルでのガベージコレクタとの対話を可能にします。

参照: 説明

クラスのサマリー

クラス	説明
PhantomReference<T>	ファントム参照オブジェクトです。 ファントム参照オブジェクトがキューに入れられるのは、キューに入れておかないとそれらのリファレントが再生される可能性があるとコレクタが判断したときです。
Reference<T>	参照オブジェクトための抽象基底クラスです。
ReferenceQueue<T>	参照キューです。到達可能性が適切に変更されたことが検出されると、登録されている参照オブジェクトはガベージコレクタによって参照キューに追加されます。
SoftReference<T>	メモリー要求に応じてガベージコレクタの判断でクリアされるソフト参照オブジェクトです。
WeakReference<T>	弱参照オブジェクトです。 弱参照オブジェクトは、その弱参照オブジェクトのリファレントがファイナライズ可能になり、ファイナライズされ、そして再生されることを阻止することはありません。

パッケージ java.lang.ref の説明

参照オブジェクトクラスを提供し、限定されたレベルでのガベージコレクタとの対話を可能にします。ほかのあるオブジェクトがガベージコレクタによってすでに再生されていても、そのオブジェクトを指す参照を維持したい場合に、プログラムは参照オブジェクトを使うことができます。さらに、プログラムは、あるオブジェクトへの到達可能性が変わったとガベージコレクタが判断したあとで、通知を受けるようにすることができます。

パッケージの仕様

参照オブジェクトは、その参照自体をほかのオブジェクトと同じように検査および操作できるようにするために、ほかのオブジェクトへの参照をカプセル化します。弱いものから順に、ソフト、弱、およびファントムという 3 種類の参照オブジェクトが提供されます。各型は、次に定義されているように、対応する到達可能性のレベルがそれぞれ異なります。ソフト参照は、メモリーセンシティブなキャッシュを実装するために提供されます。弱参照は、キーまたは値が再利用されることを阻止しない正規化マッピングを実装するために提供されます。ファントム参照は、Java のファイナライズメカニズムよりも柔軟な方法で、プリモルテムクリーンアップアクションをスケジューリングするために提供されます。

各型の参照オブジェクトは、抽象基底 Reference クラスのサブクラスによって実装されます。それらのサブクラスのインスタンスは、リファレントと呼ばれる、特定のオブジェクトへの参照をカプセル化します。各参照オブジェクトは、参照を取得およびクリアするためのメソッドを提供します。クリア処理は提供されますが、参照オブジェクトは不変であるため、set オペレーションは提供されません。プログラムは、これらのサブクラスをさらにサブクラス化して目的にあったフィールドおよびメソッドを追加することも、これらのサブクラスを変更しないでそのまま使うこともできます。

通知

プログラムは、適切な参照オブジェクトをそれが作成された時点で参照キューに登録することによって、オブジェクトの到達可能性が変更された通知を受け取るように要求できます。リファレントの到達可能性がその参照型に対応する値に変更されたと判断したあとに、ガベージコレクタはその参照を関連したキューに追加します。この時点で、参照はキューに入っているとみなされます。プログラムは、参照が利用可能になるまでポーリングまたはブロックすることによって、キューから参照を削除できます。参照キューは、ReferenceQueue クラスによって実装されます。

登録された参照オブジェクトとそのキューの関係は一方向です。つまり、キューは登録されている参照の履歴を記録しません。登録されている参照自体が到達不可能になると、それは絶対にキューに入れられません。参照オブジェクトを使用してプログラムがリファレントを必要とするかぎりオブジェクトを到達可能にしておくことはプログラムの責任です。

プログラムによっては、あるスレッドを、1 つ以上のキューからの参照オブジェクトの削除およびそれらの処理専用にするように選択されますが、これは、まったく必要ありません。多くの場合にうまく機能する方法は、かなり頻繁に行われるほかのアクションを実行する間に参照キューを検査することです。たとえば、弱キーを実装するために弱参照を使用するハッシュテーブルの場合は、テーブルがアクセスされるたびに自分の参照キューに対してポーリングします。WeakHashMap クラスはこの方法で機能します。ReferenceQueue.poll メソッドは単に内部データ構造をチェックするだけなので、このチェックがハッシュテーブルアクセスメソッドに与えるオーバーヘッドはごくわずかです。

自動的にクリアされる参照

ソフト参照および弱参照は、それらが登録されているキューに追加される前にコレクタによって自動的にクリアされます。そのため、ソフト参照および弱参照は、有効になるためにキューに登録される必要はありません (ファントム参照は必要)。ファントム参照を介して到達可能なオブジェクトは、ファントム参照がすべてクリアされるか、ファントム参照自体が到達不可能になるまで到達可能です。

到達可能性

到達可能性には最強から最弱までのレベルがあり、これはオブジェクトのライフサイクルを反映します。それらは、機能的に次のように定義されます。

• 強到達可能なオブジェクトとは、参照オブジェクトをトラバースすることなく、あるスレッドによって到達できるオブジェクト。新しく作成されたオブジェクトは、それを作成したスレッドにより強到達可能。
• ソフト到達可能なオブジェクトとは、強到達可能ではないが、ソフト参照をトラバースすることで到達できるオブジェクト。
• 弱到達可能なオブジェクトとは、強到達可能でもソフト到達可能でもないが、弱参照をトラバースすることで到達できるオブジェクト。弱到達可能なオブジェクトへの弱参照がクリアされると、そのオブジェクトはファイナライズの対象となる。
• ファントム到達可能オブジェクトとは、強到達可能でも、ソフト到達可能でも、弱到達可能でもなく、ファイナライズされており、ファントム参照がそれを指しているオブジェクト。
• 最後に、オブジェクトがどのようにも到達できない場合、そのオブジェクトは到達不可能であり、そのため再生の対象となる。

導入されたバージョン:

1.2