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.