Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

SoftReference — referencja miękka

SoftReference<T> z pakietu java.lang.ref przechowuje referencję miękką do obiektu. Gdy obiekt nie jest już silnie osiągalny, garbage collector może ją wyczyścić w odpowiedzi na zapotrzebowanie na pamięć. Odczyt przez get() wymaga obsługi null.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

new SoftReference<T>(referent)
new SoftReference<T>(referent, queue)
T value = reference.get();
reference.clear();

SoftReference<T> opakowuje referencję do obiektu typu T. Obiekt jest miękko osiągalny, jeśli nie jest silnie osiągalny, ale można do niego dotrzeć przez referencję miękką. Silna osiągalność nie wymaga przechodzenia przez obiekty referencji; słaba osiągalność wyklucza zarówno silną, jak i miękką osiągalność.

Garbage collector może wyczyścić referencje miękkie pod presją pamięci. Nie ma gwarancji czasu ani kolejności czyszczenia, choć wszystkie referencje miękkie do miękko osiągalnych obiektów zostaną wyczyszczone przed zgłoszeniem OutOfMemoryError. To mechanizm dla pamięci podręcznych reagujących na dostępność pamięci, nie gwarancja czasu przechowywania ani uniknięcia błędu braku pamięci.

get() zwraca silną referencję do obiektu albo null. Zapisz wynik raz w zmiennej lokalnej i sprawdź go przed użyciem. clear() czyści referencję, ale nie usuwa obiektu ani innych referencji i nie dodaje opakowania do kolejki. Konstruktor SoftReference(T referent, ReferenceQueue<? super T> q) pozwala zarejestrować kolejkę; zachowaj osiągalność samego opakowania, jeśli oczekujesz powiadomienia.

Przykład jawnie wywołuje clear(), zamiast uzależniać wynik od działania garbage collectora. Reference.reachabilityFence(value) utrzymuje silną osiągalność value do tego miejsca. Dlatego pierwszy odczyt jest przewidywalny, a zapisany snapshot pozostaje dostępny po wyczyszczeniu opakowania.

Przykłady

import java.lang.ref.Reference;
import java.lang.ref.SoftReference;

public class SoftReferenceDemo {
    public static void main(String[] args) {
        String value = new String("cached");
        SoftReference<String> reference = new SoftReference<>(value);

        String snapshot = reference.get();
        System.out.println(snapshot);
        reference.clear();
        System.out.println(reference.get());
        System.out.println(snapshot);
        Reference.reachabilityFence(value);
    }
}

Wynik

cached
null
cached

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła