Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

ReferenceQueue — odbieranie obiektów referencji

ReferenceQueue umożliwia odbieranie zarejestrowanych obiektów referencji po dodaniu ich przez garbage collector lub jawne enqueue(). Poznaj różnicę między nieblokującym poll() a blokującymi wariantami remove().

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

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 pakietu java.lang.ref odbiera obiekty referencji, a nie obiekty, na które one wskazują. Referencję rejestruje się w kolejce podczas jej tworzenia. Garbage collector dodaje ją po wykryciu odpowiedniej zmiany osiągalności wskazywanego obiektu. Sama rejestracja nie utrzymuje obiektu referencji przy życiu: aplikacja musi zachować go jako osiągalny, dopóki potrzebuje powiadomienia.

ReferenceQueue.poll() usuwa i zwraca dostępną referencję albo natychmiast zwraca null. ReferenceQueue.remove() czeka bezterminowo na element. Wariant remove(long timeout) czeka do podanej liczby milisekund i może zwrócić null; 0 oznacza oczekiwanie bezterminowe, a wartość ujemna powoduje IllegalArgumentException. Oba warianty remove mogą zgłosić InterruptedException. Limit czasu nie zapewnia gwarancji czasu rzeczywistego. Metody zwracają Reference<? extends T>.

Przykład używa WeakReference z wartością null i jawnego enqueue(), więc nie zależy od działania garbage collectora. enqueue() zawsze czyści referencję. Jeśli referencja została już wcześniej dodana do kolejki lub nigdy nie została w żadnej zarejestrowana, metoda zwraca false i jej nie dodaje. W przeciwnym razie dodaje ją do kolejki, w której została zarejestrowana, i zwraca true. Samo clear() nie dodaje referencji do kolejki. W przykładzie enqueue() zwraca true, więc następujące po nim wywołanie remove() nie wymaga oczekiwania na GC. Otrzymanie referencji z kolejki samo w sobie nie dowodzi odzyskania pamięci wskazywanego obiektu.

Przykłady

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

Wynik

true
true
true
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła