CKTIS / Java
IdentityHashMap — un mapa basado en la identidad de los objetos
IdentityHashMap compara las claves con == en lugar de con equals, por lo que objetos distintos con el mismo contenido pueden ser claves separadas. Aprende a usar put, get, containsKey y size, y a distinguir una entrada ausente de un valor null.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
// 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 las claves y los valores según la identidad de las referencias (==), no mediante equals. A diferencia de HashMap, distingue objetos separados que son iguales según equals. Puede servir, por ejemplo, para hacer un seguimiento de objetos al copiar profundamente un grafo.
IdentityHashMap.put(key, value) añade una entrada o sustituye el valor de la misma referencia de clave; devuelve el valor anterior o null. IdentityHashMap.get(key) devuelve el valor o null. IdentityHashMap.containsKey(key) comprueba si está presente esa referencia exacta, lo que permite distinguir una entrada ausente de un valor null. IdentityHashMap.size() devuelve el número de entradas.
El mapa permite una clave null y valores null. No garantiza ningún orden y no está sincronizado. Incumple deliberadamente el contrato general de Map basado en equals; no es un sustituto de un mapa de propósito general.
En el ejemplo, dos llamadas a new String("key") crean claves distintas pese a tener el mismo contenido. Otro put para a no aumenta el tamaño. La entrada de b existe aunque get(b) devuelva null.
Ejemplos
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
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.