CKTIS / Java
SoftReference — una referencia suave
SoftReference<T> de java.lang.ref mantiene una referencia suave a un objeto. Cuando el objeto deja de ser fuertemente alcanzable, el recolector de basura puede borrar esa referencia si necesita memoria. Al leerla con get(), hay que gestionar el valor null.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
new SoftReference<T>(referent)
new SoftReference<T>(referent, queue)
T value = reference.get();
reference.clear();SoftReference<T> envuelve una referencia a un objeto de tipo T. Un objeto es suavemente alcanzable si no es fuertemente alcanzable, pero se puede llegar a él mediante una referencia suave. La alcanzabilidad fuerte no requiere atravesar objetos de referencia; la alcanzabilidad débil excluye tanto la fuerte como la suave.
El recolector de basura puede borrar referencias suaves cuando hay presión de memoria. No se garantiza ni el momento ni el orden del borrado, aunque todas las referencias suaves a objetos suavemente alcanzables se borrarán antes de que se lance una OutOfMemoryError. Este mecanismo sirve para cachés sensibles a la memoria, pero no garantiza un tiempo de retención ni protege frente al agotamiento de memoria.
get() devuelve una referencia fuerte al objeto o null. Guarda el resultado una sola vez en una variable local y compruébalo antes de usarlo. clear() borra la referencia, pero no elimina el objeto ni otras referencias, y tampoco añade el envoltorio a una cola. El constructor SoftReference(T referent, ReferenceQueue<? super T> q) permite registrar una cola; mantén alcanzable el propio envoltorio si esperas una notificación.
El ejemplo llama explícitamente a clear() en vez de hacer que el resultado dependa del recolector de basura. Reference.reachabilityFence(value) mantiene value fuertemente alcanzable hasta ese punto. Por eso, la primera lectura es predecible y el snapshot guardado sigue disponible después de borrar el envoltorio.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.