База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници