CKTIS / Java
Map.forEach: uma ação por cada par chave-valor
`Map.forEach` percorre diretamente as entradas de um mapa. Passa dois argumentos a um `BiConsumer`: primeiro a chave, depois o valor associado.
Versão: Java SE 21
Sintaxe
default void forEach(BiConsumer<? super K, ? super V> action)Map.forEach é um método predefinido da interface java.util.Map<K, V>, disponível desde o Java 8. Recebe um BiConsumer<? super K, ? super V> e chama accept(key, value) para cada entrada. Podes escrever a ação como uma expressão lambda (key, value) -> .... Nem a ação nem o método devolvem um resultado (void).
Map.forEach opera diretamente sobre o mapa. Já Stream.forEach é uma operação terminal de um fluxo que recebe um Consumer com um argumento por elemento. Em map.entrySet().stream().forEach(...), esse argumento é um objeto Map.Entry, não dois argumentos separados.
Se o mapa tiver uma ordem de iteração definida, as ações seguem a ordem de iteração de entrySet(), salvo indicação em contrário da implementação. Não assumas que todos os mapas mantêm a ordem de inserção: HashMap não a garante.
Se a ação lançar uma exceção, a iteração termina e a exceção propaga-se para o código que chamou o método. Uma ação null provoca uma NullPointerException. Evita adicionar ou remover entradas dentro da ação: uma remoção detetada durante a iteração pode provocar uma ConcurrentModificationException. A implementação predefinida não garante sincronização nem atomicidade.
Exemplos
import java.util.LinkedHashMap;
import java.util.Map;
public class Main {
public static void main(String[] args) {
Map<String, Integer> stock = new LinkedHashMap<>();
stock.put("pear", 3);
stock.put("apple", 5);
stock.forEach((key, value) -> System.out.println(key + ": " + value));
}
}
Resultado
pear: 3 apple: 5
A expressão lambda recebe uma chave do tipo `String` e um valor do tipo `Integer`. `new LinkedHashMap<>()` mantém a ordem de inserção, pelo que `pear` aparece antes de `apple`.
Lições relacionadas
- Java · Lição 42 · Intermédio · Versão: 2