CKTIS / Java
Stream — Pipelines zur Verarbeitung von Elementen
Stream<T> verarbeitet Objektreferenzen in einer verzögerten Pipeline. Lerne, wie Streams erstellt werden, Ergebnisarrays entstehen, auf primitive Typen abgebildet wird und welche Garantien für die Begegnungsreihenfolge gelten.
Version: 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> beschreibt die Verarbeitung von Elementen und ist keine Sammlung, die Daten speichert. Eine Pipeline besteht aus einer Quelle, Zwischenoperationen und einer terminalen Operation. Zwischenoperationen sind verzögert: Erst eine terminale Operation startet die Verarbeitung.
Stream.of(T) erstellt einen Stream mit einem Element; Stream.of(T... values) erstellt einen sequenziellen, geordneten Stream der übergebenen Werte. Einen verbrauchten Stream darfst du nicht wiederverwenden; erstelle für eine weitere Berechnung einen neuen. Mapping-Funktionen sollten weder die Quelle verändern noch von veränderlichem Zustand abhängen.
Stream.toArray() beendet die Pipeline und gibt Object[] zurück. Die Überladung Stream.toArray(String[]::new) erstellt ein String[]; ein inkompatibler Elementtyp verursacht ArrayStoreException. Stream.mapToInt und Stream.mapToLong sind Zwischenoperationen und liefern jeweils IntStream und LongStream. Deren toArray()-Methoden geben int[] beziehungsweise long[] zurück, keine Arrays von Wrapper-Objekten.
Stream.forEachOrdered beendet die Pipeline und führt Aktionen in der Begegnungsreihenfolge aus, sofern diese festgelegt ist, auch bei paralleler Verarbeitung. Die Methode sortiert die Daten nicht und garantiert auch keinen einzelnen Thread für die Aktionen. Paralleles forEach hingegen garantiert keine Reihenfolge.
Die Dokumentation bezieht sich auf Java SE 21. Das Repository verwendet Java SE 21 als Laufzeitumgebung; die Laufzeitumgebung in Produktion ist nicht bestätigt.
Beispiele
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);
}
}Ergebnis
[sun, moon] [3, 4] [3, 4] sun moon
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.