CKTIS / Java
SoftReference — un riferimento soft
SoftReference<T> di java.lang.ref mantiene un riferimento soft a un oggetto. Quando l’oggetto non è più fortemente raggiungibile, il garbage collector può cancellare il riferimento in risposta alla richiesta di memoria. Per leggere con get() occorre gestire null.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
new SoftReference<T>(referent)
new SoftReference<T>(referent, queue)
T value = reference.get();
reference.clear();SoftReference<T> racchiude un riferimento a un oggetto di tipo T. Un oggetto è raggiungibile soft se non è fortemente raggiungibile, ma è possibile raggiungerlo tramite un riferimento soft. La raggiungibilità forte non richiede di attraversare oggetti riferimento; quella debole esclude sia la raggiungibilità forte sia quella soft.
Il garbage collector può cancellare i riferimenti soft sotto pressione di memoria. Non sono garantiti né il momento né l’ordine della cancellazione, anche se tutti i riferimenti soft agli oggetti raggiungibili soft verranno cancellati prima che venga generata una OutOfMemoryError. Questo meccanismo supporta cache sensibili alla memoria, ma non garantisce tempi di conservazione né protegge dall’esaurimento della memoria.
get() restituisce un riferimento forte all’oggetto oppure null. Salva il risultato una sola volta in una variabile locale e controllalo prima di usarlo. clear() cancella il riferimento, ma non elimina l’oggetto né gli altri riferimenti e non inserisce l’involucro in una coda. Il costruttore SoftReference(T referent, ReferenceQueue<? super T> q) consente di registrare una coda; se ti aspetti una notifica, mantieni raggiungibile l’involucro stesso.
L’esempio chiama esplicitamente clear() invece di far dipendere l’output dal garbage collector. Reference.reachabilityFence(value) mantiene value fortemente raggiungibile fino a quel punto. Di conseguenza, la prima lettura è prevedibile e lo snapshot salvato resta disponibile dopo la cancellazione dell’involucro.
Esempi
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);
}
}Risultato
cached null cached
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.