Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Zachovanie poradia prechodu pomocou Stream.forEachOrdered

Použi `forEachOrdered`, ak má koncová akcia dodržať poradie prechodu prvkami streamu aj pri paralelnom spracovaní. Bežné `forEach` v paralelnom režime toto poradie nezaručuje.

Verzia: Java SE 21

Syntax

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ára Collection.parallelStream() stream, ktorého zdrojom je kolekcia. Predvolená implementácia ho vytvára v paralelnom režime, no kontrakt umožňuje vrátiť sekvenčný stream. Paralelný režim nezaručuje použitie viacerých vlákien ani zrýchlenie.

Stream.forEachOrdered(action) je koncová operácia s návratovým typom void. Prijíma Consumer<? super T> a vykoná akciu pre každý prvok, ktorý prejde až na koniec reťazca operácií, v poradí prechodu, ak je určené. Pri List ide o poradie prvkov v zozname a filter zachováva relatívne poradie prvkov, ktoré filtrom prešli. Samotný HashSet takéto poradie neurčuje. forEachOrdered prvky netriedi ani neurčuje poradie tam, kde žiadne nie je.

Koncové akcie sa vykonávajú po jednej: akcia pre jeden prvok predchádza v zmysle happens-before akciám pre nasledujúce prvky. Akcie nemusia bežať v tom istom vlákne a predchádzajúce kroky môžu naďalej prebiehať paralelne. Záruka sa vzťahuje na tieto volania akcií, nie na nezávislé prístupy iných vlákien k zdieľanému stavu.

Bežné Stream.forEach(action) pri paralelnom spracovaní nezaručuje poradie prechodu, aj keď ho pri konkrétnom spustení náhodou dodrží. Použi ho len vtedy, keď na poradí akcií nezáleží, a zaisti bezpečný prístup k zdieľanému stavu. Pri oboch metódach nesmie akcia zasahovať do zdroja streamu. Po koncovej operácii stream nepoužívaj znova; na ďalší prechod vytvor nový.

Prí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ýsledok

5
1
3
Count: 3

Prvý reťazec operácií vypíše nepárne čísla v poradí zo zoznamu: `5`, `1`, `3`, nie vzostupne. Druhý používa `forEach` len na porovnanie: atomicky zvyšuje hodnotu počítadla, takže `Count: 3` nezávisí od poradia akcií. Ak chceš prvky iba spočítať, použi `count()` namiesto zdieľaného počítadla.

Súvisiace lekcie

  • Java · Lekcia 43 · Pokročilá · Verzia: 2
  • Java · Lekcia 57 · Stredne pokročilá · Verzia: 2

Zdroje