Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

IdentityHashMap — una mappa basata sull’identità degli oggetti

IdentityHashMap confronta le chiavi usando == invece di equals, quindi oggetti distinti con lo stesso contenuto possono essere chiavi separate. Scopri put, get, containsKey e size e come distinguere una voce assente da un valore null.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

// 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> confronta chiavi e valori in base all’identità dei riferimenti (==), non con equals. A differenza di HashMap, distingue oggetti separati che risultano uguali secondo equals. Può essere utile, ad esempio, per tenere traccia degli oggetti durante la copia profonda di un grafo.

IdentityHashMap.put(key, value) inserisce una voce o sostituisce il valore associato alla stessa referenza della chiave; restituisce il valore precedente oppure null. IdentityHashMap.get(key) restituisce il valore oppure null. IdentityHashMap.containsKey(key) verifica la presenza di quella referenza esatta, distinguendo una voce assente da un valore null. IdentityHashMap.size() restituisce il numero di voci.

La mappa ammette una chiave null e valori null. Non garantisce un ordine e non è sincronizzata. Viola intenzionalmente il contratto generale di Map basato su equals; non è un sostituto di una mappa per uso generale.

Nell’esempio, due chiamate a new String("key") creano chiavi diverse nonostante il contenuto uguale. Un altro put per a non aumenta la dimensione. La voce per b esiste anche se get(b) restituisce null.

Esempi

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")));
    }
}

Risultato

true
false
2
first
updated
null
true
false

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti