CKTIS / Java
Map.forEach: eine Aktion für jedes Schlüssel-Wert-Paar
`Map.forEach` durchläuft die Einträge einer Map direkt. Die Methode übergibt einem `BiConsumer` zwei Argumente: zuerst den Schlüssel, dann den zugehörigen Wert.
Version: Java SE 21
Syntax
default void forEach(BiConsumer<? super K, ? super V> action)Map.forEach ist eine seit Java 8 verfügbare Default-Methode des Interfaces java.util.Map<K, V>. Sie nimmt einen BiConsumer<? super K, ? super V> entgegen und ruft für jeden Eintrag accept(key, value) auf. Die Aktion lässt sich als Lambda (key, value) -> ... schreiben. Weder die Aktion noch die Methode liefert einen Rückgabewert (void).
Map.forEach arbeitet direkt auf der Map. Stream.forEach ist dagegen eine terminale Stream-Operation, die einen Consumer mit einem Argument pro Element erwartet. Bei map.entrySet().stream().forEach(...) ist dieses Argument ein Map.Entry-Objekt, nicht zwei separate Argumente.
Hat die Map eine festgelegte Iterationsreihenfolge, richten sich die Aktionen nach der Reihenfolge von entrySet(), sofern die Implementierung nichts anderes festlegt. Nicht jede Map erhält die Einfügereihenfolge; HashMap garantiert sie nicht.
Löst die Aktion eine Ausnahme aus, endet der Durchlauf und die Ausnahme wird an den Aufrufer weitergegeben. Wird null als Argument action übergeben, löst Map.forEach eine NullPointerException aus. Vermeide es, in der Aktion Einträge hinzuzufügen oder zu entfernen: Wird während des Durchlaufs eine Entfernung erkannt, kann eine ConcurrentModificationException auftreten. Die Default-Implementierung garantiert weder Synchronisierung noch Atomarität.
Beispiele
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));
}
}
Ergebnis
pear: 3 apple: 5
Das Lambda erhält einen Schlüssel vom Typ `String` und einen Wert vom Typ `Integer`. `new LinkedHashMap<>()` erhält die Einfügereihenfolge, daher erscheint `pear` vor `apple`.
Zugehörige Lektionen
- Java · Lektion 42 · Mittlere Stufe · Version: 2