WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Lebenszyklus schwacher, weicher und Phantomreferenzen in Java

Lerne, wann eine Referenz ihr Zielobjekt liefert, was in der Warteschlange landet und wie `reachabilityFence` ein Objekt stark erreichbar hält.

Version: 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 InterruptedException

In java.lang.ref (Modul java.base) sind Referenzobjekt und Zielobjekt zwei verschiedene Objekte. Erkennt der Garbage Collector (GC) ein schwach erreichbares Objekt, das weder stark noch weich erreichbar ist, aber über eine schwache Referenz erreicht werden kann, leert er dessen WeakReference-Objekte. Bei Speicherbedarf kann der GC SoftReference-Objekte zu weich erreichbaren Objekten nach eigenem Ermessen leeren. Die VM garantiert, dass alle solchen weichen Referenzen geleert sind, bevor sie einen OutOfMemoryError auslöst; sonst sind weder Zeitpunkt noch Reihenfolge festgelegt. PhantomReference dient Benachrichtigungen für Aufräumarbeiten: Der GC leert sie, wenn er Phantom-Erreichbarkeit feststellt, und get() liefert immer null.

Die Konstruktoren schwacher und weicher Referenzen nehmen entweder nur das Zielobjekt oder zusätzlich eine ReferenceQueue<? super T> entgegen. Der Phantomkonstruktor verlangt immer ein Warteschlangenargument; null bedeutet keine Registrierung. Bei schwachen und weichen Referenzen liefert get() das Zielobjekt oder null, wenn keines vorhanden ist, etwa nach dem Leeren. Lies das Ergebnis einmal, prüfe es auf null und verwende dieselbe lokale Variable. clear() trennt die Verbindung, reiht die Referenz aber nicht selbst ein und gibt das Zielobjekt nicht frei. enqueue() leert die Referenz und versucht, sie ausdrücklich in ihre registrierte Warteschlange einzureihen; bei Erfolg liefert es true.

Die statische Methode Reference.reachabilityFence(obj) hält obj bis zum Ende des Aufrufs stark erreichbar, auch wenn der Code es vorher nicht mehr direkt verwendet. Setze den Aufruf nach der Operation, die das Objekt benötigt, in einen finally-Block, damit er auch bei Ausnahmen erfolgt. Übergib das Objekt selbst, nicht sein schwaches, weiches oder Phantomreferenzobjekt. Die Methode löst weder GC noch Finalisierung aus; bei null hat sie keine Wirkung.

Eine ReferenceQueue<T> liefert beim Entnehmen ein Reference<? extends T>-Objekt, nicht dessen Zielobjekt. poll() entnimmt eine verfügbare Referenz oder liefert sofort null. remove() wartet ohne Zeitlimit. remove(long timeout) mit positivem Zeitlimit in Millisekunden liefert bei Ablauf null, ohne Echtzeitgarantie. 0 bedeutet unbegrenztes Warten, ein negativer Wert löst IllegalArgumentException aus. Wird das Warten unterbrochen, werfen beide remove-Überladungen InterruptedException.

Der GC reiht registrierte Referenzen beim Leeren oder später ein; der Zeitpunkt ist nicht vorhersagbar. Ein leeres poll() bedeutet nicht, dass das Zielobjekt noch lebt. Halte eine starke Referenz auf jedes registrierte Referenzobjekt, solange du die Benachrichtigung brauchst: Die Registrierung allein hält es nicht am Leben. Verlasse dich beim rechtzeitigen Schließen von Ressourcen nicht auf GC-Benachrichtigungen.

Beispiele

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);
        }
    }
}

Ergebnis

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

Die Barriere hält `target` stark erreichbar. Vor jedem `remove` wird mit `enqueue()` ausdrücklich ein Eintrag hinzugefügt. Das Beispiel zeigt den Unterschied zwischen Leeren und Einreihen, nicht den Zeitpunkt der GC oder den Ablauf des Zeitlimits.

Zugehörige Lektionen

  • Java · Lektion 45 · Fortgeschritten · Version: 2

Quellen