CKTIS / Java
ReferenceQueue: recibir objetos de referencia
ReferenceQueue permite recuperar objetos de referencia registrados después de que el recolector de basura o una llamada explícita a enqueue() los añada. Aprende la diferencia entre poll(), que no bloquea, y las variantes bloqueantes de remove().
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
ReferenceQueue<T> queue = new ReferenceQueue<>();
Reference<? extends T> ready = queue.poll();
Reference<? extends T> next = queue.remove();
Reference<? extends T> timed = queue.remove(timeoutMillis);ReferenceQueue<T> del paquete java.lang.ref recibe objetos de referencia, no los objetos a los que estos apuntan. Una referencia se registra en una cola al crearla. El recolector de basura la añade cuando detecta el cambio adecuado en la alcanzabilidad de su referente. El registro, por sí solo, no mantiene vivo el objeto de referencia: la aplicación debe mantenerlo alcanzable mientras necesite la notificación.
ReferenceQueue.poll() elimina y devuelve una referencia disponible o devuelve null inmediatamente. ReferenceQueue.remove() espera indefinidamente a que haya un elemento. La variante remove(long timeout) espera como máximo el número de milisegundos indicado y puede devolver null; 0 significa espera indefinida, y un valor negativo provoca IllegalArgumentException. Ambas variantes de remove pueden lanzar InterruptedException. El tiempo de espera no ofrece garantías de tiempo real. Estos métodos devuelven Reference<? extends T>.
El ejemplo usa una WeakReference con un referente null y una llamada explícita a enqueue(), por lo que no depende de la recolección de basura. enqueue() siempre limpia la referencia. Si la referencia ya se ha encolado o nunca se registró en una cola, enqueue() devuelve false sin insertarla. De lo contrario, la añade a la cola en la que está registrada y devuelve true. clear() por sí solo no encola la referencia. En el ejemplo, enqueue() devuelve true, por lo que la llamada posterior a remove() no tiene que esperar al GC. Recibir una referencia de la cola no demuestra por sí mismo que se haya liberado la memoria de su referente.
Ejemplos
import java.lang.ref.ReferenceQueue;
import java.lang.ref.WeakReference;
public class ReferenceQueueDemo {
public static void main(String[] args) throws InterruptedException {
ReferenceQueue<Object> queue = new ReferenceQueue<>();
WeakReference<Object> ref = new WeakReference<>(null, queue);
System.out.println(queue.poll() == null);
System.out.println(ref.enqueue());
System.out.println(queue.remove() == ref);
System.out.println(queue.poll() == null);
}
}Resultado
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.