CKTIS / Java
Zachování pořadí průchodu pomocí Stream.forEachOrdered
Použij `forEachOrdered`, pokud závěrečná akce musí dodržet pořadí průchodu prvky streamu i při paralelním zpracování. Běžné `forEach` toto pořadí v paralelním režimu nezaručuje.
Verze: Java SE 21
Syntaxe
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);V Java SE 21 vytváří Collection.parallelStream() stream, jehož zdrojem je kolekce. Výchozí implementace jej vytváří v paralelním režimu, ale kontrakt dovoluje vrátit sekvenční stream. Paralelní režim nezaručuje použití více vláken ani zrychlení.
Stream.forEachOrdered(action) je koncová operace s návratovým typem void. Přijímá Consumer<? super T> a provede akci pro každý prvek, který projde až na konec řetězce operací, v pořadí průchodu, pokud je určené. U List jde o pořadí prvků v seznamu a filter zachovává relativní pořadí prvků, které prošly filtrem. Samotný HashSet takové pořadí neurčuje. forEachOrdered prvky netřídí ani neurčuje pořadí tam, kde žádné není.
Koncové akce se provádějí jedna po druhé: akce pro jeden prvek předchází ve smyslu happens-before akcím pro následující prvky. Akce nemusejí běžet ve stejném vlákně a předchozí kroky mohou nadále probíhat paralelně. Záruka platí pro tato volání akcí, nikoli pro nezávislé přístupy jiných vláken ke sdílenému stavu.
Běžné Stream.forEach(action) při paralelním zpracování nezaručuje pořadí průchodu, i když ho konkrétní běh náhodou dodrží. Používej je jen tehdy, když na pořadí akcí nezáleží, a zajisti bezpečný přístup ke sdílenému stavu. U obou metod nesmí akce zasahovat do zdroje streamu. Po koncové operaci stream znovu nepoužívej; pro další průchod vytvoř nový.
Příklady
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());
}
}Výsledek
5 1 3 Count: 3
První řetězec operací vypíše lichá čísla v pořadí ze seznamu: `5`, `1`, `3`, nikoli vzestupně. Druhý používá `forEach` jen pro srovnání: atomicky zvyšuje hodnotu čítače, takže `Count: 3` nezávisí na pořadí akcí. Pokud chceš prvky pouze spočítat, použij `count()` místo sdíleného čítače.
Související lekce
- Java · Lekce 43 · Pokročilá · Verze: 2
- Java · Lekce 57 · Středně pokročilá · Verze: 2