CKTIS / Java
IdentityHashMap — mapa založená na identite objektov
IdentityHashMap porovnáva kľúče pomocou ==, nie equals, takže rôzne objekty s rovnakým obsahom môžu byť samostatnými kľúčmi. Spoznajte metódy put, get, containsKey a size a zistite, ako rozlíšiť chýbajúci záznam od hodnoty null.
Verzia: 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> porovnáva kľúče a hodnoty podľa identity referencií (==), nie pomocou equals. Na rozdiel od HashMap rozlišuje rôzne objekty, ktoré sú podľa equals rovnaké. Môže sa hodiť napríklad na sledovanie objektov pri hlbokom kopírovaní grafu.
IdentityHashMap.put(key, value) vloží záznam alebo nahradí hodnotu pre tú istú referenciu kľúča; vráti predchádzajúcu hodnotu alebo null. IdentityHashMap.get(key) vráti hodnotu alebo null. IdentityHashMap.containsKey(key) overí prítomnosť presne tejto referencie a umožňuje tak rozlíšiť chýbajúci záznam od hodnoty null. IdentityHashMap.size() vráti počet záznamov.
Mapa povoľuje kľúč null aj hodnoty null. Nezaručuje poradie a nie je synchronizovaná. Zámerne porušuje všeobecný kontrakt Map založený na equals; nie je náhradou mapy na všeobecné použitie.
V príklade vytvoria dve volania new String("key") rôzne kľúče napriek rovnakému obsahu. Ďalšie volanie put pre a nezvýši veľkosť. Záznam pre b existuje, hoci get(b) vráti null.
Prí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ýsledok
true false 2 first updated null true false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.