WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

PhantomReference — Phantomreferenzen

PhantomReference<T> ermöglicht Benachrichtigungen über Änderungen der Erreichbarkeit eines Objekts, ohne es über get() zugänglich zu machen. Sie arbeitet mit einer ReferenceQueue; das Beispiel zeigt das deterministische manuelle Einreihen einer Referenz.

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

Syntax

PhantomReference<T> ref = new PhantomReference<>(referent, queue);

PhantomReference<T> aus java.lang.ref dient dazu, eine Bereinigung nach dem Lebenszyklus eines Objekts vorzubereiten. Anders als WeakReference und SoftReference gibt sie das referenzierte Objekt nicht über get() zurück — diese Methode liefert immer null. Der Konstruktor nimmt ein referenziertes Objekt und eine ReferenceQueue<? super T> entgegen; eine null-Queue bedeutet, dass keine Benachrichtigung über eine Queue erfolgt.

Wenn der GC Phantom-Erreichbarkeit feststellt, löscht er atomar die entsprechende Gruppe von Phantomreferenzen und reiht registrierte Referenzen sofort oder später in ihre Queues ein. Das Programm muss die PhantomReference selbst erreichbar halten; die Registrierung in einer Queue stellt das nicht sicher. Speichere die für die Bereinigung benötigten Daten getrennt und ohne starke Referenz auf das überwachte Objekt.

refersTo(obj) prüft die Identität des referenzierten Objekts, während refersTo(null) erkennt, ob die Referenz gelöscht wurde. Ein Aufruf von clear() allein reiht die Referenz nicht in die Queue ein. enqueue() löscht sie dagegen und fügt sie, sofern möglich, ihrer Queue hinzu; ein manueller Aufruf beweist nicht, dass der GC Speicher freigegeben hat.

Das Beispiel verwendet absichtlich enqueue(), statt auf den GC zu warten. Reference.reachabilityFence(referent) hält das referenzierte Objekt während der gesamten Demonstration stark erreichbar und verhindert so ein Rennen mit dem GC. poll() ruft das Referenzobjekt ab, nicht das referenzierte Objekt. Der Code demonstriert die Funktionsweise der Queue, keine Implementierung zur Ressourcenbereinigung.

Beispiele

import java.lang.ref.PhantomReference;
import java.lang.ref.Reference;
import java.lang.ref.ReferenceQueue;

public class Main {
    public static void main(String[] args) {
        Object referent = new Object();
        ReferenceQueue<Object> queue = new ReferenceQueue<>();
        PhantomReference<Object> ref = new PhantomReference<>(referent, queue);

        System.out.println(ref.get() == null);
        System.out.println(ref.refersTo(referent));
        System.out.println(ref.enqueue());
        System.out.println(ref.refersTo(null));
        System.out.println(queue.poll() == ref);
        System.out.println(queue.poll() == null);
        Reference.reachabilityFence(referent);
    }
}

Ergebnis

true
true
true
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