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

CKTIS / Java

Stream — pipeline na spracovanie prvkov

Stream<T> spracúva referencie na objekty pomocou lenivej pipeline. Spoznajte vytváranie streamov, výsledné polia, mapovanie na primitívne typy a záruky poradia výskytu.

Verzia: Java SE 21; repository runtime, production runtime not attested

Syntax

Stream.of(values).mapToInt(mapper)
Stream.of(values).mapToLong(mapper)
Stream.of(values).toArray()
Stream.of(values).toArray(String[]::new)
Stream.of(values).forEachOrdered(action)

java.util.stream.Stream<T> opisuje spracovanie prvkov, nie kolekciu, ktorá ukladá údaje. Pipeline pozostáva zo zdroja, medzikrokov a terminálnej operácie. Medzikroky sú lenivé: spracovanie spustí terminálna operácia.

Stream.of(T) vytvorí jednoprvkový stream; Stream.of(T... values) vytvorí sekvenčný, usporiadaný stream zadaných hodnôt. Spotrebovaný stream nepoužívajte znova; na ďalší výpočet vytvorte nový. Mapovacie funkcie by nemali meniť zdroj ani závisieť od meniteľného stavu.

Stream.toArray() ukončí pipeline a vráti Object[]. Preťaženie Stream.toArray(String[]::new) vytvorí String[]; nekompatibilný typ prvku spôsobí ArrayStoreException. Stream.mapToInt a Stream.mapToLong sú medzikroky, ktoré vracajú IntStream, respektíve LongStream. Ich metódy toArray() vracajú int[], respektíve long[], nie polia obalových objektov.

Stream.forEachOrdered ukončí pipeline a vykoná akcie v poradí výskytu, ak je určené, a to aj pri paralelnom spracovaní. Údaje netriedi ani nezaručuje, že akcie bude vykonávať jediné vlákno. Paralelný forEach naopak poradie nezaručuje.

Rozsah dokumentácie: Java SE 21; nie je potvrdené ani behové prostredie repozitára, ani produkčné behové prostredie.

Príklady

import java.util.Arrays;
import java.util.stream.Stream;

public class Main {
    public static void main(String[] args) {
        String[] words = Stream.of("sun", "moon").toArray(String[]::new);
        int[] lengths = Stream.of(words).mapToInt(String::length).toArray();
        long[] sizes = Stream.of(words).mapToLong(s -> (long) s.length()).toArray();

        System.out.println(Arrays.toString(words));
        System.out.println(Arrays.toString(lengths));
        System.out.println(Arrays.toString(sizes));
        Stream.of(words).parallel().forEachOrdered(System.out::println);
    }
}

Výsledok

[sun, moon]
[3, 4]
[3, 4]
sun
moon

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje