クラスSoftReference<T>

java.lang.Object
java.lang.ref.Reference<T>
java.lang.ref.SoftReference<T>
型パラメータ:
T - 紹介のタイプ
public non-sealed class SoftReference<T> extends Reference<T>
メモリー要求に応じてガベージ・コレクタの判断でクリアされるソフト参照オブジェクトです。 ソフト参照は通常、メモリー・センシティブなキャッシュを実装するために使用されます。

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

ソフト到達可能なオブジェクトへのすべてのソフト参照は、仮想マシンがOutOfMemoryErrorをスローする前にクリアされていることが保証されています。 そうでない場合、ソフト参照がクリアされる時点、またはさまざまなオブジェクトへの一連のソフト参照がクリアされる順序に制約はありません。 ただし、仮想マシンの実装は、最近作成されたソフト参照または最近使用されたソフト参照をクリアしないことが奨励されます。

このクラスの直接のインスタンスは、単純なキャッシュを実装するために使用できます。このクラスまたは派生したサブクラスは、より洗練されたキャッシュを実装するために、もっと大きなデータ構造でも使用できます。 ソフト参照のリファレントが強到達可能であるかぎり、つまり実際に使用されているかぎり、ソフト参照はクリアされません。 このため、たとえば洗練されたキャッシュは、エントリへの強いリファレントを維持することで、もっとも新しく使用されたエントリが破棄されることを防ぎ、ほかのエントリはガベージ・コレクタの判断で破棄されるようにできます。

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

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

    コンストラクタ
    コンストラクタ
    説明
    SoftReference(T referent)
    指定されたオブジェクトを参照する新しいソフト参照を作成します。
    SoftReference(T referent, ReferenceQueue<? super T> q)
    指定されたオブジェクトを参照し、指定されたキューに登録されている新しいソフト参照を作成します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    T
    get()
    参照オブジェクトのリファレントを返します。

    クラスリファレンスで宣言されたメソッド

    clear, clone, enqueue, isEnqueued, reachabilityFence, refersTo
    修飾子と型
    メソッド
    説明
    void
    clear()
    この参照オブジェクトをクリアします。
    protected Object
    clone()
    CloneNotSupportedExceptionをスローします。
    boolean
    enqueue()
    この参照オブジェクトをクリアし、登録されているキュー(ある場合)への追加を試みます。
    boolean
    isEnqueued()
    非推奨。
    このメソッドは当初、参照オブジェクトがクリアされてエンキューされたかどうかをテストするために指定されていましたが、このテストを行うために実装されたことはありません。
    static void
    reachabilityFence(Object ref)
    指定されたオブジェクトが「強く到達可能な」のままであることを確認します。
    final boolean
    refersTo(T obj)
    この参照オブジェクトの参照がobjかどうかをテストします。

    クラスオブジェクトで宣言されたメソッド

    equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • SoftReference

      public SoftReference(T referent)
      指定されたオブジェクトを参照する新しいソフト参照を作成します。 新しい参照は、どのキューにも登録されません。
      パラメータ:
      referent - 新しいソフト参照が参照するオブジェクト

    • SoftReference

      public SoftReference(T referent, ReferenceQueue<? super T> q)
      指定されたオブジェクトを参照し、指定されたキューに登録されている新しいソフト参照を作成します。
      パラメータ:
      referent - 新しいソフト参照が参照するオブジェクト
      q - 参照が登録されるキュー、または登録が不要な場合はnull

  • メソッドの詳細

    • get

      public T get()
      参照オブジェクトのリファレントを返します。 プログラムまたはガベージ・コレクタによって、この参照オブジェクトがすでにクリアされている場合、このメソッドはnullを返します。
      オーバーライド:
      get、クラスReference<T>
      戻り値:
      この参照が表すオブジェクト。この参照オブジェクトがクリアされている場合はnull
      関連項目: