Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje