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

CKTIS / Java

WeakReference — une référence faible vers un objet

WeakReference<T> contient une référence faible qui n’empêche pas le garbage collector de récupérer un objet. La lecture avec get() peut renvoyer null ; clear() efface la référence sans détruire l’objet lui-même.

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

Syntaxe

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

WeakReference<T> du paquet java.lang.ref ne maintient pas son référent en vie comme le ferait une référence forte. Lorsque le garbage collector détermine qu’un objet n’est plus accessible que faiblement, il efface les références faibles correspondantes. Les associations de canonicalisation qui ne doivent pas maintenir les objets en vie constituent un cas d’utilisation courant.

Le constructeur WeakReference(referent) n’enregistre aucune file ; WeakReference(referent, queue) enregistre éventuellement une ReferenceQueue. Les références effacées par le GC entrent dans leur file enregistrée au même moment ou ultérieurement. L’effacement d’une référence ne signifie pas, à lui seul, que la mémoire de l’objet a été récupérée.

La méthode héritée get() renvoie l’objet ou null. Lis le résultat une fois dans une variable locale et vérifie-le avant de l’utiliser : un résultat non nul est une référence forte. clear() efface la référence, mais ne la place pas dans la file et ne détruit pas l’objet.

L’exemple appelle délibérément clear() au lieu d’attendre le GC. Reference.reachabilityFence(value) maintient value fortement accessible jusqu’à ce point, ce qui rend la sortie déterministe.

Exemples

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

Résultat

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