CKTIS / Java
PhantomReference — riferimenti fantasma
PhantomReference<T> consente di ricevere notifiche sui cambiamenti di raggiungibilità di un oggetto senza esporlo tramite get(). Funziona con una ReferenceQueue; l’esempio mostra l’accodamento manuale e deterministico.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
PhantomReference<T> ref = new PhantomReference<>(referent, queue);PhantomReference<T>, in java.lang.ref, consente di predisporre la pulizia successiva al ciclo di vita di un oggetto. A differenza di WeakReference e SoftReference, non permette di ottenere l’oggetto referenziato tramite get() — questo metodo restituisce sempre null. Il costruttore accetta un oggetto referenziato e una ReferenceQueue<? super T>; una coda null significa che non ci saranno notifiche tramite coda.
Quando il GC rileva una raggiungibilità fantasma, cancella atomicamente il gruppo corrispondente di riferimenti fantasma e inserisce i riferimenti registrati nelle rispettive code, subito o in seguito. Il programma deve mantenere raggiungibile la PhantomReference stessa; la registrazione in una coda non lo garantisce. Conserva separatamente i dati necessari alla pulizia, senza un riferimento forte all’oggetto monitorato.
refersTo(obj) verifica l’identità dell’oggetto referenziato, mentre refersTo(null) rileva se il riferimento è stato cancellato. La sola chiamata a clear() non inserisce il riferimento nella coda. enqueue(), invece, lo cancella e lo aggiunge alla sua coda se possibile; una chiamata manuale non dimostra che il GC abbia recuperato memoria.
L’esempio usa intenzionalmente enqueue() invece di attendere il GC. Reference.reachabilityFence(referent) mantiene l’oggetto referenziato fortemente raggiungibile per tutta la dimostrazione, evitando una condizione di gara con il GC. poll() recupera l’oggetto riferimento, non l’oggetto referenziato. Il codice mostra il funzionamento della coda, non un’implementazione per la pulizia delle risorse.
Esempi
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);
}
}Risultato
true true true true true true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.