CKTIS / Java
PhantomReference — fantómové referencie
PhantomReference<T> umožňuje získavať oznámenia o zmenách dosiahnuteľnosti objektu bez toho, aby ho sprístupnila cez get(). Spolupracuje s ReferenceQueue; príklad ukazuje deterministické manuálne zaradenie referencie do frontu.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
PhantomReference<T> ref = new PhantomReference<>(referent, queue);PhantomReference<T> z java.lang.ref slúži na prípravu upratania po skončení životného cyklu objektu. Na rozdiel od WeakReference a SoftReference nesprístupňuje odkazovaný objekt cez get() — táto metóda vždy vracia null. Konštruktor prijíma odkazovaný objekt a ReferenceQueue<? super T>; front null znamená, že nebudú prebiehať oznámenia prostredníctvom frontu.
Keď GC zistí fantómovú dosiahnuteľnosť, atómovo vymaže príslušnú skupinu fantómových referencií a registrované referencie zaradí do ich frontov hneď alebo neskôr. Program musí udržiavať dosiahnuteľnú samotnú PhantomReference; registrácia vo fronte to nezaručuje. Údaje potrebné na upratanie uchovávajte oddelene, bez silného odkazu na sledovaný objekt.
refersTo(obj) overuje identitu odkazovaného objektu, zatiaľ čo refersTo(null) zisťuje, či bola referencia vymazaná. Samotné zavolanie clear() referenciu do frontu nezaradí. Naopak, enqueue() ju vymaže a ak je to možné, pridá ju do jej frontu; manuálne zavolanie nedokazuje, že GC uvoľnil pamäť.
Príklad zámerne používa enqueue() namiesto čakania na GC. Reference.reachabilityFence(referent) udržiava odkazovaný objekt počas celej ukážky silno dosiahnuteľný a predchádza tak preteku s GC. poll() získa objekt referencie, nie odkazovaný objekt. Kód ukazuje fungovanie frontu, nie implementáciu upratovania zdrojov.
Prí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ýsledok
true true true true true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.