Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje