CKTIS / Java
Map.forEach: akcja dla każdej pary klucz–wartość
`Map.forEach` przechodzi bezpośrednio po wpisach mapy. Przekazuje do `BiConsumer` dwa argumenty: najpierw klucz, potem przypisaną mu wartość.
Wersja: Java SE 21
Składnia
default void forEach(BiConsumer<? super K, ? super V> action)Map.forEach to metoda domyślna interfejsu java.util.Map<K, V>, dostępna od Javy 8. Przyjmuje BiConsumer<? super K, ? super V> i dla każdego wpisu wywołuje accept(key, value). Akcję można zapisać jako lambdę (key, value) -> .... Ani akcja, ani metoda nie zwraca wyniku (void).
Map.forEach działa bezpośrednio na mapie. Z kolei Stream.forEach to operacja końcowa strumienia, która przyjmuje Consumer z jednym argumentem na element. W map.entrySet().stream().forEach(...) tym argumentem jest obiekt Map.Entry, a nie dwa osobne argumenty.
Jeśli mapa ma określoną kolejność iteracji, akcje wykonują się w kolejności iteracji po entrySet(), chyba że implementacja stanowi inaczej. Nie zakładaj, że każda mapa zachowuje kolejność wstawiania; HashMap jej nie gwarantuje.
Jeśli akcja rzuci wyjątek, iteracja się kończy, a wyjątek trafia do wywołującego. Akcja równa null powoduje NullPointerException. Unikaj dodawania lub usuwania wpisów w akcji: usunięcie wykryte podczas iteracji może spowodować ConcurrentModificationException. Implementacja domyślna nie gwarantuje synchronizacji ani atomowości.
Przykłady
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));
}
}
Wynik
pear: 3 apple: 5
Lambda otrzymuje klucz typu `String` i wartość typu `Integer`. `new LinkedHashMap<>()` zachowuje kolejność wstawiania, więc `pear` pojawia się przed `apple`.
Powiązane lekcje
- Java · Lekcja 42 · Średniozaawansowany · Wersja: 2