Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła