Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Ohranjanje vrstnega reda elementov s Stream.forEachOrdered

Uporabi `forEachOrdered`, kadar mora končno dejanje slediti vrstnemu redu, v katerem tok podaja elemente, tudi pri vzporedni obdelavi. Navadni `forEach` tega v vzporednem načinu ne zagotavlja.

Različica: Java SE 21

Sintaksa

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 Collection.parallelStream() ustvari tok, katerega vir je zbirka. Privzeta izvedba ustvari vzporedni tok, vendar pogodba dovoljuje tudi vrnitev zaporednega toka. Vzporedni način ne zagotavlja uporabe več niti ali hitrejšega izvajanja.

Stream.forEachOrdered(action) je končna operacija z vrnjenim tipom void. Sprejme Consumer<? super T> in izvede dejanje za vsak element, ki pride do konca verige operacij, po vrstnem redu elementov v toku, če je ta določen. Pri List je to vrstni red elementov na seznamu, filter pa ohrani relativni vrstni red elementov, ki prestanejo filter. HashSet sam takega reda ne določa. forEachOrdered elementov ne razvrsti in ne vzpostavi vrstnega reda, če ta ni določen.

Končna dejanja se izvajajo eno za drugim: med dejanjem za posamezen element in dejanji za naslednje elemente velja razmerje happens-before. Dejanja se lahko izvajajo v različnih nitih, predhodne stopnje pa se še vedno lahko izvajajo vzporedno. Jamstvo velja za te klice dejanj, ne za neodvisne dostope drugih niti do skupnega stanja.

Navadni Stream.forEach(action) pri vzporedni obdelavi ne zagotavlja vrstnega reda toka, tudi če ga pri posameznem zagonu po naključju ohrani. Uporabi ga le, ko vrstni red dejanj ni pomemben, in poskrbi za varen dostop do skupnega stanja. Pri obeh metodah dejanje ne sme posegati v vir toka. Po končni operaciji toka ne uporabi znova; za naslednji prehod ustvari nov tok.

Primeri

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

Rezultat

5
1
3
Count: 3

Prva veriga operacij izpiše liha števila v vrstnem redu s seznama: `5`, `1`, `3`, in ne v naraščajočem vrstnem redu. Druga uporablja `forEach` le za primerjavo: atomsko povečuje števec, zato `Count: 3` ni odvisen od vrstnega reda dejanj. Če potrebuješ le število elementov, uporabi `count()` namesto skupnega števca.

Povezane lekcije

  • Java · Lekcija 43 · Napredna · Različica: 2
  • Java · Lekcija 57 · Srednja · Različica: 2

Viri