Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła