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.