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.