CKTIS / Java
PhantomReference — фантомни препратки
PhantomReference<T> позволява получаване на известия за промени в достижимостта на обект, без той да се предоставя чрез get(). Работи с ReferenceQueue; примерът показва детерминистично ръчно добавяне на препратка в опашка.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
PhantomReference<T> ref = new PhantomReference<>(referent, queue);PhantomReference<T> от java.lang.ref позволява да се подготви почистване след жизнения цикъл на обект. За разлика от WeakReference и SoftReference, тя не предоставя реферирания обект чрез get() — този метод винаги връща null. Конструкторът приема рефериран обект и ReferenceQueue<? super T>; опашка null означава, че няма да има известия чрез опашка.
Когато GC установи фантомна достижимост, той атомарно изчиства съответната група фантомни препратки и поставя регистрираните препратки в техните опашки веднага или по-късно. Програмата трябва да поддържа достижима самата PhantomReference; регистрацията в опашка не осигурява това. Съхранявайте данните, нужни за почистването, отделно и без силна препратка към наблюдавания обект.
refersTo(obj) проверява идентичността на реферирания обект, а refersTo(null) установява дали препратката е изчистена. Самостоятелното извикване на clear() не поставя препратката в опашката. За разлика от него enqueue() я изчиства и, ако е възможно, я добавя в опашката; ръчното извикване не доказва, че GC е освободил памет.
Примерът умишлено използва enqueue(), вместо да чака GC. Reference.reachabilityFence(referent) поддържа реферирания обект силно достижим през цялата демонстрация и така предотвратява състезание с GC. poll() извлича обекта на препратката, а не реферирания обект. Кодът показва механиката на опашката, а не реализация за почистване на ресурси.
Примери
import java.lang.ref.PhantomReference;
import java.lang.ref.Reference;
import java.lang.ref.ReferenceQueue;
public class Main {
public static void main(String[] args) {
Object referent = new Object();
ReferenceQueue<Object> queue = new ReferenceQueue<>();
PhantomReference<Object> ref = new PhantomReference<>(referent, queue);
System.out.println(ref.get() == null);
System.out.println(ref.refersTo(referent));
System.out.println(ref.enqueue());
System.out.println(ref.refersTo(null));
System.out.println(queue.poll() == ref);
System.out.println(queue.poll() == null);
Reference.reachabilityFence(referent);
}
}Резултат
true true true true true true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.