Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

ReferenceQueue — přijímání referenčních objektů

ReferenceQueue umožňuje získat registrované referenční objekty poté, co je přidá garbage collector nebo explicitní volání enqueue(). Seznamte se s rozdílem mezi neblokujícím poll() a blokujícími variantami remove().

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

Syntaxe

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> z balíčku java.lang.ref přijímá referenční objekty, nikoli objekty, na které odkazují. Reference se zaregistruje do fronty při svém vytvoření. Garbage collector ji přidá poté, co zjistí odpovídající změnu dosažitelnosti jejího referentu. Samotná registrace neudržuje referenční objekt naživu: aplikace jej musí udržovat dosažitelný, dokud oznámení potřebuje.

ReferenceQueue.poll() odebere a vrátí dostupnou referenci, nebo okamžitě vrátí null. ReferenceQueue.remove() čeká na prvek neomezeně dlouho. Varianta remove(long timeout) čeká nejvýše zadaný počet milisekund a může vrátit null; 0 znamená neomezené čekání a záporná hodnota způsobí IllegalArgumentException. Obě varianty remove mohou vyvolat InterruptedException. Časový limit nezaručuje chování v reálném čase. Tyto metody vracejí Reference<? extends T>.

Příklad používá WeakReference s referentem null a explicitním voláním enqueue(), takže nezávisí na garbage collectoru. enqueue() referenci vždy vyprázdní. Pokud už byla zařazena do fronty nebo nikdy nebyla zaregistrována u žádné fronty, enqueue() vrátí false a referenci nevloží. Jinak ji vloží do fronty, ve které je zaregistrována, a vrátí true. Samotné clear() referenci do fronty nevloží. V příkladu enqueue() vrátí true, takže při následném volání remove() není nutné čekat na GC. Přijetí reference z fronty samo o sobě nedokazuje, že byla uvolněna paměť jejího referentu.

Příklady

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

Výsledek

true
true
true
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje