CKTIS / Java
Map.get: consultar un valor por su clave
Usa `map.get(key)` para recuperar un valor almacenado. Si el mapa admite valores `null`, el resultado por sí solo no distingue una clave ausente de una asociada a `null`.
Versión: Java SE 21
Sintaxis
V get(Object key); // instance method declared by java.util.Map<K, V>
map.get(key) // call with one key argumentEn Java SE 21, Map.get es un método de instancia de java.util.Map<K, V> declarado como V get(Object key). Map.get() es una forma abreviada de nombrarlo, no una sobrecarga sin argumentos: llama a map.get(key). Devuelve el valor almacenado o null si no hay asociación. El contrato de Map describe la coincidencia mediante Objects.equals(key, k), donde k es la clave almacenada. En un HashMap, una instancia de clave distinta pero igual puede encontrar la misma entrada. Las claves iguales según equals deben tener el mismo hashCode. No cambies las propiedades que afectan a la igualdad de una clave mientras esté en el mapa.
Con Map<Integer, Long>, Long total = totals.get(7); recupera un valor calculado previamente sin conversión explícita. El parámetro es de tipo Object, no K. Un Map de tipo crudo, sin argumentos de tipo, devuelve Object. Para asignar ese resultado a una variable de tipo String o Integer, usa una conversión explícita como (String) raw.get(key) o (Integer) raw.get(key). Si el valor es incompatible y distinto de null, la conversión lanza ClassCastException. Prefiere mapas con argumentos de tipo.
Si el mapa admite valores null, get no distingue una clave ausente de una asociada a null. Comprueba su presencia con containsKey(key); si hay cambios concurrentes, las dos llamadas no forman una operación atómica. getOrDefault(key, fallback) devuelve fallback solo si no hay asociación. Según la implementación, un tipo de clave inadecuado puede provocar ClassCastException, y una clave null no permitida puede provocar NullPointerException. Lee los valores true y false por sus claves concretas, sin depender del orden de iteración. El desempaquetado de un resultado null, por ejemplo de Boolean a boolean, lanza NullPointerException.
En un LinkedHashMap con orden de acceso (accessOrder = true en el constructor), encontrar una entrada la mueve al final del orden de iteración, incluso si su valor es null. Si no se encuentra, el orden no cambia. En el modo de orden de inserción, get no cambia el orden.
Si varios hilos escriben resultados, usa, por ejemplo, un ConcurrentHashMap, que no admite claves ni valores null. Cuando el hilo principal vuelve correctamente de join() para cada hilo de trabajo, puede ver sus escrituras. Consulta los resultados por índice de solicitud ascendente para respetar el orden de las solicitudes y no el de finalización. join() no hace seguras las escrituras concurrentes anteriores en un HashMap normal.
Ejemplos
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.Map;
public class MapGetDemo {
record Key(int id) {}
public static void main(String[] args) {
Map<Key, Long> totals = new HashMap<>();
totals.put(new Key(7), 6L * 7);
totals.put(new Key(8), null);
Long total = totals.get(new Key(7));
System.out.println("total: " + total);
for (int id : new int[] {8, 9}) {
Key key = new Key(id);
System.out.println(id + ": " + totals.get(key) + ", present: " + totals.containsKey(key));
}
Map<String, Boolean> flags = Map.of("a", true, "b", false);
System.out.println("flags: " + flags.get("a") + ", " + flags.get("b"));
Map<String, Integer> recent = new LinkedHashMap<>(16, 0.75f, true);
recent.put("a", 1);
recent.put("b", 2);
System.out.println("before: " + recent.keySet());
System.out.println("get a: " + recent.get("a"));
System.out.println("after: " + recent.keySet());
}
}Resultado
total: 42 8: null, present: true 9: null, present: false flags: true, false before: [a, b] get a: 1 after: [b, a]
Un nuevo `Key(7)` encuentra el valor `42`. Para `8` y `9`, `get` devuelve `null`, pero solo está presente `8`. Los indicadores se consultan explícitamente para `a` y luego para `b`. En el último mapa, leer `a` cambia el orden de `[a, b]` a `[b, a]`.
Lecciones relacionadas
- Java · Lección 13 · Avanzado · Versión: 2
- Java · Lección 17 · Avanzado · Versión: 2
- Java · Lección 18 · Avanzado · Versión: 2
- Java · Lección 36 · Avanzado · Versión: 2
- Java · Lección 35 · Básico · Versión: 2
- Java · Lección 42 · Básico · Versión: 2
- Java · Lección 58 · Básico · Versión: 2
- Java · Lección 40 · Intermedio · Versión: 2
- Java · Lección 43 · Intermedio · Versión: 2
Fuentes
- Map (Java SE 21 & JDK 21) — get(Object)
- Map (Java SE 21 & JDK 21) — getOrDefault(Object, V)
- HashMap (Java SE 21 & JDK 21) — get(Object)
- Object (Java SE 21 & JDK 21) — hashCode()
- LinkedHashMap (Java SE 21 & JDK 21)
- ConcurrentHashMap (Java SE 21 & JDK 21) — get(Object)
- Java Language Specification, Java SE 21 — §4.8 Raw Types
- Java Language Specification, Java SE 21 — Chapter 5. Conversions and Contexts
- Java Language Specification, Java SE 21 — §17.4.5 Happens-before Order