Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła