CKTIS / Java
PhantomReference — fantomové reference
PhantomReference<T> umožňuje získávat oznámení o změnách dosažitelnosti objektu, aniž by jej zpřístupnila přes get(). Spolupracuje s ReferenceQueue; příklad ukazuje deterministické ruční zařazení reference do fronty.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
PhantomReference<T> ref = new PhantomReference<>(referent, queue);PhantomReference<T> z java.lang.ref slouží k přípravě úklidu po skončení životního cyklu objektu. Na rozdíl od WeakReference a SoftReference nezpřístupňuje odkazovaný objekt přes get() — tato metoda vždy vrací null. Konstruktor přijímá odkazovaný objekt a ReferenceQueue<? super T>; fronta null znamená, že nebudou probíhat oznámení prostřednictvím fronty.
Když GC zjistí fantomovou dosažitelnost, atomicky vymaže příslušnou skupinu fantomových referencí a registrované reference zařadí do jejich front ihned nebo později. Program musí udržovat dosažitelnou samotnou PhantomReference; registrace ve frontě to nezajišťuje. Data potřebná k úklidu uchovávejte odděleně, bez silného odkazu na sledovaný objekt.
refersTo(obj) ověřuje identitu odkazovaného objektu, zatímco refersTo(null) zjišťuje, zda byla reference vymazána. Samotné zavolání clear() referenci do fronty nezařadí. Naproti tomu enqueue() ji vymaže a pokud je to možné, přidá ji do její fronty; ruční zavolání nedokazuje, že GC uvolnil paměť.
Příklad záměrně používá enqueue() místo čekání na GC. Reference.reachabilityFence(referent) udržuje odkazovaný objekt po celou dobu ukázky silně dosažitelný, a předchází tak závodu s GC, který by jinak mohl referenci vymazat a zařadit do fronty dříve než ruční volání enqueue(). poll() získá objekt reference, nikoli odkazovaný objekt. Kód ukazuje fungování fronty, nikoli implementaci úklidu prostředků.
Příklady
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);
}
}Výsledek
true true true true true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.