Интерфейс 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

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`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, 2023, 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/21/docs/api/java.base/java/util/stream/Stream.Builder.html