CKTIS / Java
WeakReference — słaba referencja do obiektu
WeakReference<T> przechowuje słabą referencję, która nie zapobiega odzyskaniu pamięci obiektu przez garbage collector. Odczyt przez get() może zwrócić null; clear() usuwa referencję bez usuwania samego obiektu.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
WeakReference<T> ref = new WeakReference<>(referent);
// Alternative: WeakReference<T> ref = new WeakReference<>(referent, queue);
T value = ref.get();
ref.clear();WeakReference<T> z pakietu java.lang.ref nie utrzymuje wskazywanego obiektu przy życiu tak jak silna referencja. Gdy garbage collector uzna obiekt za słabo osiągalny, czyści odpowiednie słabe referencje. Typowym zastosowaniem są mapowania kanonizujące, które nie mają utrzymywać obiektów przy życiu.
Konstruktor WeakReference(referent) nie rejestruje kolejki; WeakReference(referent, queue) opcjonalnie rejestruje ReferenceQueue. Referencje wyczyszczone przez GC trafiają do zarejestrowanej kolejki w tym samym lub późniejszym czasie. Samo wyczyszczenie referencji nie oznacza odzyskania pamięci obiektu.
Odziedziczone get() zwraca obiekt albo null. Pobierz wynik raz do zmiennej lokalnej i sprawdź ją przed użyciem: niezerowy wynik jest silną referencją. clear() czyści referencję, ale nie dodaje jej do kolejki ani nie niszczy obiektu.
Przykład celowo wywołuje clear(), zamiast czekać na GC. Reference.reachabilityFence(value) zapewnia silną osiągalność value do tego miejsca, dzięki czemu wynik jest deterministyczny.
Przykłady
import java.lang.ref.Reference;
import java.lang.ref.WeakReference;
public class Main {
public static void main(String[] args) {
Object value = new Object();
WeakReference<Object> ref = new WeakReference<>(value);
System.out.println(ref.get() == value);
ref.clear();
System.out.println(ref.get() == null);
System.out.println(value != null);
Reference.reachabilityFence(value);
}
}Wynik
true true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.