CKTIS / Java
SoftReference — mehka referenca
SoftReference<T> iz java.lang.ref hrani mehko referenco na objekt. Ko objekt ni več močno dosegljiv, lahko zbiralnik smeti to referenco zaradi potrebe po pomnilniku počisti. Pri branju z get() je treba obravnavati vrednost null.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
new SoftReference<T>(referent)
new SoftReference<T>(referent, queue)
T value = reference.get();
reference.clear();SoftReference<T> ovije referenco na objekt tipa T. Objekt je mehko dosegljiv, če ni močno dosegljiv, vendar je do njega mogoče priti prek mehke reference. Močna dosegljivost ne zahteva prehajanja skozi referenčne objekte; šibka dosegljivost izključuje tako močno kot mehko dosegljivost.
Zbiralnik smeti lahko ob pomanjkanju pomnilnika počisti mehke reference. Čas in vrstni red čiščenja nista zagotovljena, vendar bodo vse mehke reference na mehko dosegljive objekte očiščene, preden bo vržena izjema OutOfMemoryError. Mehanizem podpira predpomnilnike, ki upoštevajo razpoložljivi pomnilnik, ne zagotavlja pa časa hrambe ali zaščite pred izčrpanjem pomnilnika.
get() vrne močno referenco na objekt ali null. Rezultat enkrat shrani v lokalno spremenljivko in ga pred uporabo preveri. clear() počisti referenco, ne izbriše pa objekta ali drugih referenc in ovoja ne doda v čakalno vrsto. Konstruktor SoftReference(T referent, ReferenceQueue<? super T> q) omogoča registracijo čakalne vrste; če pričakuješ obvestilo, poskrbi, da bo sam ovoj dosegljiv.
Primer izrecno pokliče clear(), zato njegov izpis ni odvisen od zbiralnika smeti. Reference.reachabilityFence(value) ohranja value močno dosegljiv do te točke. Zato je prvo branje predvidljivo, shranjeni snapshot pa ostane na voljo tudi po čiščenju ovoja.
Primeri
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);
}
}Rezultat
cached null cached
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.