CKTIS / Java
Životní cyklus slabých, měkkých a fantomových referencí v Javě
Zjisti, kdy reference vrací odkazovaný objekt, co se vkládá do fronty a jak `reachabilityFence` udržuje objekt silně dosažitelný.
Verze: Java SE 21
Syntaxe
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) jsou objekt reference a odkazovaný objekt dvě různé věci. Když správce paměti (GC) zjistí, že je objekt slabě dosažitelný, tedy že není dosažitelný ani silně, ani měkce, ale lze se k němu dostat přes slabou referenci, vymaže jeho WeakReference. V reakci na nároky na paměť může GC podle vlastního uvážení vymazat SoftReference k měkce dosažitelným objektům. Virtuální stroj zaručuje vymazání všech takových měkkých referencí před vyvoláním OutOfMemoryError, ale jinak neurčuje čas ani pořadí. PhantomReference slouží k oznámení pro účely úklidu: GC ji vymaže po zjištění fantomové dosažitelnosti a její get() vždy vrací null.
Konstruktory slabé a měkké reference přijímají buď jen odkazovaný objekt, nebo objekt a ReferenceQueue<? super T>. Konstruktor fantomové reference vždy vyžaduje argument fronty. Hodnota null místo fronty znamená, že se reference nezaregistruje. U slabé či měkké reference vrací get() odkazovaný objekt nebo null, pokud chybí, například po vymazání. Načti výsledek jednou, ověř, že není null, a použij tutéž lokální proměnnou. clear() zruší vazbu, ale samo nevloží referenci do fronty ani neuvolní odkazovaný objekt. enqueue() referenci vymaže a výslovně se ji pokusí vložit do fronty, ve které je registrována; při úspěchu vrátí true.
Statická metoda Reference.reachabilityFence(obj) udržuje obj silně dosažitelný do konce volání, i když ho kód už přímo nepoužívá. Volání dej do bloku finally za operaci, která vyžaduje, aby objekt zůstal naživu; provede se i při výjimce. Předej samotný objekt, ne jeho slabou, měkkou ani fantomovou referenci. Metoda nespouští GC ani finalizaci; pro null nemá žádný účinek.
Z ReferenceQueue<T> se odebírá objekt Reference<? extends T>, ne odkazovaný objekt. poll() odebere a vrátí dostupnou referenci nebo okamžitě vrátí null. remove() čeká bez časového limitu. S kladným limitem v milisekundách vrátí remove(long timeout) po jeho uplynutí null, bez záruk reálného času. 0 znamená neomezené čekání, záporná hodnota vyvolá IllegalArgumentException. Obě přetížení remove při přerušení čekání vyvolají InterruptedException.
GC vkládá registrované reference do fronty při vymazání nebo později; přesný okamžik nelze předpovědět. Když poll() nic nenajde, neznamená to, že odkazovaný objekt ještě žije. Udržuj silnou referenci na každý registrovaný objekt reference, dokud potřebuješ oznámení: registrace sama ho neudrží naživu. Při včasném uzavírání prostředků nespoléhej na oznámení GC.
Příklady
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);
}
}
}Výsledek
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
Bariéra udržuje `target` silně dosažitelný a `enqueue()` výslovně vloží položku před každým `remove`. Příklad ukazuje rozdíl mezi vymazáním a vložením do fronty, ne načasování GC ani vypršení časového limitu.
Související lekce
- Java · Lekce 45 · Pokročilá · Verze: 2