CKTIS / Java
SoftReference — uma referência soft
SoftReference<T> de java.lang.ref mantém uma referência soft a um objeto. Quando o objeto deixa de estar fortemente alcançável, o garbage collector pode limpar essa referência em resposta à necessidade de memória. A leitura com get() exige o tratamento de null.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
new SoftReference<T>(referent)
new SoftReference<T>(referent, queue)
T value = reference.get();
reference.clear();SoftReference<T> envolve uma referência a um objeto do tipo T. Um objeto está suavemente alcançável se não estiver fortemente alcançável, mas puder ser alcançado através de uma referência soft. A alcançabilidade forte não exige percorrer objetos de referência; a alcançabilidade fraca exclui tanto a alcançabilidade forte como a suave.
O garbage collector pode limpar referências soft sob pressão de memória. Não há garantia quanto ao momento ou à ordem da limpeza, embora todas as referências soft a objetos suavemente alcançáveis sejam limpas antes de ser lançada uma OutOfMemoryError. Este mecanismo permite criar caches sensíveis à memória, mas não garante períodos de retenção nem protege contra o esgotamento da memória.
get() devolve uma referência forte ao objeto ou null. Guarda o resultado uma vez numa variável local e verifica-o antes de o usar. clear() limpa a referência, mas não elimina o objeto nem outras referências, e não coloca o invólucro numa fila. O construtor SoftReference(T referent, ReferenceQueue<? super T> q) permite registar uma fila; mantém o próprio invólucro alcançável se esperares uma notificação.
O exemplo chama explicitamente clear(), em vez de fazer depender a saída do garbage collector. Reference.reachabilityFence(value) mantém value fortemente alcançável até esse ponto. Assim, a primeira leitura é previsível e o snapshot guardado continua disponível depois de o invólucro ser limpo.
Exemplos
import java.lang.ref.Reference;
import java.lang.ref.SoftReference;
public class SoftReferenceDemo {
public static void main(String[] args) {
String value = new String("cached");
SoftReference<String> reference = new SoftReference<>(value);
String snapshot = reference.get();
System.out.println(snapshot);
reference.clear();
System.out.println(reference.get());
System.out.println(snapshot);
Reference.reachabilityFence(value);
}
}Resultado
cached null cached
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.