KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

ReferenceQueue — referentieobjecten ontvangen

Met ReferenceQueue kun je geregistreerde referentieobjecten ophalen nadat de garbagecollector of een expliciete aanroep van enqueue() ze heeft toegevoegd. Leer het verschil tussen de niet-blokkerende poll() en de blokkerende varianten van remove().

Versie: 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> uit het pakket java.lang.ref ontvangt referentieobjecten, niet de objecten waarnaar ze verwijzen. Een referentie wordt bij het aanmaken aan een wachtrij gekoppeld. De garbagecollector voegt deze toe nadat die de passende verandering in de bereikbaarheid van het gerefereerde object heeft vastgesteld. Alleen registreren houdt het referentieobject niet in leven: de toepassing moet het bereikbaar houden zolang de melding nodig is.

ReferenceQueue.poll() verwijdert en retourneert een beschikbare referentie, of retourneert onmiddellijk null. ReferenceQueue.remove() wacht onbeperkt op een element. De variant remove(long timeout) wacht maximaal het opgegeven aantal milliseconden en kan null retourneren; 0 betekent onbeperkt wachten en een negatieve waarde veroorzaakt IllegalArgumentException. Beide varianten van remove kunnen InterruptedException veroorzaken. De time-out biedt geen real-timegaranties. Deze methoden retourneren Reference<? extends T>.

Het voorbeeld gebruikt een WeakReference met een null-referent en een expliciete aanroep van enqueue(), en is daarom niet afhankelijk van garbage collection. enqueue() wist de referentie altijd. Als de referentie al eerder in de wachtrij is geplaatst of nooit aan een wachtrij is gekoppeld, retourneert enqueue() false zonder de referentie toe te voegen. Anders voegt de methode de referentie toe aan de wachtrij waaraan deze is gekoppeld en retourneert true. clear() alleen plaatst de referentie niet in de wachtrij. In het voorbeeld retourneert enqueue() true, zodat de daaropvolgende aanroep van remove() niet op de GC hoeft te wachten. Een referentie uit de wachtrij ontvangen bewijst op zichzelf niet dat het geheugen van het gerefereerde object is vrijgegeven.

Voorbeelden

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

Resultaat

true
true
true
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen