CKTIS / Java
Levenscyclus van zwakke, zachte en fantoomreferenties in Java
Leer wanneer een referentie haar doelobject teruggeeft, wat er in de wachtrij terechtkomt en hoe `reachabilityFence` een object sterk bereikbaar houdt.
Versie: Java SE 21
Syntax
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 InterruptedExceptionIn java.lang.ref (module java.base) zijn de referentie en het doelobject twee verschillende objecten. Zodra de garbagecollector (GC) vaststelt dat een object zwak bereikbaar is (niet sterk of zacht bereikbaar, maar wel via een zwakke referentie), wist hij de bijbehorende WeakReference-objecten. Bij behoefte aan geheugen kan de GC naar eigen inzicht SoftReference-objecten naar zacht bereikbare objecten wissen. De VM garandeert dat al zulke zachte referenties zijn gewist voordat ze OutOfMemoryError werpt, maar legt verder geen tijdstip of volgorde vast. PhantomReference dient voor opruimmeldingen: de GC wist die zodra hij fantoombereikbaarheid vaststelt, en get() geeft altijd null terug.
De constructors voor zwakke en zachte referenties accepteren alleen het doelobject of het doelobject met een ReferenceQueue<? super T>. De fantoomconstructor vereist altijd een wachtrijargument. Geef je daar null door, dan wordt de referentie niet geregistreerd. Bij zwakke en zachte referenties geeft get() het doelobject terug of null als het ontbreekt, bijvoorbeeld na het wissen. Lees het resultaat één keer, controleer op null en gebruik dezelfde lokale variabele. clear() verbreekt de koppeling, maar plaatst de referentie niet zelf in de wachtrij en geeft het doelobject niet vrij. enqueue() wist de referentie en probeert die expliciet in de geregistreerde wachtrij te plaatsen; bij succes geeft de methode true terug.
De statische methode Reference.reachabilityFence(obj) houdt obj tot het einde van de aanroep sterk bereikbaar, ook als de code het niet meer rechtstreeks gebruikt. Zet de aanroep in een finally-blok na de bewerking waarvoor het object in leven moet blijven, zodat hij ook bij een uitzondering wordt uitgevoerd. Geef het object zelf door, niet de zwakke, zachte of fantoomreferentie eromheen. De methode start geen GC of finalisatie; met null heeft ze geen effect.
Uit een ReferenceQueue<T> haal je een Reference<? extends T>, niet het doelobject. poll() verwijdert een beschikbare referentie en geeft die terug, of geeft direct null terug. remove() wacht zonder tijdslimiet. Met een positieve wachttijd in milliseconden geeft remove(long timeout) bij het verstrijken daarvan null terug, zonder realtimegarantie. 0 betekent onbeperkt wachten; een negatieve waarde leidt tot IllegalArgumentException. Beide overloads van remove werpen InterruptedException als het wachten wordt onderbroken.
De GC zet geregistreerde referenties bij het wissen of later in de wachtrij; het tijdstip is niet voorspelbaar. Een lege poll() betekent niet dat het doelobject nog leeft. Houd elk geregistreerd referentieobject sterk bereikbaar zolang je de melding nodig hebt: registratie alleen houdt het niet in leven. Vertrouw niet op GC-meldingen om resources op tijd af te sluiten.
Voorbeelden
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);
}
}
}Resultaat
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
De barrière houdt `target` sterk bereikbaar en `enqueue()` voegt vóór elke `remove` expliciet een item toe. Het voorbeeld laat het verschil zien tussen wissen en in de wachtrij plaatsen, niet wanneer de GC ingrijpt of de wachttijd verstrijkt.
Gerelateerde lessen
- Java · Les 45 · Gevorderd · Versie: 2