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

CKTIS / Java

WeakReference — uma referência fraca a um objeto

WeakReference<T> mantém uma referência fraca que não impede o garbage collector de recuperar um objeto. A leitura com get() pode devolver null; clear() limpa a referência sem destruir o próprio objeto.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

WeakReference<T> ref = new WeakReference<>(referent);
// Alternative: WeakReference<T> ref = new WeakReference<>(referent, queue);
T value = ref.get();
ref.clear();

WeakReference<T> do pacote java.lang.ref não mantém o objeto referenciado vivo como acontece com uma referência forte. Quando o garbage collector determina que um objeto só é fracamente alcançável, limpa as referências fracas correspondentes. Um uso típico são os mapeamentos de canonicalização que não devem manter os objetos vivos.

O construtor WeakReference(referent) não regista uma fila; WeakReference(referent, queue) regista opcionalmente uma ReferenceQueue. As referências limpas pelo GC entram na fila registada no mesmo momento ou mais tarde. Limpar uma referência não significa, por si só, que a memória do objeto tenha sido recuperada.

O método herdado get() devolve o objeto ou null. Lê o resultado uma vez para uma variável local e verifica-o antes de o utilizar: um resultado diferente de null é uma referência forte. clear() limpa a referência, mas não a coloca na fila nem destrói o objeto.

O exemplo chama deliberadamente clear() em vez de esperar pelo GC. Reference.reachabilityFence(value) mantém value fortemente alcançável até esse ponto, tornando a saída determinística.

Exemplos

import java.lang.ref.Reference;
import java.lang.ref.WeakReference;

public class Main {
    public static void main(String[] args) {
        Object value = new Object();
        WeakReference<Object> ref = new WeakReference<>(value);

        System.out.println(ref.get() == value);
        ref.clear();
        System.out.println(ref.get() == null);
        System.out.println(value != null);

        Reference.reachabilityFence(value);
    }
}

Resultado

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