CKTIS / Java
WeakHashMap: inserire, leggere, verificare e contare le associazioni
Scopri come funzionano cinque operazioni di `WeakHashMap` in Java SE 21 in presenza di chiavi deboli, valori forti e associazioni con `null`.
Versione: Java SE 21
Sintassi
java.util.WeakHashMap<K, V> (Java SE 21)
public V put(K key, V value)
public V get(Object key)
public boolean containsKey(Object key)
public boolean containsValue(Object value)
public int size()java.util.WeakHashMap<K, V> mantiene le chiavi diverse da null tramite riferimenti deboli e i valori tramite riferimenti forti. Quando un oggetto chiave diventa debolmente raggiungibile, il garbage collector (GC) può cancellarne il riferimento debole e la mappa può poi rimuovere la voce. Non c’è un termine garantito. Un percorso diretto o indiretto di riferimenti forti da un valore alla propria chiave può impedirlo.
La ricerca delle chiavi usa hashCode() ed equals(), non la sola identità dell’oggetto (==). Un oggetto distinto ma uguale può trovare una voce, ma da solo non mantiene in vita l’oggetto chiave memorizzato. La mappa ammette una chiave null e valori null.
put(K key, V value) aggiunge un’associazione o sostituisce il valore di una chiave uguale. Restituisce il valore precedente, oppure null se l’associazione non esisteva o se il valore precedente era null. get(Object key) restituisce il valore attuale; null può indicare sia un’associazione assente sia un valore null associato. containsKey(Object key) verifica l’esistenza dell’associazione a prescindere dal valore e distingue i due casi. Due chiamate non costituiscono però un’unica osservazione atomica.
containsValue(Object value) verifica se almeno un’associazione ha un valore uguale a quello cercato, anche quando si cerca null. size() conta le associazioni al momento della chiamata, comprese quelle con valore null. I risultati possono cambiare senza scritture dell’applicazione quando la mappa rimuove le voci dopo che il GC ne ha cancellato i riferimenti alle chiavi.
La mappa non offre né TTL (scadenza temporale) né LRU (espulsione della voce usata meno di recente). Non è thread-safe: Collections.synchronizedMap(...) può sincronizzare gli accessi condivisi, ma non impedisce la pulizia legata al GC.
Esempi
import java.lang.ref.Reference;
import java.util.WeakHashMap;
public class WeakHashMapDemo {
record Key(int id) {}
public static void main(String[] args) {
var map = new WeakHashMap<Key, String>();
var stored = new Key(1);
var equal = new Key(1);
var missing = new Key(2);
System.out.println("first put: " + map.put(stored, "draft"));
System.out.println("replacement put: " + map.put(equal, "ready"));
map.put(null, null);
System.out.println("get(equal): " + map.get(equal));
System.out.println("get(null): " + map.get(null));
System.out.println("get(missing): " + map.get(missing));
System.out.println("containsKey(null): " + map.containsKey(null));
System.out.println("containsKey(missing): " + map.containsKey(missing));
System.out.println("containsValue(null): " + map.containsValue(null));
System.out.println("size: " + map.size());
Reference.reachabilityFence(stored);
Reference.reachabilityFence(equal);
}
}Risultato
first put: null replacement put: draft get(equal): ready get(null): null get(missing): null containsKey(null): true containsKey(missing): false containsValue(null): true size: 2
`equal` è distinto da `stored` ma uguale a esso: sostituisce `draft` con `ready` senza aggiungere un’associazione. `get` restituisce `null` sia per la chiave `null` sia per `missing`, ma solo la prima è presente. `Reference.reachabilityFence` mantiene entrambi gli oggetti chiave fortemente raggiungibili fino all’ultima stampa; l’esempio non verifica quando interviene il GC.
Lezioni correlate
- Java · Lezione 18 · Avanzato · Versione: 2