Интерфейс Stream.Builder<T>

public static interface Stream.Builder<T>
extends Consumer<T>

Изменяемый билдер для Stream. Это позволяет создавать Stream путём генерации элементов по одному и добавлением их в Builder (без накладных расходов на копирование, которые возникают при использовании ArrayList в качестве временного буфера).

У билдера потока есть жизненный цикл, который начинается в фазе построения, в течение которой можно добавлять элементы, а затем переходит в фазу построения, после которой элементы добавлять нельзя. Фаза построения начинается, когда вызывается метод build(), который создаёт упорядоченный Stream элементы которого — это элементы, которые были добавлены в билдер потока в порядке их добавления.

Методы

accept

void accept(T t)

Добавляет элемент в строящийся поток.

Определено в:

accept в интерфейсе Consumer<T>

Параметры:

t - входной аргумент

Исключения:

IllegalStateException - если билдер уже перешел в состояние построения

add

default Stream.Builder<T> add(T t)

Добавляет элемент в строящийся поток.

Требования реализации:

Реализация по умолчанию ведет себя так, как если бы:

accept(t)
     return this;

Параметры:

t - элемент для добавления

Возвращает:

this билдер

Исключения:

IllegalStateException - если билдер уже перешел в состояние построения

build

Stream<T> build()

Строит поток, переводя этот билдер в состояние построения. Если после перехода в состояние построения будут дальнейшие попытки обработать билдер, будет выброшено исключение.

Возвращает:

построенный поток

Исключения:

IllegalStateException - если билдер уже перешел в состояние построения