CKTIS / Java
SoftReference — мека препратка
SoftReference<T> от java.lang.ref пази мека препратка към обект. Когато обектът вече не е силно достижим, garbage collector може да изчисти препратката при нужда от памет. При четене с get() трябва да се обработи null.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
new SoftReference<T>(referent)
new SoftReference<T>(referent, queue)
T value = reference.get();
reference.clear();SoftReference<T> обвива препратка към обект от тип T. Обектът е меко достижим, ако не е силно достижим, но до него може да се стигне чрез мека препратка. Силната достижимост не изисква преминаване през обекти на препратки; слабата достижимост изключва както силната, така и меката достижимост.
При недостиг на памет garbage collector може да изчисти меките препратки. Не са гарантирани нито моментът, нито редът на изчистване, но всички меки препратки към меко достижими обекти ще бъдат изчистени, преди да бъде хвърлен OutOfMemoryError. Механизмът позволява кешове, съобразени с наличната памет, но не гарантира период на задържане или защита от изчерпване на паметта.
get() връща силна препратка към обекта или null. Запази резултата веднъж в локална променлива и го провери преди употреба. clear() изчиства препратката, но не изтрива обекта или други препратки и не добавя обвивката към опашка. Конструкторът SoftReference(T referent, ReferenceQueue<? super T> q) позволява регистриране на опашка; ако очакваш известие, поддържай самата обвивка достижима.
Примерът изрично извиква clear(), вместо да прави изхода зависим от garbage collector. Reference.reachabilityFence(value) поддържа value силно достижим до тази точка. Затова първото прочитане е предвидимо, а запазеният snapshot остава достъпен след изчистването на обвивката.
Примери
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);
}
}Резултат
cached null cached
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.