База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Запазване на реда на обхождане със Stream.forEachOrdered

Използвай `forEachOrdered`, когато крайното действие трябва да следва реда на обхождане на елементите в потока, дори при паралелна обработка. Обикновеният `forEach` не дава тази гаранция в паралелен режим.

Версия: Java SE 21

Синтаксис

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);

В Java SE 21 Collection.parallelStream() създава поток, чийто източник е колекцията. Реализацията по подразбиране го създава в паралелен режим, но договорът на метода допуска да се върне последователен поток. Паралелният режим не гарантира използване на няколко нишки или по-бързо изпълнение.

Stream.forEachOrdered(action) е крайна операция с тип на връщане void. Тя приема Consumer<? super T> и изпълнява действието за всеки елемент, достигнал края на веригата от операции, като спазва реда на обхождане, ако е определен. При List това е редът на елементите в списъка, а filter запазва относителния ред на преминалите филтъра елементи. Един HashSet сам по себе си не определя такъв ред. forEachOrdered не сортира елементите и не задава ред, ако няма такъв.

Крайните действия се изпълняват едно по едно: между действието за даден елемент и действията за следващите елементи има връзка happens-before. Действията може да се изпълняват в различни нишки, а предходните етапи могат да продължат да работят паралелно. Гаранцията важи за тези извиквания, а не за независим достъп на други нишки до споделено състояние.

Обикновеният Stream.forEach(action) не гарантира реда на обхождане при паралелна обработка, дори ако при някое изпълнение случайно го спази. Използвай го само когато редът на действията няма значение, и осигури безопасен достъп до споделеното състояние. И при двата метода действието не трябва да се намесва в работата на източника на потока. Не използвай повторно потока след крайна операция; създай нов поток за следващо обхождане.

Примери

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());
    }
}

Резултат

5
1
3
Count: 3

Първата верига от операции отпечатва нечетните числа в реда от списъка: `5`, `1`, `3`, а не във възходящ ред. Втората използва `forEach` само за сравнение: увеличава атомарно брояч, така че `Count: 3` не зависи от реда на действията. Ако ти трябва само броят на елементите, използвай `count()` вместо споделен брояч.

Свързани уроци

  • Java · Урок 43 · Напреднало · Версия: 2
  • Java · Урок 57 · Средно · Версия: 2

Източници