Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

IdentityHashMap: put, get, containsKey y size

`IdentityHashMap` compara las claves con `==`, no con `equals`. Aprende cuándo `put` reemplaza una entrada, qué cuenta `size` y cómo distinguir una clave ausente de una asociada a `null`.

Versión: Java SE 21

Sintaxis

import java.util.IdentityHashMap;

// Instance method signatures on IdentityHashMap<K, V>:
public V put(K key, V value)
public V get(Object key)
public boolean containsKey(Object key)
public int size()

En Java SE 21, java.util.IdentityHashMap<K, V> reconoce una clave almacenada si y solo si key == storedKey. Dos referencias al mismo objeto identifican la misma clave; dos objetos distintos pueden ser claves distintas aunque equals devuelva true. El mapa no llama a equals ni a hashCode de la clave para encontrarla: calcula el hash con System.identityHashCode y decide con == si las claves coinciden.

put(K key, V value) añade una entrada si la clave no existe o reemplaza su valor si ya existe. Devuelve el valor anterior, o null si la clave no existía o estaba asociada a null. size() devuelve el número de entradas como int: insertar una lo aumenta en uno, mientras que reemplazar un valor no lo cambia.

get(Object key) devuelve el valor asociado, o null si no existe la clave. El mapa admite una clave null y valores null, de modo que get por sí solo no basta para saber si existe la entrada. containsKey(Object key) devuelve true exactamente cuando existe una entrada para esa clave, sea cual sea su valor.

La clase implementa Map, pero se aparta deliberadamente del contrato general de igualdad de la interfaz, basado en equals. Úsala cuando importe la instancia concreta, por ejemplo, al llevar la cuenta de los nodos visitados en un grafo de objetos. No la uses en lugar de HashMap si las claves deben compararse por valor.

Ejemplos

import java.util.IdentityHashMap;

public class Main {
    public static void main(String[] args) {
        String a = new String("node");
        String b = new String("node");
        String alias = a;
        IdentityHashMap<String, String> map = new IdentityHashMap<>();

        System.out.println("a.equals(b): " + a.equals(b));
        System.out.println("a == b: " + (a == b));
        System.out.println("put(a): " + map.put(a, "first"));
        System.out.println("get(alias): " + map.get(alias));
        System.out.println("put(alias): " + map.put(alias, "updated"));
        System.out.println("size after replacement: " + map.size());

        System.out.println("get(b) before insert: " + map.get(b));
        System.out.println("containsKey(b) before insert: " + map.containsKey(b));
        System.out.println("put(b, null): " + map.put(b, null));
        System.out.println("get(b) after insert: " + map.get(b));
        System.out.println("containsKey(b) after insert: " + map.containsKey(b));
        System.out.println("get(a) after insert: " + map.get(a));
        System.out.println("final size: " + map.size());
    }
}

Resultado

a.equals(b): true
a == b: false
put(a): null
get(alias): first
put(alias): first
size after replacement: 1
get(b) before insert: null
containsKey(b) before insert: false
put(b, null): null
get(b) after insert: null
containsKey(b) after insert: true
get(a) after insert: updated
final size: 2

`a` y `b` contienen el mismo texto, pero son objetos distintos. `alias` apunta a `a`, así que escribir mediante `alias` devuelve `first` y mantiene el tamaño en `1`. `get(b)` devuelve `null` antes y después de la inserción, pero `containsKey(b)` pasa de `false` a `true` y el tamaño sube a `2`.

Lecciones relacionadas

  • Java · Lección 17 · Avanzado · Versión: 2

Fuentes