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

Параметры типа:: T - тип элементов потока

Все суперинтерфейсы:: Consumer<T>

Вложенный интерфейс:: Stream<T>

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

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

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

С:: 1.8
См. также:: Stream.builder()

Методы

Модификатор и тип	Метод	Описание
`void`	`accept(T t)`	Добавляет элемент в строящийся поток.
`default Stream.Builder<T>`	`add(T t)`	Добавляет элемент в строящийся поток.
`Stream<T>`	`build()`	Строит поток, переключая этот билдер в состояние построения.

Методы, объявленные в интерфейсе java.util.function.Consumer

andThen

Методы

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 - если билдер уже перешёл в состояние построения