Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

PhantomReference — referencias fantasma

PhantomReference<T> permite recibir notificaciones de los cambios en la accesibilidad de un objeto sin exponerlo mediante get(). Funciona con una ReferenceQueue; el ejemplo muestra cómo encolar una referencia manualmente de forma determinista.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

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

PhantomReference<T>, de java.lang.ref, permite preparar la limpieza posterior al ciclo de vida de un objeto. A diferencia de WeakReference y SoftReference, no permite obtener el objeto referenciado mediante get(); este método siempre devuelve null. El constructor recibe un objeto referenciado y una ReferenceQueue<? super T>; una cola null significa que no habrá notificaciones mediante una cola.

Cuando el GC detecta accesibilidad fantasma, limpia atómicamente el grupo correspondiente de referencias fantasma y, de inmediato o más adelante, coloca las referencias registradas en sus colas. El programa debe mantener accesible la propia PhantomReference; registrarla en una cola no lo garantiza. Guarda por separado los datos necesarios para la limpieza, sin una referencia fuerte al objeto supervisado.

refersTo(obj) comprueba la identidad del objeto referenciado, mientras que refersTo(null) detecta si se ha limpiado la referencia. Llamar solo a clear() no añade la referencia a la cola. En cambio, enqueue() la limpia y la añade a su cola si es posible; una llamada manual no demuestra que el GC haya recuperado memoria.

El ejemplo usa deliberadamente enqueue() en vez de esperar al GC. Reference.reachabilityFence(referent) mantiene el objeto referenciado fuertemente accesible durante toda la demostración, lo que evita una carrera con el GC. poll() obtiene el objeto referencia, no el objeto referenciado. El código muestra el funcionamiento de la cola, no una implementación de limpieza de recursos.

Ejemplos

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

Resultado

true
true
true
true
true
true

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes