Интерфейс 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()`	Создает поток, переводя этот построитель в построенное состояние.

Методы, объявленные в интерфейсе 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, 2025, 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/25/docs/api/java.base/java/util/stream/Stream.Builder.html