Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

ReferenceQueue — prejemanje referenčnih objektov

ReferenceQueue omogoča pridobivanje registriranih referenčnih objektov, potem ko jih doda garbage collector ali izrecni klic enqueue(). Spoznajte razliko med neblokirajočim poll() in blokirajočimi različicami remove().

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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> iz paketa java.lang.ref prejema referenčne objekte, ne pa objektov, na katere kažejo. Referenca se ob ustvarjanju registrira v čakalni vrsti. Garbage collector jo doda, ko zazna ustrezno spremembo dosegljivosti njenega referenta. Sama registracija referenčnega objekta ne ohrani pri življenju: aplikacija ga mora ohranjati dosegljivega, dokler potrebuje obvestilo.

ReferenceQueue.poll() odstrani in vrne razpoložljivo referenco ali pa takoj vrne null. ReferenceQueue.remove() neomejeno čaka na element. Različica remove(long timeout) čaka največ navedeno število milisekund in lahko vrne null; 0 pomeni neomejeno čakanje, negativna vrednost pa povzroči IllegalArgumentException. Obe različici remove lahko sprožita InterruptedException. Časovna omejitev ne zagotavlja delovanja v realnem času. Te metode vrnejo Reference<? extends T>.

Primer uporablja WeakReference z referentom null in izrecnim klicem enqueue(), zato ni odvisen od garbage collectorja. enqueue() vedno počisti referenco. Če je bila referenca že dodana v čakalno vrsto ali ni bila nikoli registrirana v nobeni čakalni vrsti, enqueue() vrne false, ne da bi jo dodal. Sicer jo doda v vrsto, v kateri je registrirana, in vrne true. Sam klic clear() reference ne doda v čakalno vrsto. V primeru enqueue() vrne true, zato pri naslednjem klicu remove() ni treba čakati na GC. Prejem reference iz čakalne vrste sam po sebi ne dokazuje, da je bil pomnilnik njenega referenta sproščen.

Primeri

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

Rezultat

true
true
true
true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri