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.