KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

PhantomReference — phantomreferenties

PhantomReference<T> maakt meldingen mogelijk over veranderingen in de bereikbaarheid van een object zonder het via get() beschikbaar te maken. De klasse werkt met een ReferenceQueue; het voorbeeld toont deterministisch, handmatig toevoegen aan de wachtrij.

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

Syntax

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

PhantomReference<T> uit java.lang.ref helpt om opruimen na de levensduur van een object voor te bereiden. Anders dan WeakReference en SoftReference geeft deze klasse het gerefereerde object niet via get() terug — die methode retourneert altijd null. De constructor accepteert een gerefereerd object en een ReferenceQueue<? super T>; een null-wachtrij betekent dat er geen melding via een wachtrij plaatsvindt.

Wanneer de GC phantom-bereikbaarheid vaststelt, wist deze atomair de bijbehorende groep phantomreferenties en plaatst hij geregistreerde referenties meteen of later in hun wachtrijen. Het programma moet de PhantomReference zelf bereikbaar houden; registratie in een wachtrij zorgt daar niet voor. Bewaar gegevens die nodig zijn voor het opruimen apart, zonder een sterke referentie naar het bewaakte object.

refersTo(obj) controleert de identiteit van het gerefereerde object, terwijl refersTo(null) detecteert of de referentie is gewist. Alleen clear() aanroepen plaatst de referentie niet in de wachtrij. enqueue() wist de referentie juist wel en voegt die, indien mogelijk, aan de wachtrij toe; een handmatige aanroep bewijst niet dat de GC geheugen heeft vrijgemaakt.

Het voorbeeld gebruikt bewust enqueue() in plaats van op de GC te wachten. Reference.reachabilityFence(referent) houdt het gerefereerde object tijdens de hele demonstratie sterk bereikbaar en voorkomt zo een race met de GC. poll() haalt het referentieobject op, niet het gerefereerde object. De code laat zien hoe een wachtrij werkt, niet hoe je het opruimen van resources implementeert.

Voorbeelden

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

Resultaat

true
true
true
true
true
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen