¿Cómo usar HashMap.put() en Java paso a paso?

No me lo vas a creer, pero un día estaba gestionando el inventario de una tienda y todo iba súper, hasta que me tocó actualizar los precios de los productos. Pensé: “No puede ser, ahora tendré que reescribir todo el sistema”, pero menos mal no fue así. HashMap.put() en Java fue la solución que me salvó, porque es muy útil para insertar, actualizar y gestionar datos en un HashMap. Así que aquí te preparé un tutorial para que aprendas a usarlo paso a paso.

¿Qué es HashMap.put() en Java?

Para que entiendas bien qué es HashMap.put() en Java quiero que imagines un armario con varios cajones. Cada cajón tiene una etiqueta para identificar lo que contiene. Entonces, cuando usas HasMap.put() es como si abrieras un cajón de esos y colocaras un objeto dentro de él, todo gracias a la etiqueta que tenía el cajón, que te ayudó a recordar dónde guardaste ese objeto.

Entonces, si llevamos esta analogía a la programación, sería algo así:

• HashMap: Sería el armario con muchos cajones (cajas de almacenamiento).
• Llave (Key): Es la etiqueta del cajón que usas para identificarlo.
• Valor (Value): Es el objeto que guardas dentro del cajón.

¿Ya lo entendiste mejor? Simplemente, al usar put en el HashMap, le estás diciendo al armario (HashMap) que coloque un objeto (valor) en un cajón específico identificado por una etiqueta (llave).

Sintaxis del método

HashMap.put(key, value);

Parámetros

1. key: Ya sabes que es la clave que quieres asociar a un valor en el mapa.
2. value: Es el valor que estará vinculado a la clave.

Valor de retorno

• Si la clave ya existía en el mapa, el método devuelve el valor anterior asociado a esa clave.
• Si la clave no existía, devuelve null.

Paso a paso: Usando HashMap.put() en Java

Crea un HashMap

Antes de usar put(), necesitas crear un HashMap. Puedes definir el tipo de datos para las claves y los valores según tus necesidades.

import java.util.HashMap;

public class Main {
    public static void main(String[] args) {
        HashMap<Integer, String> map = new HashMap<>();
        System.out.println("Mapa vacío: " + map);
    }
}

Inserta nuevos pares clave-valor

En este paso te aconsejo usar HashMap.put() en Java para agregar elementos al mapa.

map.put(1, "Java");
map.put(2, "Python");
map.put(3, "JavaScript");
System.out.println("Mapa con datos: " + map);

La salida te debe quedar así:

Mapa con datos: {1=Java, 2=Python, 3=JavaScript}

Reemplaza valores para claves existentes

Recuerda que, si intentas agregar una clave que ya existe, el valor será reemplazado y el método devolverá el valor anterior.

String oldValue = map.put(2, "C++");
System.out.println("Valor anterior: " + oldValue);
System.out.println("Mapa actualizado: " + map);

Mira la salida:

Valor anterior: Python
Mapa actualizado: {1=Java, 2=C++, 3=JavaScript}

Inserta claves nuevas

Como te expliqué al principio, cuando usas una clave nueva, el método devuelve null.

String returnedValue = map.put(4, "Ruby");
System.out.println("Valor retornado: " + returnedValue);
System.out.println("Mapa con nueva entrada: " + map);

Esta es la salida:

Valor retornado: null
Mapa con nueva entrada: {1=Java, 2=C++, 3=JavaScript, 4=Ruby}

Ejemplo práctico: Cuenta las palabras en un texto

Quise dejarte un ejemplo un poco más complejo, donde combiné el uso de HashMap.put() en Java con lógica básica para contar palabras.

import java.util.HashMap;

public class WordCounter {
    public static void main(String[] args) {
        String text = "Java es divertido, y aprender Java es útil.";
        String[] words = text.split(" ");

        HashMap<String, Integer> wordCount = new HashMap<>();

        for (String word : words) {
            word = word.toLowerCase().replaceAll("[^a-z]", "");
            wordCount.put(word, wordCount.getOrDefault(word, 0) + 1);
        }

        System.out.println("Conteo de palabras: " + wordCount);
    }
}

La salida te queda así:

Conteo de palabras: {java=2, es=2, divertido=1, y=1, aprender=1, útil=1}

Consejos a la hora de usar HashMap.put() en Java

• Definir tipos genéricos: Lo que a mí me ha servido es especificar el tipo de datos que voy a manejar en el HashMap, así he logrado evitar esos errores en tiempo de compilación.

HashMap<String, Integer> inventory = new HashMap<>();

• Comprobar valores retornados: En caso de que tengas que manejar lógica adicional, como verificar si una clave ya existía, lo mejor es que uses el valor retornado por el método put().
• Evitar claves nulas en exceso: Aunque HashMap permite una clave null, abusar de esto puede dificultar la comprensión del código.
• Manejar hilos en Java: Si trabajas en un entorno multi-hilo, desde mi experiencia es mejor que optes por ConcurrentHashMap en lugar de HashMap.

Espero haberte ayudado a entender que HashMap.put() en Java es fundamental a la hora de trabajar con mapas. Con esta herramienta no solo agregas y actualizas datos, sino que también puedes resolver problemas como el conteo de palabras o gestionar inventarios, que fue mi caso.

¿Quieres dominar Java y aprender a desarrollar aplicaciones completas en tiempo récord? En el Bootcamp de Java Full Stack de KeepCoding te enseñaremos todo lo que necesitas para destacar en el sector IT. ¡Apúntate ahora y transforma tu carrera!