CKTIS / Java
Map.entrySet(): recorrer pares clave-valor
Usa `entrySet()` cuando necesites tanto la clave como su valor asociado en cada vuelta del bucle. El método devuelve una vista del mapa, no una copia.
Versión: Java SE 21
Sintaxis
Set<Map.Entry<K, V>> entries = map.entrySet();
for (Map.Entry<K, V> entry : entries) {
K key = entry.getKey();
V value = entry.getValue();
}Map.entrySet designa un método de instancia sin argumentos de java.util.Map<K, V>. La notación Map.entrySet() se refiere al mismo método con su lista de argumentos vacía; en el código, llámalo sobre una instancia con map.entrySet(). Devuelve un Set<Map.Entry<K, V>> con una entrada por cada asociación.
Map.Entry<K, V> es una interfaz anidada en Map. En un bucle for mejorado, llama a entry.getKey() para leer la clave de tipo K y a entry.getValue() para leer el valor de tipo V de cada entrada. No hace falta otra consulta con map.get(key). Si solo necesitas las claves, usa keySet(); si solo necesitas los valores, usa values().
El conjunto es una vista vinculada al mapa, no una copia instantánea: los cambios en el mapa se reflejan en la vista y, si se admite la eliminación desde la vista, esta también elimina la asociación del mapa. add y addAll no se admiten. Según el contrato general de Map, modificar el mapa durante el recorrido deja el resultado indefinido, salvo con operaciones admitidas: Iterator.remove() en el iterador en uso o setValue(...) en una entrada devuelta por ese iterador. No dependas del comportamiento de esa entrada después del recorrido.
entrySet() no ordena las entradas por sí mismo. El orden de recorrido depende de la implementación del mapa. En el ejemplo, new TreeMap<>(counts) crea un mapa independiente con las mismas asociaciones, ordenadas según el orden natural de las claves. El bucle recorre la vista de esa copia.
Ejemplos
import java.util.Map;
import java.util.TreeMap;
import java.util.stream.Collectors;
import java.util.stream.Stream;
public class Main {
public static void main(String[] args) {
Map<String, Long> counts = Stream.of("pear", "apple", "plum", "apple", "kiwi", "banana", "pear")
.collect(Collectors.groupingBy(fruit -> fruit, Collectors.counting()));
Map<String, Long> sorted = new TreeMap<>(counts);
for (Map.Entry<String, Long> entry : sorted.entrySet()) {
System.out.println(entry.getKey() + " = " + entry.getValue());
}
}
}
Resultado
apple = 2 banana = 1 kiwi = 1 pear = 2 plum = 1
`collect(...)` cuenta las apariciones de cada nombre de fruta. Solo cuando termina, el código crea la copia `TreeMap` e imprime exactamente cinco líneas, una por clave, en el orden natural de las claves.
Lecciones relacionadas
- Java · Lección 24 · Avanzado · Versión: 2
- Java · Lección 57 · Básico · Versión: 2
- Java · Lección 67 · Básico · Versión: 2
- Java · Lección 39 · Intermedio · Versión: 2