Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

PhantomReference — fantomske reference

PhantomReference<T> omogoča obvestila o spremembah dosegljivosti objekta, ne da bi ga razkrila prek get(). Deluje z ReferenceQueue; primer prikazuje deterministično ročno dodajanje reference v vrsto.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

PhantomReference<T> ref = new PhantomReference<>(referent, queue);

PhantomReference<T> iz java.lang.ref omogoča pripravo na čiščenje po življenjskem ciklu objekta. Za razliko od WeakReference in SoftReference referenčnega objekta ne razkrije prek get() — ta metoda vedno vrne null. Konstruktor sprejme referenčni objekt in ReferenceQueue<? super T>; vrsta null pomeni, da obvestil prek vrste ne bo.

Ko GC zazna fantomsko dosegljivost, atomsko počisti ustrezno skupino fantomskih referenc, nato pa registrirane reference takoj ali pozneje doda v njihove vrste. Program mora ohranjati dosegljivo samo PhantomReference; registracija v vrsti tega ne zagotavlja. Podatke, potrebne za čiščenje, hrani ločeno in brez močne reference na nadzorovani objekt.

refersTo(obj) preveri identiteto referenčnega objekta, refersTo(null) pa zazna, ali je bila referenca počiščena. Sam klic clear() reference ne doda v vrsto. Nasprotno jo enqueue() počisti in jo, če je mogoče, doda v njeno vrsto; ročni klic ne dokazuje, da je GC sprostil pomnilnik.

Primer namerno uporablja enqueue() namesto čakanja na GC. Reference.reachabilityFence(referent) ohranja referenčni objekt močno dosegljiv do konca prikaza in tako prepreči tekmovanje z GC. poll() pridobi objekt reference, ne referenčnega objekta. Koda prikazuje delovanje vrste, ne implementacije čiščenja virov.

Primeri

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);
    }
}

Rezultat

true
true
true
true
true
true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri