CKTIS / Java
Stream — potoki przetwarzania elementów
Stream<T> przetwarza referencje do obiektów w leniwym potoku. Poznaj tworzenie strumieni, tablice wynikowe, mapowanie do typów prostych i zachowanie kolejności.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
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 przetwarzanie elementów, a nie kolekcję przechowującą dane. Potok obejmuje źródło, operacje pośrednie i operację kończącą. Operacje pośrednie są leniwe: przetwarzanie rozpoczyna operacja kończąca.
Stream.of(T) tworzy strumień jednoelementowy; Stream.of(T... values) tworzy sekwencyjny, uporządkowany strumień podanych wartości. Nie używaj ponownie zużytego strumienia; dla kolejnego obliczenia utwórz nowy. Funkcje mapujące nie powinny modyfikować źródła ani zależeć od zmiennego stanu.
Stream.toArray() kończy potok, zwracając Object[]. Przeciążenie Stream.toArray(String[]::new) tworzy String[]; niezgodny typ elementu powoduje ArrayStoreException. Stream.mapToInt i Stream.mapToLong są operacjami pośrednimi zwracającymi odpowiednio IntStream i LongStream. Ich toArray() zwraca odpowiednio int[] i long[], nie tablice obiektów opakowujących.
Stream.forEachOrdered kończy potok, wykonując akcje zgodnie z kolejnością napotkania elementów, jeśli jest określona, także przy przetwarzaniu równoległym. Nie sortuje danych ani nie gwarantuje jednego wątku wykonującego akcje. Natomiast równoległe forEach nie gwarantuje kolejności.
Zakres dokumentacji: Java SE 21; środowisko wykonawcze repozytorium, środowisko produkcyjne niepotwierdzone.
Przykłady
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);
}
}Wynik
[sun, moon] [3, 4] [3, 4] sun moon
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.