CKTIS / Java
PhantomReference — referencja fantomowa
PhantomReference<T> umożliwia obsługę powiadomień o zmianie osiągalności obiektu bez dostępu do niego przez get(). Współpracuje z ReferenceQueue; przykład pokazuje deterministyczne, ręczne umieszczenie referencji w kolejce.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
PhantomReference<T> ref = new PhantomReference<>(referent, queue);PhantomReference<T> z java.lang.ref służy do planowania sprzątania po obiekcie. W przeciwieństwie do WeakReference i SoftReference nie udostępnia obiektu przez get() — ta metoda zawsze zwraca null. Konstruktor przyjmuje obiekt i ReferenceQueue<? super T>; kolejka null oznacza brak powiadomień przez kolejkę.
Gdy GC stwierdzi osiągalność fantomową, atomowo czyści odpowiednią grupę referencji fantomowych, a następnie, od razu lub później, umieszcza zarejestrowane referencje w ich kolejkach. Program musi utrzymywać osiągalność samej PhantomReference; rejestracja w kolejce jej nie zapewnia. Dane potrzebne do sprzątania przechowuj oddzielnie, bez silnej referencji do obserwowanego obiektu.
refersTo(obj) sprawdza tożsamość obiektu wskazywanego przez referencję, a refersTo(null) wykrywa jej wyczyszczenie. Samo clear() nie dodaje referencji do kolejki. Natomiast enqueue() czyści ją i dodaje do kolejki, jeśli to możliwe; ręczne wywołanie nie dowodzi odzyskania pamięci przez GC.
Przykład celowo używa enqueue() zamiast oczekiwania na GC. Reference.reachabilityFence(referent) utrzymuje silną osiągalność obiektu do końca demonstracji, eliminując wyścig z GC. poll() pobiera samą referencję, nie obserwowany obiekt. Kod pokazuje mechanikę kolejki, a nie implementację sprzątania zasobów.
Przykłady
import java.lang.ref.PhantomReference;
import java.lang.ref.Reference;
import java.lang.ref.ReferenceQueue;
public class Main {
public static void main(String[] args) {
Object referent = new Object();
ReferenceQueue<Object> queue = new ReferenceQueue<>();
PhantomReference<Object> ref = new PhantomReference<>(referent, queue);
System.out.println(ref.get() == null);
System.out.println(ref.refersTo(referent));
System.out.println(ref.enqueue());
System.out.println(ref.refersTo(null));
System.out.println(queue.poll() == ref);
System.out.println(queue.poll() == null);
Reference.reachabilityFence(referent);
}
}Wynik
true true true true true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.