CKTIS / Java
SoftReference — eine weiche Referenz
SoftReference<T> aus java.lang.ref hält eine weiche Referenz auf ein Objekt. Sobald das Objekt nicht mehr stark erreichbar ist, kann der Garbage Collector diese Referenz als Reaktion auf Speicherbedarf löschen. Beim Lesen mit get() muss null behandelt werden.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
new SoftReference<T>(referent)
new SoftReference<T>(referent, queue)
T value = reference.get();
reference.clear();SoftReference<T> umschließt eine Referenz auf ein Objekt des Typs T. Ein Objekt ist weich erreichbar, wenn es nicht stark erreichbar ist, aber über eine weiche Referenz erreicht werden kann. Für starke Erreichbarkeit muss man keine Referenzobjekte durchlaufen; schwache Erreichbarkeit schließt sowohl starke als auch weiche Erreichbarkeit aus.
Unter Speicherdruck kann der Garbage Collector weiche Referenzen löschen. Zeitpunkt und Reihenfolge des Löschens sind nicht garantiert. Allerdings werden alle weichen Referenzen auf weich erreichbare Objekte gelöscht, bevor ein OutOfMemoryError ausgelöst wird. Der Mechanismus eignet sich für speicherabhängige Caches, garantiert aber weder eine bestimmte Aufbewahrungsdauer noch Schutz vor Speichermangel.
get() gibt eine starke Referenz auf das Objekt oder null zurück. Speichere das Ergebnis einmal in einer lokalen Variablen und prüfe es vor der Verwendung. clear() löscht die Referenz, aber weder das Objekt noch andere Referenzen und fügt den Wrapper auch nicht einer Warteschlange hinzu. Der Konstruktor SoftReference(T referent, ReferenceQueue<? super T> q) ermöglicht die Registrierung bei einer Warteschlange. Wenn du eine Benachrichtigung erwartest, muss der Wrapper selbst erreichbar bleiben.
Das Beispiel ruft ausdrücklich clear() auf, statt seine Ausgabe von der Garbage Collection abhängig zu machen. Reference.reachabilityFence(value) hält value bis zu dieser Stelle stark erreichbar. Daher ist der erste Lesezugriff vorhersehbar, und der gespeicherte snapshot bleibt nach dem Löschen des Wrappers verfügbar.
Beispiele
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);
}
}Ergebnis
cached null cached
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.