CKTIS / Java
Cykl życia referencji słabych, miękkich i fantomowych w Javie
Sprawdź, kiedy referencja udostępnia obiekt, co trafia do kolejki i jak `reachabilityFence` utrzymuje silną osiągalność obiektu.
Wersja: Java SE 21
Składnia
Java SE 21 · java.lang.ref (module java.base)
new WeakReference<T>(referent)
new WeakReference<T>(referent, queue)
new SoftReference<T>(referent)
new SoftReference<T>(referent, queue)
new PhantomReference<T>(referent, queue)
new ReferenceQueue<T>()
// Registered constructors accept ReferenceQueue<? super T>.
T value = reference.get();
reference.clear();
boolean added = reference.enqueue();
Reference.reachabilityFence(referent);
// For a queue of type ReferenceQueue<T>:
Reference<? extends T> ready = queue.poll();
Reference<? extends T> next = queue.remove(); // throws InterruptedException
Reference<? extends T> timed = queue.remove(timeoutMillis); // long; throws InterruptedExceptionW java.lang.ref (moduł java.base) obiekt referencji i wskazywany przez niego obiekt to dwie różne rzeczy. Gdy odśmiecacz (GC) stwierdzi, że obiekt jest słabo osiągalny, czyli nie jest osiągalny silnie ani miękko, ale można do niego dotrzeć przez słabą referencję, czyści jego WeakReference. Referencje SoftReference do miękko osiągalnych obiektów GC może czyścić według uznania w odpowiedzi na zapotrzebowanie na pamięć. Przed zgłoszeniem OutOfMemoryError maszyna wirtualna gwarantuje wyczyszczenie wszystkich takich referencji miękkich, ale nie określa poza tym terminu ani kolejności ich czyszczenia. PhantomReference służy do powiadamiania na potrzeby sprzątania: GC czyści ją po stwierdzeniu fantomowej osiągalności obiektu, a get() zawsze zwraca null.
Konstruktory słabe i miękkie przyjmują sam obiekt albo obiekt i ReferenceQueue<? super T>. Konstruktor fantomowy zawsze wymaga argumentu kolejki. Przekazanie null zamiast kolejki oznacza brak rejestracji. W referencji słabej lub miękkiej get() zwraca wskazywany obiekt albo null, jeśli go nie ma, np. po wyczyszczeniu. Pobierz wynik raz i po sprawdzeniu użyj tej samej lokalnej zmiennej. clear() usuwa powiązanie, ale samo nie dodaje referencji do kolejki ani nie zwalnia obiektu. enqueue() czyści referencję i próbuje ręcznie dodać ją do zarejestrowanej kolejki; zwraca true, jeśli dodanie się udało.
Statyczne Reference.reachabilityFence(obj) utrzymuje obj silnie osiągalny co najmniej do końca wywołania, nawet jeśli kod wcześniej przestał jawnie go używać. Po operacji wymagającej żywego obiektu umieść wywołanie w finally, aby wykonało się również po wyjątku. Przekaż sam obiekt, nie trzymającą go słabą, miękką lub fantomową referencję. Metoda nie uruchamia GC ani finalizacji; dla null nie robi nic.
Z ReferenceQueue<T> pobierasz obiekt Reference<? extends T>, nie wskazywany obiekt. poll() usuwa i zwraca dostępną referencję lub natychmiast zwraca null. remove() czeka bez limitu; remove(long timeout) dla dodatniej wartości czeka z limitem w milisekundach i zwraca null po jego upływie, bez gwarancji czasu rzeczywistego. 0 oznacza czekanie bez limitu, a wartość ujemna powoduje IllegalArgumentException. Przerwanie oczekiwania w obu wersjach remove powoduje InterruptedException.
GC dodaje zarejestrowaną referencję w chwili czyszczenia lub później; momentu tego nie da się przewidzieć. Puste poll() nie oznacza, że obiekt nadal żyje. Dopóki potrzebujesz powiadomienia, utrzymuj silną referencję do zarejestrowanego obiektu referencji: sama rejestracja nie utrzymuje go przy życiu. Nie uzależniaj terminowego zamykania zasobów od kolejki GC.
Przykłady
import java.lang.ref.PhantomReference;
import java.lang.ref.Reference;
import java.lang.ref.ReferenceQueue;
import java.lang.ref.SoftReference;
import java.lang.ref.WeakReference;
public class ReferenceLifecycle {
public static void main(String[] args) throws InterruptedException {
Object target = new Object();
ReferenceQueue<Object> queue = new ReferenceQueue<>();
WeakReference<Object> weak = new WeakReference<>(target, queue);
SoftReference<Object> soft = new SoftReference<>(target);
PhantomReference<Object> phantom = new PhantomReference<>(target, queue);
try {
System.out.println("weak.get() == target: " + (weak.get() == target));
System.out.println("soft.get() == target: " + (soft.get() == target));
weak.clear();
soft.clear();
System.out.println("weak.get() == null: " + (weak.get() == null));
System.out.println("soft.get() == null: " + (soft.get() == null));
System.out.println("poll() after clear: " + queue.poll());
if (!weak.enqueue()) {
throw new IllegalStateException("Expected weak reference to be enqueued");
}
System.out.println("remove(1000) == weak: " + (queue.remove(1000) == weak));
System.out.println("phantom.get() == null: " + (phantom.get() == null));
if (!phantom.enqueue()) {
throw new IllegalStateException("Expected phantom reference to be enqueued");
}
System.out.println("remove() == phantom: " + (queue.remove() == phantom));
} finally {
Reference.reachabilityFence(target);
}
}
}Wynik
weak.get() == target: true soft.get() == target: true weak.get() == null: true soft.get() == null: true poll() after clear: null remove(1000) == weak: true phantom.get() == null: true remove() == phantom: true
Bariera utrzymuje `target` silnie osiągalny, a ręczne `enqueue()` zasila kolejkę przed każdym `remove`. Przykład pokazuje różnicę między czyszczeniem a kolejkowaniem, a nie zachowanie czasowe GC ani upływ limitu.
Powiązane lekcje
- Java · Lekcja 45 · Zaawansowany · Wersja: 2