CKTIS / Java
ReferenceQueue — prijímanie referenčných objektov
ReferenceQueue umožňuje získať zaregistrované referenčné objekty po tom, ako ich pridá garbage collector alebo explicitné volanie enqueue(). Zistite, aký je rozdiel medzi neblokujúcim poll() a blokujúcimi variantmi remove().
Verzia: 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> z balíka java.lang.ref prijíma referenčné objekty, nie objekty, na ktoré odkazujú. Referencia sa zaregistruje do frontu pri svojom vytvorení. Garbage collector ju pridá po zistení príslušnej zmeny dosiahnuteľnosti jej referenta. Samotná registrácia neudržiava referenčný objekt nažive: aplikácia ho musí udržiavať dosiahnuteľný, kým potrebuje oznámenie.
ReferenceQueue.poll() odstráni a vráti dostupnú referenciu alebo okamžite vráti null. ReferenceQueue.remove() čaká na prvok neobmedzene dlho. Variant remove(long timeout) čaká najviac určený počet milisekúnd a môže vrátiť null; 0 znamená neobmedzené čakanie a záporná hodnota spôsobí IllegalArgumentException. Oba varianty remove môžu vyvolať InterruptedException. Časový limit neposkytuje záruky správania v reálnom čase. Tieto metódy vracajú Reference<? extends T>.
Príklad používa WeakReference s referentom null a explicitným volaním enqueue(), takže nezávisí od garbage collectora. enqueue() referenciu vždy vyčistí. Ak už bola zaradená do frontu alebo nikdy nebola zaregistrovaná v žiadnom fronte, enqueue() vráti false a referenciu nevloží. Inak ju vloží do frontu, v ktorom je zaregistrovaná, a vráti true. Samotné clear() referenciu do frontu nevloží. V príklade enqueue() vráti true, takže pri následnom volaní remove() netreba čakať na GC. Prijatie referencie z frontu samo osebe nedokazuje, že bola uvoľnená pamäť jej referenta.
Prí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ýsledok
true true true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.