Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

WeakHashMap — una mappa con chiavi deboli

WeakHashMap mantiene le chiavi tramite riferimenti deboli: la mappa da sola non le protegge dalla garbage collection. Scopri put, get, containsKey, containsValue e size, compresa la differenza tra un elemento assente e un valore null.

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

Sintassi

WeakHashMap<K, V> map = new WeakHashMap<>();
V previous = map.put(key, value);
V retrieved = map.get(key);
boolean hasKey = map.containsKey(key);
boolean hasValue = map.containsValue(value);
int count = map.size();

java.util.WeakHashMap<K, V> è una mappa basata su hash con chiavi deboli. Un riferimento debole non impedisce al garbage collector (GC) di recuperare un oggetto. La mappa può quindi perdere un elemento dopo che la relativa chiave è stata raccolta; il momento della rimozione non è deterministico.

WeakHashMap.put(key, value) aggiunge o sostituisce un valore e restituisce il valore precedente oppure null (nessun elemento o valore precedente null). WeakHashMap.get(key) restituisce il valore oppure null. WeakHashMap.containsKey(key) verifica la presenza di un elemento distinguendo l’assenza da un’associazione a null; WeakHashMap.containsValue(value) verifica la presenza di un valore. WeakHashMap.size() restituisce un conteggio istantaneo che può diminuire senza modifiche esplicite.

Sono consentiti la chiave null e i valori null. La ricerca tiene conto di equals e hashCode, non solo dell’identità degli oggetti. I valori sono mantenuti tramite riferimenti forti: i loro riferimenti diretti o indiretti alle chiavi possono impedirne la raccolta. La mappa non è sincronizzata; la sincronizzazione non impedisce le rimozioni dovute al GC.

L’esempio mantiene key raggiungibile fino a Reference.reachabilityFence(key), così che il risultato non dipenda dal GC. Mostra la sostituzione di un valore e la differenza tra get(key) che restituisce null e la presenza della chiave.

Esempi

import java.lang.ref.Reference;
import java.util.WeakHashMap;

public class Main {
    public static void main(String[] args) {
        Object key = new Object();
        WeakHashMap<Object, String> map = new WeakHashMap<>();
        try {
            System.out.println(map.put(key, "draft"));
            System.out.println(map.put(key, "ready"));
            System.out.println(map.get(key));
            System.out.println(map.containsKey(key));
            System.out.println(map.containsValue("ready"));
            System.out.println(map.size());
            map.put(key, null);
            System.out.println(map.get(key));
            System.out.println(map.containsKey(key));
        } finally {
            Reference.reachabilityFence(key);
        }
    }
}

Risultato

null
draft
ready
true
true
1
null
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