CKTIS / Java
WeakHashMap: un mapa con claves débiles
WeakHashMap mantiene las claves mediante referencias débiles: el mapa por sí solo no las protege de la recolección de basura. Aprende put, get, containsKey, containsValue y size, incluida la diferencia entre una entrada ausente y un valor null.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
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> es un mapa basado en hash con claves débiles. Una referencia débil no impide que el recolector de basura (GC) recupere un objeto. Por tanto, el mapa puede perder una entrada cuando se recolecta su clave; el momento de la eliminación no es determinista.
WeakHashMap.put(key, value) añade o reemplaza un valor y devuelve el valor anterior o null (no había entrada o el valor anterior era null). WeakHashMap.get(key) devuelve el valor o null. WeakHashMap.containsKey(key) comprueba si hay una entrada y distingue entre su ausencia y una asignación a null; WeakHashMap.containsValue(value) comprueba si hay un valor. WeakHashMap.size() devuelve un recuento instantáneo que puede disminuir sin modificaciones explícitas.
Se permiten la clave null y los valores null. Las búsquedas tienen en cuenta equals y hashCode, no solo la identidad de los objetos. Los valores se mantienen mediante referencias fuertes: sus referencias directas o indirectas a las claves pueden impedir que estas se recolecten. El mapa no está sincronizado; la sincronización no evita las eliminaciones provocadas por el GC.
El ejemplo mantiene key accesible hasta Reference.reachabilityFence(key) para que el resultado no dependa del GC. Muestra cómo se reemplaza un valor y la diferencia entre que get(key) devuelva null y que la clave esté presente.
Ejemplos
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);
}
}
}Resultado
null draft ready true true 1 null true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.