CKTIS / Java
Življenjski cikel šibkih, mehkih in fantomskih referenc v Javi
Spoznaj, kdaj referenca vrne ciljni objekt, kaj se uvrsti v čakalno vrsto in kako `reachabilityFence` ohrani objekt močno dosegljiv.
Različica: Java SE 21
Sintaksa
Java SE 21 · java.lang.ref (module java.base)
new WeakReference<T>(referent)
new WeakReference<T>(referent, queue)
new SoftReference<T>(referent)
new SoftReference<T>(referent, queue)
new PhantomReference<T>(referent, queue)
new ReferenceQueue<T>()
// Registered constructors accept ReferenceQueue<? super T>.
T value = reference.get();
reference.clear();
boolean added = reference.enqueue();
Reference.reachabilityFence(referent);
// For a queue of type ReferenceQueue<T>:
Reference<? extends T> ready = queue.poll();
Reference<? extends T> next = queue.remove(); // throws InterruptedException
Reference<? extends T> timed = queue.remove(timeoutMillis); // long; throws InterruptedExceptionV java.lang.ref (modul java.base) sta referenca in njen ciljni objekt ločena objekta. Ko zbiralnik smeti (GC) ugotovi, da je objekt šibko dosegljiv, torej da ni niti močno niti mehko dosegljiv, vendar ga je mogoče doseči prek šibke reference, počisti njegove reference WeakReference. Glede na potrebe po pomnilniku lahko GC po lastni presoji počisti reference SoftReference na mehko dosegljive objekte. Navidezni stroj zagotavlja, da so vse take mehke reference počiščene, preden sproži OutOfMemoryError; sicer ne določa časa ali vrstnega reda. PhantomReference omogoča obvestila za čiščenje: GC jo počisti, ko zazna fantomsko dosegljivost, njen get() pa vedno vrne null.
Konstruktorji šibkih in mehkih referenc sprejmejo samo ciljni objekt ali ciljni objekt in ReferenceQueue<? super T>. Fantomski konstruktor vedno zahteva argument za vrsto. Če je ta argument null, se referenca ne registrira. Pri šibki ali mehki referenci get() vrne ciljni objekt ali null, če ga ni, na primer po čiščenju. Rezultat preberi enkrat, preveri, da ni null, in uporabi isto lokalno spremenljivko. clear() prekine povezavo, vendar reference sam ne vstavi v vrsto in ne sprosti ciljnega objekta. enqueue() počisti referenco in jo poskusi izrecno vstaviti v vrsto, v kateri je registrirana; ob uspehu vrne true.
Statična metoda Reference.reachabilityFence(obj) ohrani obj močno dosegljiv do konca klica, tudi če ga koda ne uporablja več neposredno. Klic daj v blok finally, za operacijo, pri kateri mora objekt ostati živ, da se izvede tudi ob izjemi. Podaj objekt sam, ne šibke, mehke ali fantomske reference nanj. Metoda ne sproži GC ali finalizacije; pri null nima učinka.
Iz ReferenceQueue<T> odstraniš objekt Reference<? extends T>, ne ciljnega objekta. poll() odstrani in vrne razpoložljivo referenco ali takoj vrne null. remove() čaka brez časovne omejitve. S pozitivno časovno omejitvijo v milisekundah remove(long timeout) ob izteku vrne null, brez jamstva za obnašanje v realnem času. 0 pomeni neomejeno čakanje, negativna vrednost pa sproži IllegalArgumentException. Če je čakanje prekinjeno, obe preobremenitvi remove sprožita InterruptedException.
GC doda registrirane reference v vrsto ob čiščenju ali pozneje; trenutka ni mogoče napovedati. Prazen rezultat poll() ne pomeni, da je ciljni objekt še živ. Ohrani močno referenco na vsak registriran referenčni objekt, dokler potrebuješ obvestilo: sama registracija ga ne ohrani živega. Za pravočasno zapiranje virov se ne zanašaj na obvestila GC.
Primeri
import java.lang.ref.PhantomReference;
import java.lang.ref.Reference;
import java.lang.ref.ReferenceQueue;
import java.lang.ref.SoftReference;
import java.lang.ref.WeakReference;
public class ReferenceLifecycle {
public static void main(String[] args) throws InterruptedException {
Object target = new Object();
ReferenceQueue<Object> queue = new ReferenceQueue<>();
WeakReference<Object> weak = new WeakReference<>(target, queue);
SoftReference<Object> soft = new SoftReference<>(target);
PhantomReference<Object> phantom = new PhantomReference<>(target, queue);
try {
System.out.println("weak.get() == target: " + (weak.get() == target));
System.out.println("soft.get() == target: " + (soft.get() == target));
weak.clear();
soft.clear();
System.out.println("weak.get() == null: " + (weak.get() == null));
System.out.println("soft.get() == null: " + (soft.get() == null));
System.out.println("poll() after clear: " + queue.poll());
if (!weak.enqueue()) {
throw new IllegalStateException("Expected weak reference to be enqueued");
}
System.out.println("remove(1000) == weak: " + (queue.remove(1000) == weak));
System.out.println("phantom.get() == null: " + (phantom.get() == null));
if (!phantom.enqueue()) {
throw new IllegalStateException("Expected phantom reference to be enqueued");
}
System.out.println("remove() == phantom: " + (queue.remove() == phantom));
} finally {
Reference.reachabilityFence(target);
}
}
}Rezultat
weak.get() == target: true soft.get() == target: true weak.get() == null: true soft.get() == null: true poll() after clear: null remove(1000) == weak: true phantom.get() == null: true remove() == phantom: true
Pregrada ohrani `target` močno dosegljiv, `enqueue()` pa pred vsakim `remove` izrecno doda element. Primer pokaže razliko med čiščenjem in uvrščanjem v vrsto, ne pa časa delovanja GC ali izteka časovne omejitve.
Povezane lekcije
- Java · Lekcija 45 · Napredna · Različica: 2