CKTIS / Java
SoftReference — meka referenca
SoftReference<T> iz java.lang.ref drži meku referencu na objekt. Kada objekt više nije snažno dohvatljiv, sakupljač smeća može očistiti tu referencu zbog potrebe za memorijom. Pri čitanju pomoću get() treba obraditi vrijednost null.
Verzija: 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> omata referencu na objekt tipa T. Objekt je meko dohvatljiv ako nije snažno dohvatljiv, ali se do njega može doći preko meke reference. Za snažnu dohvatljivost nije potrebno prolaziti kroz objekte referenci; slaba dohvatljivost isključuje i snažnu i meku dohvatljivost.
Sakupljač smeća može očistiti meke reference pod pritiskom memorije. Vrijeme ni redoslijed čišćenja nisu zajamčeni, ali sve meke reference na meko dohvatljive objekte bit će očišćene prije nego što se baci OutOfMemoryError. Taj mehanizam podržava predmemorije koje ovise o dostupnoj memoriji, ali ne jamči trajanje zadržavanja ni zaštitu od ponestanka memorije.
get() vraća snažnu referencu na objekt ili null. Jednom spremi rezultat u lokalnu varijablu i provjeri ga prije upotrebe. clear() čisti referencu, ali ne briše objekt ni druge reference i ne stavlja omot u red čekanja. Konstruktor SoftReference(T referent, ReferenceQueue<? super T> q) omogućuje registraciju reda čekanja; ako očekuješ obavijest, održi sam omot dohvatljivim.
Primjer izričito poziva clear(), umjesto da ispis ovisi o sakupljaču smeća. Reference.reachabilityFence(value) održava value snažno dohvatljivim do te točke. Zato je prvo čitanje predvidljivo, a spremljeni snapshot ostaje dostupan nakon čišćenja omota.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.