HashMap en Java: ejemplo ejecutable

Un HashMap es una implementación de la interfaz Map que almacena pares clave-valor: cada clave se asigna exactamente a un valor y la usas para recuperarlo. A diferencia de una lista, cuyo índice es siempre un número entero, en un HashMap el índice lo defines tú, por ejemplo un String. Las claves son únicas y los valores pueden repetirse.

Los métodos esenciales son put para añadir, get para obtener, containsKey para comprobar si existe una clave y remove para eliminar. El ejemplo los usa con un mapa de salarios por empleado y recorre las claves con keySet, que devuelve todas las claves como un conjunto. Un HashMap no mantiene el orden de inserción, así que el orden en que salen las claves puede no coincidir con el orden en que las añadiste; si necesitas orden, el artículo recomienda LinkedHashMap o TreeMap.

Puedes usar cualquier clase como clave, pero para que el mapa funcione bien debes implementar correctamente equals() y hashCode() en ella. Además, conviene que las claves sean inmutables: si una clave cambia después de guardarla, el HashMap la busca con el índice equivocado y ya no encuentra el valor.

La parte final del ejemplo lo demuestra con la clase IndiceHash: guardamos el valor «success» con una clave que vale 1, cambiamos la clave a 2 y al hacer get obtenemos null. Ejecútalo para comprobarlo y prueba a quitar la línea que cambia la clave para ver el valor recuperado.

import java.util.HashMap;
import java.util.Map;
import java.util.Objects;

class IndiceHash {
  private Integer indice;

  IndiceHash(Integer indice) {
    this.indice = indice;
  }

  void setIndice(Integer indice) {
    this.indice = indice;
  }

  @Override
  public boolean equals(Object o) {
    if (this == o) {
      return true;
    }
    if (o == null || getClass() != o.getClass()) {
      return false;
    }
    IndiceHash that = (IndiceHash) o;
    return Objects.equals(indice, that.indice);
  }

  @Override
  public int hashCode() {
    return Objects.hash(indice);
  }
}

public class Main {
  public static void main(String[] args) {
    Map<String, Integer> salarioPorEmpleado = new HashMap<>();
    salarioPorEmpleado.put("Juan", 5000);
    salarioPorEmpleado.put("Ana", 5500);

    System.out.println("Salario de Juan: " + salarioPorEmpleado.get("Juan"));
    System.out.println("¿Existe Luis? " + salarioPorEmpleado.containsKey("Luis"));

    for (String clave : salarioPorEmpleado.keySet()) {
      System.out.println(clave + " = " + salarioPorEmpleado.get(clave));
    }

    salarioPorEmpleado.remove("Juan");
    System.out.println("Tras remove: " + salarioPorEmpleado.size() + " elemento(s)");

    // Si la clave cambia después de usarla, el HashMap la busca con el índice equivocado.
    IndiceHash clave = new IndiceHash(1);
    Map<IndiceHash, String> elementos = new HashMap<>();
    elementos.put(clave, "success");
    clave.setIndice(2);
    System.out.println("Tras cambiar la clave: " + elementos.get(clave));
  }
}
Ejecutar en el playground