Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

WeakReference: un riferimento debole a un oggetto

WeakReference<T> mantiene un riferimento debole che non impedisce al garbage collector di recuperare un oggetto. La lettura con get() può restituire null; clear() cancella il riferimento senza distruggere l’oggetto stesso.

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

Sintassi

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

WeakReference<T> del pacchetto java.lang.ref non mantiene vivo l’oggetto referenziato come fa un riferimento forte. Quando il garbage collector determina che un oggetto è raggiungibile solo debolmente, cancella i corrispondenti riferimenti deboli. Un uso tipico è nelle associazioni di canonicalizzazione che non devono mantenere vivi gli oggetti.

Il costruttore WeakReference(referent) non registra alcuna coda; WeakReference(referent, queue) registra facoltativamente una ReferenceQueue. I riferimenti cancellati dal GC entrano nella coda registrata nello stesso momento o in seguito. Cancellare un riferimento non significa, di per sé, che la memoria dell’oggetto sia stata recuperata.

Il metodo ereditato get() restituisce l’oggetto oppure null. Leggi il risultato una sola volta in una variabile locale e controllalo prima di usarlo: un risultato diverso da null è un riferimento forte. clear() cancella il riferimento, ma non lo inserisce nella coda e non distrugge l’oggetto.

L’esempio chiama deliberatamente clear() invece di attendere il GC. Reference.reachabilityFence(value) mantiene value fortemente raggiungibile fino a quel punto, rendendo deterministico l’output.

Esempi

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

Risultato

true
true
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti