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

CKTIS / Java

IdentityHashMap — um mapa baseado na identidade dos objetos

IdentityHashMap compara as chaves com == em vez de equals, pelo que objetos distintos com o mesmo conteúdo podem ser chaves separadas. Aprende a usar put, get, containsKey e size, e a distinguir uma entrada em falta de um valor null.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

// Given K key and V value:
IdentityHashMap<K, V> map = new IdentityHashMap<>();
V previous = map.put(key, value);
V retrieved = map.get(key);
boolean present = map.containsKey(key);
int count = map.size();

java.util.IdentityHashMap<K, V> compara as chaves e os valores pela identidade das referências (==), e não através de equals. Ao contrário de HashMap, distingue objetos diferentes que são iguais segundo equals. Pode ser útil, por exemplo, para acompanhar objetos durante a cópia profunda de um grafo.

IdentityHashMap.put(key, value) adiciona uma entrada ou substitui o valor associado à mesma referência da chave; devolve o valor anterior ou null. IdentityHashMap.get(key) devolve o valor ou null. IdentityHashMap.containsKey(key) verifica a presença dessa referência exata, permitindo distinguir uma entrada em falta de um valor null. IdentityHashMap.size() devolve o número de entradas.

O mapa permite uma chave null e valores null. Não garante uma ordem e não é sincronizado. Viola deliberadamente o contrato geral de Map baseado em equals; não é um substituto de um mapa de uso geral.

No exemplo, duas chamadas a new String("key") criam chaves diferentes apesar do conteúdo igual. Outro put para a não aumenta o tamanho. A entrada de b existe, embora get(b) devolva null.

Exemplos

import java.util.IdentityHashMap;

public class Main {
    public static void main(String[] args) {
        String a = new String("key");
        String b = new String("key");
        IdentityHashMap<String, String> map = new IdentityHashMap<>();

        map.put(a, "first");
        map.put(b, null);
        System.out.println(a.equals(b));
        System.out.println(a == b);
        System.out.println(map.size());
        System.out.println(map.put(a, "updated"));
        System.out.println(map.get(a));
        System.out.println(map.get(b));
        System.out.println(map.containsKey(b));
        System.out.println(map.containsKey(new String("key")));
    }
}

Resultado

true
false
2
first
updated
null
true
false

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