public interface BaseStream
implements AutoCloseable
java.util.stream.BaseStream<T, S extends java.util.stream.BaseStream<T, S>> |
Known Indirect Subclasses |
流的基本接口,它是支持顺序和并行聚合操作的元素序列。 以下示例说明了使用流类型Stream
和IntStream
的聚合操作,计算红色小部件的权重总和:
int sum = widgets.stream()
.filter(w -> w.getColor() == RED)
.mapToInt(w -> w.getWeight())
.sum();
See the class documentation for
Stream
and the package documentation for
java.util.stream for additional specification of streams, stream operations, stream pipelines, and parallelism, which governs the behavior of all stream types.
Public methods |
|
---|---|
abstract void |
close() 关闭此流,导致调用此流管道的所有关闭处理程序。 |
abstract boolean |
isParallel() 返回此流是否将执行终端操作,并行执行。 |
abstract Iterator<T> |
iterator() 返回此流的元素的迭代器。 |
abstract S |
onClose(Runnable closeHandler) 使用附加的关闭处理程序返回等效流。 |
abstract S |
parallel() 返回平行的等效流。 |
abstract S |
sequential() 返回顺序的等效流。 |
abstract Spliterator<T> |
spliterator() 返回此流的元素的分割器。 |
abstract S |
unordered() 返回 unordered的等效流。 |
Inherited methods |
|
---|---|
From interface java.lang.AutoCloseable
|
boolean isParallel ()
返回此流是否将执行终端操作,并行执行。 调用终端流操作方法后调用此方法可能会产生不可预知的结果。
Returns | |
---|---|
boolean |
true if this stream would execute in parallel if executed |
Iterator<T> iterator ()
返回此流的元素的迭代器。
这是一个 terminal operation 。
Returns | |
---|---|
Iterator<T> |
the element iterator for this stream |
S onClose (Runnable closeHandler)
使用附加的关闭处理程序返回等效流。 在流上调用close()
方法时会运行关闭处理程序,并按照它们添加的顺序执行。 即使先前的关闭处理程序抛出异常,也会运行所有关闭处理程序。 如果任何关闭处理程序抛出异常,则将抛出的第一个异常中继给调用者close()
,并将任何其余异常添加到该异常中作为抑制异常(除非其中一个异常与第一个异常是相同的异常,异常无法压制自己。)可能会返回自己。
这是一个 intermediate operation 。
Parameters | |
---|---|
closeHandler |
Runnable : A task to execute when the stream is closed |
Returns | |
---|---|
S |
a stream with a handler that is run if the stream is closed |
S parallel ()
返回平行的等效流。 可能会返回自己,因为流已经是平行的,或者因为基础流状态被修改为平行。
这是一个 intermediate operation 。
Returns | |
---|---|
S |
a parallel stream |
S sequential ()
返回顺序的等效流。 可能会返回自己,因为流已经是顺序的,或者因为基础流状态被修改为顺序的。
这是一个 intermediate operation 。
Returns | |
---|---|
S |
a sequential stream |
Spliterator<T> spliterator ()
返回此流的元素的分割器。
这是一个 terminal operation 。
Returns | |
---|---|
Spliterator<T> |
the element spliterator for this stream |
S unordered ()
返回unordered的等效流。 可能会返回自己,因为流已经无序,或者因为基础流状态被修改为无序。
这是一个 intermediate operation 。
Returns | |
---|---|
S |
an unordered stream |