模块 java.base

包 java.util.stream

接口 Stream.Builder<T>

类型参数：

T - 流元素的类型

所有父级接口：

Consumer<T>

封闭接口：

Stream<T>

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

Stream 的可变构建器。这允许通过单独生成元素并将它们添加到 Builder 来创建 Stream（没有使用 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 - 如果构建器已经转换到构建状态