CKTIS / Java
WeakHashMap — um mapa com chaves fracas
WeakHashMap mantém as chaves através de referências fracas: o mapa, por si só, não as protege da recolha de lixo. Aprende put, get, containsKey, containsValue e size, incluindo a diferença entre uma entrada em falta e um valor null.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
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> é um mapa baseado em hash com chaves fracas. Uma referência fraca não impede que o garbage collector (GC) recupere um objeto. Assim, o mapa pode perder uma entrada depois de a respetiva chave ser recolhida; o momento da remoção é indeterminado.
WeakHashMap.put(key, value) adiciona ou substitui um valor e devolve o valor anterior ou null (não existia entrada ou o valor anterior era null). WeakHashMap.get(key) devolve o valor ou null. WeakHashMap.containsKey(key) verifica se existe uma entrada, distinguindo a ausência de uma associação a null; WeakHashMap.containsValue(value) verifica se existe um valor. WeakHashMap.size() devolve uma contagem instantânea que pode diminuir sem alterações explícitas.
São permitidos a chave null e os valores null. A pesquisa respeita equals e hashCode, e não apenas a identidade dos objetos. Os valores são mantidos através de referências fortes: as suas referências diretas ou indiretas às chaves podem impedir a recolha destas. O mapa não é sincronizado; a sincronização não impede a remoção causada pelo GC.
O exemplo mantém key alcançável até Reference.reachabilityFence(key), para que o resultado não dependa do GC. Demonstra a substituição de um valor e a diferença entre get(key) devolver null e a chave estar presente.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.