CKTIS / Java
PhantomReference — referências fantasma
PhantomReference<T> permite receber notificações sobre alterações na acessibilidade de um objeto sem o expor através de get(). Funciona com uma ReferenceQueue; o exemplo mostra o enfileiramento manual e determinístico.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
PhantomReference<T> ref = new PhantomReference<>(referent, queue);PhantomReference<T>, de java.lang.ref, permite preparar a limpeza após o ciclo de vida de um objeto. Ao contrário de WeakReference e SoftReference, não permite obter o objeto referenciado através de get() — este método devolve sempre null. O construtor recebe um objeto referenciado e uma ReferenceQueue<? super T>; uma fila null significa que não haverá notificações através de uma fila.
Quando o GC deteta acessibilidade fantasma, limpa atomicamente o grupo correspondente de referências fantasma e coloca as referências registadas nas respetivas filas, de imediato ou mais tarde. O programa tem de manter a própria PhantomReference acessível; o registo numa fila não o garante. Guarda separadamente os dados necessários à limpeza, sem uma referência forte ao objeto monitorizado.
refersTo(obj) verifica a identidade do objeto referenciado, enquanto refersTo(null) deteta se a referência foi limpa. Chamar apenas clear() não coloca a referência na fila. Por outro lado, enqueue() limpa-a e adiciona-a à sua fila, se possível; uma chamada manual não prova que o GC recuperou memória.
O exemplo usa deliberadamente enqueue() em vez de esperar pelo GC. Reference.reachabilityFence(referent) mantém o objeto referenciado fortemente acessível durante toda a demonstração, evitando uma condição de corrida com o GC. poll() obtém o próprio objeto de referência, não o objeto referenciado. O código demonstra o funcionamento da fila, não uma implementação de limpeza de recursos.
Exemplos
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);
}
}Resultado
true true true true true true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.