CKTIS / Java
Kolejność napotykania w strumieniu równoległym: forEachOrdered
Użyj `forEachOrdered`, gdy działanie końcowe ma zachować kolejność napotykania elementów strumienia, także w potoku równoległym. Zwykłe `forEach` nie daje tej gwarancji w trybie równoległym.
Wersja: Java SE 21
Składnia
java.util.Collection<E>: default Stream<E> parallelStream()
java.util.stream.Stream<T>: void forEachOrdered(Consumer<? super T> action)
Contrast on java.util.stream.Stream<T>: void forEach(Consumer<? super T> action)
collection.parallelStream().forEachOrdered(action);W Java SE 21 Collection.parallelStream() tworzy strumień, którego źródłem jest kolekcja. Implementacja domyślna tworzy strumień w trybie równoległym, ale kontrakt dopuszcza zwrócenie strumienia sekwencyjnego. Tryb równoległy nie gwarantuje użycia wielu wątków ani przyspieszenia.
Stream.forEachOrdered(action) to operacja końcowa zwracająca void. Przyjmuje Consumer<? super T> i wykonuje działanie dla każdego elementu docierającego do końca potoku, zgodnie z kolejnością napotykania, jeśli jest ona określona. Dla List jest to kolejność elementów listy, a filter zachowuje względną kolejność pozostałych elementów. HashSet sam nie określa takiej kolejności. forEachOrdered nie sortuje elementów ani nie ustanawia kolejności, jeśli jej nie ma.
Działania końcowe są wykonywane pojedynczo: działanie dla jednego elementu pozostaje w relacji happens-before względem działań dla następnych elementów. Działania nie muszą być wykonywane w tym samym wątku, a wcześniejsze etapy potoku nadal mogą działać równolegle. Gwarancja dotyczy wywołań tego działania, a nie niezależnych operacji innych wątków na współdzielonym stanie.
Zwykłe Stream.forEach(action) nie gwarantuje kolejności napotykania w potoku równoległym, nawet jeśli w konkretnym uruchomieniu ją zachowa. Używaj go tylko wtedy, gdy kolejność działań nie ma znaczenia, i zapewnij bezpieczny dostęp do stanu współdzielonego. W obu metodach działanie nie może ingerować w źródło strumienia. Po operacji końcowej nie używaj ponownie tego samego strumienia; do kolejnego przebiegu utwórz nowy.
Przykłady
import java.util.List;
import java.util.concurrent.atomic.AtomicInteger;
public class Main {
public static void main(String[] args) {
List<Integer> numbers = List.of(5, 2, 1, 4, 3);
numbers.parallelStream()
.filter(n -> n % 2 != 0)
.forEachOrdered(System.out::println);
AtomicInteger matches = new AtomicInteger();
numbers.parallelStream()
.filter(n -> n % 2 != 0)
.forEach(n -> matches.incrementAndGet());
System.out.println("Count: " + matches.get());
}
}Wynik
5 1 3 Count: 3
Pierwszy potok wypisuje liczby nieparzyste w kolejności z listy: `5`, `1`, `3`, a nie w kolejności rosnącej. Drugi potok używa `forEach` tylko dla kontrastu: atomowo zwiększa licznik, więc wynik `Count: 3` nie zależy od kolejności działań. Jeśli chodzi wyłącznie o zliczanie, użyj `count()` zamiast współdzielonego licznika.
Powiązane lekcje
- Java · Lekcja 43 · Zaawansowany · Wersja: 2
- Java · Lekcja 57 · Średniozaawansowany · Wersja: 2