Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

ReferenceQueue — preuzimanje objekata referenci

ReferenceQueue omogućuje preuzimanje registriranih objekata referenci nakon što ih u red doda sakupljač smeća ili izričit poziv metode enqueue(). Saznajte po čemu se neblokirajuća metoda poll() razlikuje od blokirajućih inačica metode remove().

Verzija: 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 prima objekte referenci, a ne objekte na koje te reference upućuju. Referenca se pri stvaranju registrira u redu čekanja. Sakupljač smeća dodaje je u red kad utvrdi odgovarajuću promjenu dosegljivosti objekta na koji ona upućuje. Sama registracija ne održava objekt reference na životu: aplikacija mora osigurati da taj objekt ostane dosegljiv dok joj je potrebna obavijest.

ReferenceQueue.poll() uklanja i vraća dostupnu referencu ili odmah vraća null. ReferenceQueue.remove() čeka na element bez vremenskog ograničenja. Inačica remove(long timeout) čeka najviše navedeni broj milisekundi i može vratiti null; 0 znači čekanje bez vremenskog ograničenja, a negativna vrijednost uzrokuje iznimku IllegalArgumentException. Obje inačice metode remove mogu baciti iznimku InterruptedException. Vremensko ograničenje ne daje jamstva rada u stvarnom vremenu. Te metode vraćaju Reference<? extends T>.

Primjer koristi WeakReference s referentom null i izričit poziv metode enqueue(), pa ne ovisi o sakupljanju smeća. enqueue() uvijek čisti referencu. Ako je referenca već bila dodana u red čekanja ili nikada nije bila registrirana ni u jednom redu čekanja, enqueue() vraća false i ne dodaje je u red. U suprotnom je dodaje u red u kojem je registrirana i vraća true. Sam poziv metode clear() ne dodaje referencu u red. U primjeru enqueue() vraća true, pa sljedeći poziv metode remove() ne mora čekati na sakupljač smeća. Preuzimanje reference iz reda samo po sebi ne dokazuje da je oslobođena memorija objekta na koji je referenca upućivala.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori