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

Модификатор и тип	Метод	Описание
`default Consumer<T>`	`andThen(Consumer<? super T> after)`	Возвращает составной `Consumer`, который последовательно выполняет эту операцию, а затем операцию `after`.

Подробное описание методов

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.