Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje