CKTIS / Java
SoftReference — une référence souple
SoftReference<T> de java.lang.ref conserve une référence souple vers un objet. Lorsque l’objet n’est plus fortement accessible, le ramasse-miettes peut effacer cette référence en réponse à un besoin de mémoire. La lecture avec get() nécessite de traiter le cas null.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
new SoftReference<T>(referent)
new SoftReference<T>(referent, queue)
T value = reference.get();
reference.clear();SoftReference<T> encapsule une référence vers un objet de type T. Un objet est accessible souplement s’il n’est pas fortement accessible, mais peut être atteint par une référence souple. L’accessibilité forte ne nécessite pas de traverser des objets de référence ; l’accessibilité faible exclut à la fois l’accessibilité forte et l’accessibilité souple.
Le ramasse-miettes peut effacer les références souples en cas de pression mémoire. Le moment et l’ordre de cet effacement ne sont pas garantis, mais toutes les références souples vers des objets accessibles souplement seront effacées avant qu’une OutOfMemoryError ne soit lancée. Ce mécanisme convient aux caches sensibles à la mémoire ; il ne garantit ni une durée de conservation ni une protection contre l’épuisement de la mémoire.
get() renvoie une référence forte vers l’objet ou null. Enregistre le résultat une seule fois dans une variable locale et vérifie-le avant de l’utiliser. clear() efface la référence, mais ne supprime ni l’objet ni les autres références et n’ajoute pas l’enveloppe à une file d’attente. Le constructeur SoftReference(T referent, ReferenceQueue<? super T> q) permet d’enregistrer une file d’attente ; garde l’enveloppe elle-même accessible si tu attends une notification.
L’exemple appelle explicitement clear() au lieu de faire dépendre son résultat du ramasse-miettes. Reference.reachabilityFence(value) maintient value fortement accessible jusqu’à cet endroit. Ainsi, la première lecture est prévisible et le snapshot enregistré reste disponible après l’effacement de l’enveloppe.
Exemples
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);
}
}Résultat
cached null cached
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.