CKTIS / Java
Stream — pipeline pro zpracování prvků
Stream<T> zpracovává reference na objekty pomocí líné pipeline. Seznamte se s vytvářením streamů, poli výsledků, mapováním na primitivní typy a zárukami pořadí výskytu.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
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> popisuje zpracování prvků, nikoli kolekci, která ukládá data. Pipeline se skládá ze zdroje, mezilehlých operací a terminální operace. Mezilehlé operace jsou líné: zpracování zahájí terminální operace.
Stream.of(T) vytvoří jednoprvkový stream; Stream.of(T... values) vytvoří sekvenční, uspořádaný stream zadaných hodnot. Spotřebovaný stream znovu nepoužívejte; pro další výpočet vytvořte nový. Mapovací funkce by neměly měnit zdroj ani záviset na měnitelném stavu.
Stream.toArray() ukončí pipeline a vrátí Object[]. Přetížení Stream.toArray(String[]::new) vytvoří String[]; nekompatibilní typ prvku způsobí ArrayStoreException. Stream.mapToInt a Stream.mapToLong jsou mezilehlé operace, které vracejí IntStream, respektive LongStream. Jejich metody toArray() vracejí int[], respektive long[], nikoli pole obalových objektů.
Stream.forEachOrdered ukončí pipeline a provede akce v pořadí výskytu, pokud je určeno, a to i při paralelním zpracování. Data netřídí ani nezaručuje, že akce bude provádět jediné vlákno. Naproti tomu paralelní forEach pořadí nezaručuje.
Rozsah dokumentace: Java SE 21; není potvrzeno ani běhové prostředí repozitáře, ani produkční běhové prostředí.
Pří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ýsledek
[sun, moon] [3, 4] [3, 4] sun moon
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.