CKTIS / Java
ReferenceQueue — получаване на обекти за препратки
ReferenceQueue позволява да извличате регистрирани обекти за препратки, след като garbage collector или изрично извикване на enqueue() ги добави. Научете разликата между неблокиращия poll() и блокиращите варианти на remove().
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
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> от пакета java.lang.ref получава обекти за препратки, а не обектите, към които те сочат. Препратката се регистрира в опашка при създаването си. Garbage collector я добавя, след като установи съответната промяна в достижимостта на референта ѝ. Самата регистрация не поддържа обекта за препратка жив: приложението трябва да го поддържа достижим, докато известието е необходимо.
ReferenceQueue.poll() премахва и връща налична препратка или незабавно връща null. ReferenceQueue.remove() чака неограничено за елемент. Вариантът remove(long timeout) чака до посочения брой милисекунди и може да върне null; 0 означава неограничено чакане, а отрицателна стойност причинява IllegalArgumentException. И двата варианта на remove могат да хвърлят InterruptedException. Времевото ограничение не осигурява гаранции за работа в реално време. Тези методи връщат Reference<? extends T>.
Примерът използва WeakReference с референт null и изрично извикване на enqueue(), затова не зависи от garbage collector. enqueue() винаги изчиства препратката. Ако препратката вече е била добавена в опашката или никога не е била регистрирана в опашка, enqueue() връща false, без да я добавя. В противен случай методът я добавя в опашката, в която е регистрирана, и връща true. Само извикването на clear() не добавя препратката в опашката. В примера enqueue() връща true, затова при последващото извикване на remove() не се налага да се чака GC. Получаването на препратка от опашката само по себе си не доказва, че паметта на референта ѝ е освободена.
Примери
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);
}
}Резултат
true true true true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.