CKTIS / Java
IdentityHashMap — mapa založená na identitě objektů
IdentityHashMap porovnává klíče pomocí ==, nikoli equals, takže různé objekty se stejným obsahem mohou být samostatnými klíči. Seznamte se s metodami put, get, containsKey a size a zjistěte, jak rozlišit chybějící záznam od hodnoty null.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
// 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> porovnává klíče a hodnoty podle identity referencí (==), nikoli pomocí equals. Na rozdíl od HashMap rozlišuje různé objekty, které jsou podle equals stejné. Může se hodit například ke sledování objektů při hlubokém kopírování grafu.
IdentityHashMap.put(key, value) vloží záznam nebo nahradí hodnotu pro stejnou referenci klíče; vrátí předchozí hodnotu nebo null. IdentityHashMap.get(key) vrátí hodnotu nebo null. IdentityHashMap.containsKey(key) ověří přítomnost přesně této reference, a umožňuje tak odlišit chybějící záznam od hodnoty null. IdentityHashMap.size() vrátí počet záznamů.
Mapa povoluje klíč null i hodnoty null. Nezaručuje pořadí a není synchronizovaná. Záměrně porušuje obecný kontrakt Map založený na equals; není náhradou mapy pro obecné použití.
V příkladu vytvoří dvě volání new String("key") různé klíče, přestože mají stejný obsah. Další volání put pro a velikost nezvýší. Záznam pro b existuje, i když get(b) vrátí null.
Příklady
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")));
}
}Výsledek
true false 2 first updated null true false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.