CKTIS / Java
Arrays.stream(T[]): създаване на поток от масив
Използвай масив с елементи от референтен тип като източник на последователен поток, филтрирай елементите и запази резултата в масив от подходящия тип.
Версия: Java SE 21
Синтаксис
public static <T> Stream<T> stream(T[] array)Arrays.stream(T[]) е статичен метод на java.util.Arrays, наличен от Java 8. Той използва масив с елементи от референтен тип като източник на последователен поток java.util.stream.Stream<T> по реда на индексите. Например от String[] се получава Stream<String>. Методът не копира изходния масив. Подаването на null вместо референция към масив предизвиква NullPointerException.
Междинни операции като filter се изпълняват отложено: обработката започва при извикване на крайна операция като toArray(). Не променяй изходния масив по време на обработката. Не използвай отново същия поток след крайна операция. За повторна обработка на масива създай нов поток.
Претовареният вариант с диапазон, Arrays.stream(array, startInclusive, endExclusive), включва началния индекс, но изключва крайния. Трябва да е изпълнено 0 <= startInclusive <= endExclusive <= array.length; невалидните граници предизвикват ArrayIndexOutOfBoundsException. Вариантите за int[], long[] и double[] връщат съответно IntStream, LongStream и DoubleStream. За други едномерни масиви от примитивни типове, например boolean[], няма пряк вариант.
При Stream<T> декларираният тип на резултата от метода toArray() без аргументи е Object[], но Java SE 21 не определя точния клас на върнатия масив по време на изпълнение. Не привеждай резултата към String[]. Ако ти трябва String[], използвай toArray(String[]::new) върху поток от низове.
При използване на рефлексия можеш да подадеш получения Object[] на Constructor.newInstance(Object...). Елементите му стават поредните аргументи на избрания конструктор. Броят, редът и типовете им трябва да съответстват на параметрите на конструктора, като се отчитат позволените преобразувания. Неправилен брой аргументи или несъвместим тип предизвиква IllegalArgumentException.
Примери
import java.util.Arrays;
public class Main {
public record Pair(String first, String second) {}
public static void main(String[] args) throws ReflectiveOperationException {
String[] input = {"Ada", " ", "Lin"};
Object[] arguments = Arrays.stream(input)
.filter(name -> !name.isBlank())
.toArray();
Pair pair = Pair.class.getConstructor(String.class, String.class)
.newInstance(arguments);
System.out.println(Arrays.toString(arguments));
System.out.println(pair.first() + " / " + pair.second());
}
}Резултат
[Ada, Lin] Ada / Lin
`filter` отхвърля низа, който съдържа само един интервал. `toArray()` поставя `Ada` и `Lin` в `Object[]` в този ред, а `newInstance` ги подава като два аргумента на конструктора на `Pair`.
Свързани уроци
- Java · Урок 59 · Напреднало · Версия: 2
- Java · Урок 63 · Начално · Версия: 2