CKTIS / Java
PhantomReference — fantomske reference
PhantomReference<T> omogućuje obavijesti o promjenama dostupnosti objekta bez izlaganja objekta putem get(). Radi s ReferenceQueue; primjer prikazuje determinističko ručno stavljanje reference u red.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
PhantomReference<T> ref = new PhantomReference<>(referent, queue);PhantomReference<T> iz java.lang.ref omogućuje pripremu čišćenja nakon životnog vijeka objekta. Za razliku od WeakReference i SoftReference, referencirani objekt ne izlaže putem get() — ta metoda uvijek vraća null. Konstruktor prima referencirani objekt i ReferenceQueue<? super T>; red null znači da neće biti obavijesti putem reda.
Kada GC utvrdi fantomsku dostupnost, atomski čisti odgovarajuću skupinu fantomskih referenci te registrirane reference stavlja u njihove redove odmah ili kasnije. Program mora održavati dostupnom samu PhantomReference; registracija u redu to ne osigurava. Podatke potrebne za čišćenje pohrani zasebno, bez snažne reference na nadzirani objekt.
refersTo(obj) provjerava identitet referenciranog objekta, dok refersTo(null) otkriva je li referenca očišćena. Sam poziv clear() ne stavlja referencu u red. Nasuprot tome, enqueue() je čisti i, ako je moguće, dodaje u njezin red; ručni poziv ne dokazuje da je GC oslobodio memoriju.
Primjer namjerno koristi enqueue() umjesto čekanja na GC. Reference.reachabilityFence(referent) održava referencirani objekt snažno dostupnim tijekom cijelog prikaza i tako sprječava utrku s GC-om. poll() dohvaća objekt reference, a ne referencirani objekt. Kod prikazuje rad reda, a ne implementaciju čišćenja resursa.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.