Интерфейс 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, если будут дальнейшие попытки операций с билдером после того, как он перейдет в состояние построения.

Возвращает:: построенный поток
Исключения:: IllegalStateException - если билдер уже перешел в состояние построения

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/stream/Stream.Builder.html