CKTIS / Java
Map.forEach : une action pour chaque paire clé-valeur
`Map.forEach` parcourt directement les entrées d’une map. La méthode transmet deux arguments à un `BiConsumer` : d’abord la clé, puis la valeur associée.
Version : Java SE 21
Syntaxe
default void forEach(BiConsumer<? super K, ? super V> action)Map.forEach est une méthode par défaut de l’interface java.util.Map<K, V>, disponible depuis Java 8. Elle prend un BiConsumer<? super K, ? super V> et appelle accept(key, value) pour chaque entrée. L’action peut s’écrire sous la forme d’une lambda (key, value) -> .... Ni l’action ni la méthode ne renvoie de résultat (void).
Map.forEach agit directement sur la map. À l’inverse, Stream.forEach est une opération terminale de flux qui prend un Consumer recevant un argument par élément. Dans map.entrySet().stream().forEach(...), cet argument est un objet Map.Entry, et non deux arguments distincts.
Si la map définit un ordre de parcours, les actions suivent l’ordre d’itération de entrySet(), sauf indication contraire de l’implémentation. Ne supposez pas que toutes les maps préservent l’ordre d’insertion : HashMap ne le garantit pas.
Si l’action lève une exception, le parcours s’arrête et l’exception est propagée à l’appelant. Une action null provoque une NullPointerException. Évitez d’ajouter ou de supprimer des entrées dans l’action : une suppression détectée pendant le parcours peut provoquer une ConcurrentModificationException. L’implémentation par défaut ne garantit ni la synchronisation ni l’atomicité.
Exemples
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));
}
}
Résultat
pear: 3 apple: 5
La lambda reçoit une clé de type `String` et une valeur de type `Integer`. `new LinkedHashMap<>()` préserve l’ordre d’insertion : `pear` s’affiche donc avant `apple`.
Leçons associées
- Java · Leçon 42 · Intermédiaire · Version : 2