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.