Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

PhantomReference — références fantômes

PhantomReference<T> permet de recevoir une notification des changements d’accessibilité d’un objet sans le rendre accessible par get(). Elle fonctionne avec une ReferenceQueue ; l’exemple montre une mise en file manuelle et déterministe.

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

Syntaxe

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

PhantomReference<T>, dans java.lang.ref, permet de prévoir un nettoyage après la vie d’un objet. Contrairement à WeakReference et SoftReference, elle ne donne pas accès à l’objet référencé par get() — cette méthode renvoie toujours null. Son constructeur prend un objet référencé et une ReferenceQueue<? super T> ; une file null signifie qu’aucune notification par file n’aura lieu.

Lorsque le GC détecte une accessibilité fantôme, il efface atomiquement le groupe correspondant de références fantômes, puis place les références enregistrées dans leurs files, immédiatement ou plus tard. Le programme doit garder la PhantomReference elle-même accessible ; son enregistrement dans une file ne le garantit pas. Conservez séparément les données nécessaires au nettoyage, sans référence forte à l’objet surveillé.

refersTo(obj) vérifie l’identité de l’objet référencé, tandis que refersTo(null) détecte l’effacement de la référence. Appeler clear() seul ne place pas la référence dans la file. En revanche, enqueue() l’efface et l’ajoute à sa file si possible ; un appel manuel ne prouve pas que le GC a récupéré de la mémoire.

L’exemple utilise volontairement enqueue() au lieu d’attendre le GC. Reference.reachabilityFence(referent) maintient l’objet référencé fortement accessible pendant toute la démonstration, évitant une course avec le GC. poll() récupère l’objet référence, et non l’objet référencé. Le code illustre le fonctionnement d’une file, pas une implémentation de nettoyage des ressources.

Exemples

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

Résultat

true
true
true
true
true
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources