WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

ReferenceQueue – Referenzobjekte empfangen

Mit ReferenceQueue lassen sich registrierte Referenzobjekte abrufen, nachdem der Garbage Collector oder ein expliziter Aufruf von enqueue() sie hinzugefügt hat. Erfahre den Unterschied zwischen dem nicht blockierenden poll() und den blockierenden Varianten von remove().

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

Syntax

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> aus java.lang.ref empfängt Referenzobjekte, nicht die Objekte, auf die sie verweisen. Eine Referenz wird beim Erstellen bei einer Queue registriert. Der Garbage Collector fügt sie hinzu, nachdem er eine entsprechende Änderung der Erreichbarkeit des Objekts erkannt hat, auf das die Referenz verweist. Allein die Registrierung hält das Referenzobjekt nicht am Leben: Die Anwendung muss es erreichbar halten, solange die Benachrichtigung benötigt wird.

ReferenceQueue.poll() entfernt eine verfügbare Referenz und gibt sie zurück oder gibt sofort null zurück. ReferenceQueue.remove() wartet unbegrenzt auf ein Element. Die Variante remove(long timeout) wartet höchstens die angegebene Anzahl von Millisekunden und kann null zurückgeben; 0 bedeutet unbegrenztes Warten, ein negativer Wert löst IllegalArgumentException aus. Beide remove-Varianten können InterruptedException auslösen. Das Timeout bietet keine Echtzeitgarantien. Diese Methoden geben Reference<? extends T> zurück.

Das Beispiel verwendet eine WeakReference, die auf null verweist, und ruft enqueue() explizit auf. Es ist daher nicht von der Garbage Collection abhängig. enqueue() leert die Referenz immer. Wurde sie bereits eingereiht oder nie bei einer Queue registriert, gibt enqueue() false zurück, ohne sie einzureihen. Andernfalls fügt die Methode die Referenz der Queue hinzu, bei der sie registriert wurde, und gibt true zurück. clear() allein reiht die Referenz nicht ein. Im Beispiel gibt enqueue() true zurück, sodass der anschließende Aufruf von remove() nicht auf den GC warten muss. Eine aus der Queue entnommene Referenz beweist für sich allein nicht, dass der Speicher des Objekts, auf das sie verwies, freigegeben wurde.

Beispiele

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

Ergebnis

true
true
true
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen