Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes