Module java.base

Package java.util.stream

Interface Stream.Builder<T>

类型参数:

T - 流元素的类型

所有超接口:

Consumer<T>

封闭接口:

Stream<T>

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

一个可变的Stream构建器。这允许通过逐个生成元素并将它们添加到Builder（而不是使用ArrayList作为临时缓冲区带来的复制开销）来创建Stream。

流构建器具有生命周期，它从构建阶段开始，在此阶段可以添加元素，然后过渡到构建完成阶段，此后将无法添加元素。当调用build()方法时，构建完成阶段开始，该方法创建一个有序的Stream，其元素是添加到流构建器中的元素，按照它们被添加的顺序排列。

自版本:

1.8

参见:

• Stream.builder()

Method Summary

Modifier and Type	Method	Description
void	accept(T t)	向正在构建的流添加一个元素。
default Stream.Builder<T>	add(T t)	向正在构建的流添加一个元素。
Stream<T>	build()	构建流，将此构建器转换为构建完成状态。

Methods declared in interface java.util.function.Consumer

andThen

Method Details

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 - 如果构建器已经转换为构建完成状态