CKTIS / Java
IdentityHashMap — eine Map auf Basis der Objektidentität
IdentityHashMap vergleicht Schlüssel mit == statt mit equals. Daher können verschiedene Objekte mit gleichem Inhalt separate Schlüssel sein. Lerne put, get, containsKey und size kennen und erfahre, wie sich ein fehlender Eintrag von einem null-Wert unterscheiden lässt.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
// 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> vergleicht Schlüssel und Werte anhand der Referenzidentität (==), nicht mit equals. Anders als HashMap unterscheidet sie separate Objekte, die laut equals gleich sind. Ein möglicher Einsatz ist das Nachverfolgen von Objekten beim tiefen Kopieren eines Objektgraphen.
IdentityHashMap.put(key, value) fügt einen Eintrag hinzu oder ersetzt den Wert für dieselbe Schlüsselreferenz; zurückgegeben wird der vorherige Wert oder null. IdentityHashMap.get(key) gibt den Wert oder null zurück. IdentityHashMap.containsKey(key) prüft, ob genau diese Referenz vorhanden ist, und unterscheidet so einen fehlenden Eintrag von einem null-Wert. IdentityHashMap.size() gibt die Anzahl der Einträge zurück.
Die Map erlaubt einen null-Schlüssel und null-Werte. Sie garantiert keine Reihenfolge und ist nicht synchronisiert. Sie verletzt bewusst den allgemeinen, auf equals beruhenden Map-Vertrag und ist kein Ersatz für eine Map für den allgemeinen Gebrauch.
Im Beispiel erzeugen zwei Aufrufe von new String("key") trotz gleichen Inhalts unterschiedliche Schlüssel. Ein weiteres put für a erhöht die Größe nicht. Der Eintrag für b ist vorhanden, obwohl get(b) null zurückgibt.
Beispiele
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")));
}
}Ergebnis
true false 2 first updated null true false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.