CKTIS / Java
IdentityHashMap — mapa oparta na tożsamości obiektów
IdentityHashMap porównuje klucze przez == zamiast equals. Różne obiekty o jednakowej treści mogą więc być osobnymi kluczami. Poznaj put, get, containsKey i size oraz rozróżnianie braku wpisu od wartości null.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
// 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> porównuje klucze i wartości według tożsamości referencji (==), a nie przez equals. W przeciwieństwie do HashMap rozróżnia odrębne obiekty równe według equals. Przydaje się np. do śledzenia obiektów podczas głębokiego kopiowania grafu.
IdentityHashMap.put(key, value) dodaje wpis albo zastępuje wartość dla tej samej referencji klucza; zwraca poprzednią wartość lub null. IdentityHashMap.get(key) zwraca wartość albo null. IdentityHashMap.containsKey(key) sprawdza obecność dokładnie tej referencji, pozwalając odróżnić brak wpisu od wartości null. IdentityHashMap.size() zwraca liczbę wpisów.
Mapa dopuszcza klucz null i wartości null. Nie gwarantuje kolejności i nie jest synchronizowana. Celowo narusza ogólny kontrakt Map oparty na equals; nie jest zamiennikiem mapy ogólnego przeznaczenia.
W przykładzie dwa wywołania new String("key") tworzą różne klucze mimo jednakowej treści. Ponowne put dla a nie zwiększa rozmiaru. Wpis dla b istnieje, choć get(b) zwraca null.
Przykłady
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")));
}
}Wynik
true false 2 first updated null true false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.