public interface BaseStream
implements AutoCloseable
| java.util.stream.BaseStream<T, S extends java.util.stream.BaseStream<T, S>> |
 Known Indirect Subclasses
|
流的基本接口，它是支持顺序和并行聚合操作的元素序列。 以下示例说明了使用流类型Stream和IntStream的聚合操作，计算红色小部件的权重总和：
Android开发手册int sum = widgets.stream()
.filter(w -> w.getColor() == RED)
.mapToInt(w -> w.getWeight())
.sum();
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 |