CKTIS / Java
Stream — pipelines voor elementverwerking
Stream<T> verwerkt objectverwijzingen via een lazy pipeline. Leer streams maken, resultaatarrays verkrijgen, naar primitieve typen mappen en welke garanties gelden voor de encounter order.
Versie: 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> beschrijft de verwerking van elementen, niet een collectie die gegevens opslaat. Een pipeline bestaat uit een bron, tussenbewerkingen en een terminale bewerking. Tussenbewerkingen zijn lazy: de terminale bewerking start de verwerking.
Stream.of(T) maakt een stream met één element; Stream.of(T... values) maakt een sequentiële, geordende stream van de opgegeven waarden. Gebruik een verbruikte stream niet opnieuw; maak voor een nieuwe berekening een nieuwe stream. Mapfuncties horen de bron niet te wijzigen en niet afhankelijk te zijn van veranderlijke toestand.
Stream.toArray() beëindigt de pipeline en retourneert Object[]. De overload Stream.toArray(String[]::new) maakt een String[]; een incompatibel elementtype veroorzaakt ArrayStoreException. Stream.mapToInt en Stream.mapToLong zijn tussenbewerkingen die respectievelijk IntStream en LongStream retourneren. Hun toArray()-methoden retourneren respectievelijk int[] en long[], geen arrays van wrapper-objecten.
Stream.forEachOrdered beëindigt de pipeline en voert acties uit in de encounter order, als die is gedefinieerd, ook tijdens parallelle verwerking. De methode sorteert de gegevens niet en garandeert niet dat één thread de acties uitvoert. Parallel forEach garandeert daarentegen geen volgorde.
Documentatiebereik: Java SE 21; noch de runtimeomgeving van de repository, noch die van productie is bevestigd.
Voorbeelden
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);
}
}Resultaat
[sun, moon] [3, 4] [3, 4] sun moon
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.