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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.