WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

WeakReference – eine schwache Referenz auf ein Objekt

WeakReference<T> hält eine schwache Referenz, die den Garbage Collector nicht daran hindert, ein Objekt zurückzugewinnen. Das Lesen mit get() kann null ergeben; clear() löscht die Referenz, ohne das Objekt selbst zu zerstören.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

WeakReference<T> ref = new WeakReference<>(referent);
// Alternative: WeakReference<T> ref = new WeakReference<>(referent, queue);
T value = ref.get();
ref.clear();

WeakReference<T> aus java.lang.ref hält das referenzierte Objekt nicht am Leben, wie es eine starke Referenz tut. Wenn der Garbage Collector feststellt, dass ein Objekt nur noch schwach erreichbar ist, löscht er die entsprechenden schwachen Referenzen. Ein typischer Anwendungsfall sind kanonisierende Zuordnungen, die Objekte nicht am Leben halten sollen.

Der Konstruktor WeakReference(referent) registriert keine Warteschlange; WeakReference(referent, queue) registriert optional eine ReferenceQueue. Vom GC gelöschte Referenzen gelangen gleichzeitig oder später in ihre registrierte Warteschlange. Das Löschen einer Referenz bedeutet nicht automatisch, dass der Speicher des Objekts zurückgewonnen wurde.

Die geerbte Methode get() gibt das Objekt oder null zurück. Lies das Ergebnis einmal in eine lokale Variable ein und prüfe es vor der Verwendung: Ein von null verschiedenes Ergebnis ist eine starke Referenz. clear() löscht die Referenz, fügt sie aber weder zur Warteschlange hinzu noch zerstört es das Objekt.

Das Beispiel ruft absichtlich clear() auf, statt auf den GC zu warten. Reference.reachabilityFence(value) hält value bis zu dieser Stelle stark erreichbar und macht so die Ausgabe deterministisch.

Beispiele

import java.lang.ref.Reference;
import java.lang.ref.WeakReference;

public class Main {
    public static void main(String[] args) {
        Object value = new Object();
        WeakReference<Object> ref = new WeakReference<>(value);

        System.out.println(ref.get() == value);
        ref.clear();
        System.out.println(ref.get() == null);
        System.out.println(value != null);

        Reference.reachabilityFence(value);
    }
}

Ergebnis

true
true
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen