База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Stream — конвейери за обработка на елементи

Stream<T> обработва препратки към обекти чрез ленив конвейер. Научете как се създават потоци, получават се резултатни масиви, извършва се преобразуване към примитивни типове и какви гаранции има за реда на срещане.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

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> описва обработката на елементи, а не колекция, която съхранява данни. Конвейерът включва източник, междинни операции и крайна операция. Междинните операции са лениви: обработката започва с крайна операция.

Stream.of(T) създава поток с един елемент; Stream.of(T... values) създава последователен, подреден поток от подадените стойности. Не използвайте повторно изчерпан поток; създайте нов за следващо изчисление. Функциите за преобразуване не бива да променят източника или да зависят от променливо състояние.

Stream.toArray() завършва конвейера и връща Object[]. Претовареният метод Stream.toArray(String[]::new) създава String[]; несъвместим тип на елемент причинява ArrayStoreException. Stream.mapToInt и Stream.mapToLong са междинни операции, които връщат съответно IntStream и LongStream. Техните методи toArray() връщат съответно int[] и long[], а не масиви от обекти-обвивки.

Stream.forEachOrdered завършва конвейера и изпълнява действията в реда на срещане, когато той е определен, включително при паралелна обработка. Методът не сортира данните и не гарантира, че действията ще се изпълняват от една нишка. За разлика от него, паралелният forEach не гарантира реда.

Обхват на документацията: Java SE 21; не е удостоверена нито средата за изпълнение на хранилището, нито производствената среда за изпълнение.

Примери

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);
    }
}

Резултат

[sun, moon]
[3, 4]
[3, 4]
sun
moon

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници