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.