Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes