Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

ReferenceQueue — ricevere oggetti di riferimento

ReferenceQueue consente di recuperare gli oggetti di riferimento registrati dopo che il garbage collector o una chiamata esplicita a enqueue() li ha aggiunti. Scopri la differenza tra poll(), non bloccante, e le varianti bloccanti di remove().

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

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 pacchetto java.lang.ref riceve oggetti di riferimento, non gli oggetti a cui puntano. Un riferimento viene registrato in una coda quando viene creato. Il garbage collector lo aggiunge dopo aver rilevato il cambiamento appropriato nella raggiungibilità del suo referente. La sola registrazione non mantiene in vita l’oggetto di riferimento: l’applicazione deve mantenerlo raggiungibile finché la notifica è necessaria.

ReferenceQueue.poll() rimuove e restituisce un riferimento disponibile oppure restituisce subito null. ReferenceQueue.remove() attende indefinitamente un elemento. La variante remove(long timeout) attende al massimo il numero di millisecondi specificato e può restituire null; 0 indica un’attesa indefinita, mentre un valore negativo causa IllegalArgumentException. Entrambe le varianti di remove possono generare InterruptedException. Il timeout non offre garanzie di tempo reale. Questi metodi restituiscono Reference<? extends T>.

L’esempio usa una WeakReference con un referente null e una chiamata esplicita a enqueue(), quindi non dipende dal garbage collector. enqueue() svuota sempre il riferimento. Se il riferimento è già stato accodato o non è mai stato registrato in una coda, enqueue() restituisce false senza inserirlo. Altrimenti lo aggiunge alla coda in cui è registrato e restituisce true. clear() da solo non accoda il riferimento. Nell’esempio, enqueue() restituisce true, quindi la chiamata successiva a remove() non deve attendere il GC. Ricevere un riferimento dalla coda non dimostra, da solo, che la memoria del suo referente sia stata recuperata.

Esempi

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

Risultato

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.

Fonti