java8新特新：接口流-Stream()接口和所有方法（map,foreach,filter,count,distinct,limit,collect,skip,sorted)

Steam 

接口流

• 类型参数：

  T  - 流元素的类型

  所有超级接口：

  AutoCloseable ， BaseStream   Stream  >

  ---

  
  

  公共接口Stream  
  扩展BaseStream Stream >

  支持顺序和并行聚合操作的一系列元素。以下示例说明使用 Stream and 的聚合操作  IntStream ：

  
       int sum = widgets.stream()
                        .filter(w -> w.getColor() == RED)
                        .mapToInt(w -> w.getWeight())
                        .sum();
   

  在这个例子中， widgets 是一个 Collection 。我们通过创建一个 Widget 对象流 Collection.stream() ，对其进行过滤以产生只包含红色小部件的流，然后将其转换为 int 代表每个红色小部件权重的值流。然后将这个流加起来产生总重量。

  除了Stream，这是对象引用的流，存在用于原始特IntStream，LongStream以及DoubleStream，所有这些都称为“流”和符合此处描述的特征和限制。

  为了执行计算，流 操作被组成 流管道。一个流管道由一个源（可能是一个数组，一个集合，一个生成器函数，一个I / O通道等），零个或多个中间操作（将流转换成另一个流等filter(Predicate)） 终端操作（产生结果或副作用，如count()or forEach(Consumer)）。流是懒惰的; 源数据的计算仅在终端操作启动时执行，而源元素仅在需要时消耗。

  收藏和流媒体虽然有一些肤浅的相似之处，却有着不同的目标。收藏主要关心对元素的有效管理和访问。相比之下，流不提供直接访问或操作元素的手段，而是关注于声明性地描述它们的来源以及将在该来源上进行的计算操作。然而，如果提供的流的操作不提供所期望的功能性，BaseStream.iterator()并且BaseStream.spliterator()操作可用于执行受控的遍历。

  流管道，就像上面的“小部件”示例一样，可以被视为流源上的查询。除非源代码被明确设计用于并发修改（如a ConcurrentHashMap），否则在查询流源时修改流源可能会导致不可预知或错误的行为。

  大多数流操作接受描述用户指定行为的参数，例如上例中w -> w.getWeight()传递给 的lambda表达式mapToInt。为了保持正确的行为，这些行为参数：

  • 必须是无干扰的 （他们不会修改流源）; 和
  • 在大多数情况下，它们必须是无状态的 （它们的结果不应该依赖于在流管道执行期间可能会改变的任何状态）。

  这样的参数总是一个实例 功能接口如Function，也常常lambda表达式或方法的引用。除非另有规定，否则这些参数必须 是非空的。

  应该只对一个数据流进行操作（调用中间或终端流操作）一次。这排除了例如“分叉”流，其中相同的源馈送两个或更多个管线，或者多个遍历相同的流。如果流IllegalStateException 检测到流正在被重用，可能会抛出流。然而，由于一些流操作可能返回它们的接收者而不是新的流对象，所以在所有情况下可能无法检测到重用。

  流有一个BaseStream.close()方法和实现AutoCloseable，但几乎所有的流实例实际上并不需要在使用后关闭。一般来说，只有来源是IO通道的流（例如返回的流Files.lines(Path, Charset)）需要关闭。大多数流都由集合，数组或者生成函数来支持，而不需要特殊的资源管理。（如果流确实需要关闭，则可以在try-with-resources语句中将其声明为资源。）

  流管线可以按顺序或并行执行 。这个执行模式是流的一个属性。流是通过顺序或并行执行的初始选择创建的。（例如， Collection.stream()创建一个顺序流，并Collection.parallelStream()创建一个并行流。）执行模式的这种选择可以由BaseStream.sequential()or BaseStream.parallel()方法修改 ，并且可以用该BaseStream.isParallel()方法查询。

  以来：

  1.8

  也可以看看：

  IntStream ，  LongStream ，  DoubleStream ，  java.util.stream

• • 嵌套类摘要

    嵌套类

    修饰符和类型	界面和说明
    static interface	Stream.Builder 一个可变的建设者 Stream 。

  • 方法摘要

    所有方法 静态方法 实例方法 抽象方法 默认方法

    修饰符和类型	方法和描述
    boolean	allMatch(Predicate predicate) 返回此流的所有元素是否与提供的谓词匹配。
    boolean	anyMatch(Predicate predicate) 返回此流的任何元素是否与提供的谓词匹配。
    static  Stream.Builder	builder() 返回一个生成器 Stream 。
    R	collect(Collector collector) 使用a对此流的元素执行 可变减少 操作  Collector 。
    R	collect(Supplier supplier, BiConsumer accumulator, BiConsumer combiner) 对此流的元素执行 可变减少 操作。
    static  Stream	concat(Stream a, Stream b) 创建一个延迟连接的流，其元素是第一个流的所有元素，后跟第二个流的所有元素。
    long	count() 返回此流中元素的数量。
    Stream	distinct() 返回 Object.equals(Object) 由此流的不同元素（根据 ）组成的流。
    static  Stream	empty() 返回一个空的顺序 Stream 。
    Stream	filter(Predicate predicate) 返回由此流的元素组成的流，该流匹配给定的谓词。
    Optional	findAny() 返回 Optional 描述流的某个元素， Optional 如果流为空，则返回一个空元素。
    Optional	findFirst() 返回 Optional 描述此流的第一个元素， Optional 如果流为空，则返回空。
    Stream	flatMap(Function> mapper) 返回一个流，该流包含将此流的每个元素替换为通过将所提供的映射函数应用于每个元素而生成的映射流的内容的结果。
    DoubleStream	flatMapToDouble(Function mapper) 返回一个 DoubleStream 包含将此流的每个元素替换为通过将所提供的映射函数应用于每个元素而生成的映射流的内容的结果。
    IntStream	flatMapToInt(Function mapper) 返回一个 IntStream 包含将此流的每个元素替换为通过将所提供的映射函数应用于每个元素而生成的映射流的内容的结果。
    LongStream	flatMapToLong(Function mapper) 返回一个 LongStream 包含将此流的每个元素替换为通过将所提供的映射函数应用于每个元素而生成的映射流的内容的结果。
    void	forEach(Consumer action) 对此流的每个元素执行操作。
    void	forEachOrdered(Consumer action) 为流的每个元素执行操作，如果流具有已定义的遇到顺序，则按流的遇到顺序执行操作。
    static  Stream	generate(Supplier s) 返回无限顺序无序流，其中每个元素由提供的生成 Supplier 。
    static  Stream	iterate(T seed, UnaryOperator f) 返回一个无限连续有序 Stream 通过函数的迭代应用产生 f 为初始元素 seed ，产生 Stream 包括 seed ， f(seed) ，  f(f(seed)) ，等。
    Stream	limit(long maxSize) 返回由此流的元素组成的流，截断的 maxSize 长度不得超过。
    Stream	map(Function mapper) 返回由将给定函数应用于此流的元素的结果组成的流。
    DoubleStream	mapToDouble(ToDoubleFunction mapper) 返回 DoubleStream 由给定函数应用于此流的元素的结果组成的结果。
    IntStream	mapToInt(ToIntFunction mapper) 返回 IntStream 由将给定函数应用于此流的元素的结果组成的结果。
    LongStream	mapToLong(ToLongFunction mapper) 返回 LongStream 由给定函数应用于此流的元素的结果组成的结果。
    Optional	max(Comparator comparator) 根据提供的内容返回此流的最大元素  Comparator 。
    Optional	min(Comparator comparator) 根据提供的返回此流的最小元素  Comparator 。
    boolean	noneMatch(Predicate predicate) 返回此流的元素是否与提供的谓词匹配。
    static  Stream	of(T... values) 返回一个顺序排列的流，其元素是指定的值。
    static  Stream	of(T t) 返回 Stream 包含单个元素的顺序。
    Stream	peek(Consumer action) 返回由此流的元素组成的流，另外对每个元素执行提供的操作，因为元素将从结果流中消耗。
    Optional	reduce(BinaryOperator accumulator) 使用关联累积函数执行此流的元素  缩减 ，并返回描述缩小的值（如果有的话）。 Optional
    T	reduce(T identity, BinaryOperator accumulator) 使用提供的标识值和关联 累积函数执行此流的元素  缩减 ，并返回缩小的值。
    U	reduce(U identity, BiFunction accumulator, BinaryOperator combiner) 使用提供的身份，积累和组合功能，执行此流的元素 缩减 。
    Stream	skip(long n) 丢弃流的第一个 n 元素后，返回包含此流的其余元素的流。
    Stream	sorted() 返回由此流的元素组成的流，按照自然顺序排序。
    Stream	sorted(Comparator comparator) 返回由该流的元素组成的流，按照提供的顺序进行排序 Comparator 。
    Object[]	toArray() 返回包含此流的元素的数组。
    A[]	toArray(IntFunction generator) 返回包含此流的元素的数组，使用提供的 generator 函数分配返回的数组，以及分区执行或调整大小时可能需要的其他数组。

    • 从接口java.util.stream继承的方法 BaseStream

      close, isParallel, iterator, onClose, parallel, sequential, spliterator, unordered

• • 方法细节

    • filter

      Stream filter(Predicate predicate)
      

      返回由此流的元素组成的流，该流匹配给定的谓词。

      这是一个中间操作。

      参数：

      predicate - 适用于每个元素的 非干扰 ，  无状态 谓词，以确定是否应该包含它

      返回：

      新的流

    • map

       Stream map(Function mapper)
      

      返回由将给定函数应用于此流的元素的结果组成的流。

      这是一个中间操作。

      类型参数：

      R  - 新流的元素类型

      参数：

      mapper -一个 无干扰 ，  无状态的  功能应用到每个元素

      返回：

      新的流

    • mapToInt

      IntStream  mapToInt（ToIntFunction <？super T > mapper）

      返回 IntStream 由将给定函数应用于此流的元素的结果组成的结果。

      这是一个 中间操作。

      参数：

      mapper -一个 无干扰 ，  无状态的  功能应用到每个元素

      返回：

      新的流

    • mapToLong

      LongStream  mapToLong（ToLongFunction <？super T > mapper）

      返回 LongStream 由给定函数应用于此流的元素的结果组成的结果。

      这是一个中间操作。

      参数：

      mapper -一个 无干扰 ，  无状态的  功能应用到每个元素

      返回：

      新的流

    • mapToDouble

      DoubleStream  mapToDouble（ToDoubleFunction <？super T > mapper）

      返回 DoubleStream 由给定函数应用于此流的元素的结果组成的结果。

      这是一个中间操作。

      参数：

      mapper -一个 无干扰 ，  无状态的  功能应用到每个元素

      返回：

      新的流

    • flatMap

       Stream flatMap(Function> mapper)
      

      返回一个流，该流包含将此流的每个元素替换为通过将所提供的映射函数应用于每个元素而生成的映射流的内容的结果。每个映射的流都是  closed 在其内容被放入这个流之后。（如果使用映射的流是 null  一个空的流，则改为）。

      这是一个中间操作。

      API注意：

      该 flatMap() 操作具有对流的元素应用一对多转换，然后将所得元素平坦化为新流的效果。

      例子。

      如果orders是采购订单流，并且每个采购订单都包含一系列行项目，则以下内容会生成包含所有订单中的所有行项目的流：

      
           orders.flatMap(order -> order.getLineItems().stream())...
       

      如果path是文件的路径，则以下内容将生成words包含在该文件中的一个流：

      
           Stream lines = Files.lines(path, StandardCharsets.UTF_8);
           Stream words = lines.flatMap(line -> Stream.of(line.split(" +")));
       

      mapper 传递 的函数 flatMap 使用一个简单的正则表达式将行分割成一个单词数组，然后从该数组创建一个单词流。

      类型参数：

      R  - 新流的元素类型

      参数：

      mapper -一个 非干扰 ，  无状态  功能应用到其产生新的值的流的每个元素

      返回：

      新的流

    • flatMapToInt

      IntStream  flatMapToInt（Function <？super T，？extends IntStream > mapper）

      返回一个 IntStream 包含将此流的每个元素替换为通过将所提供的映射函数应用于每个元素而生成的映射流的内容的结果。每个映射的流都是 closed 在其内容被放入这个流之后。（如果使用映射的流是  null 一个空的流，则改为）。

      这是一个中间操作。

      参数：

      mapper -一个 非干扰 ，  无状态  功能应用到其产生新的值的流的每个元素

      返回：

      新的流

      也可以看看：

      flatMap(Function)

    • flatMapToLong

      LongStream  flatMapToLong（Function <？super T，？extends LongStream > mapper）

      返回一个 LongStream 包含将此流的每个元素替换为通过将所提供的映射函数应用于每个元素而生成的映射流的内容的结果。每个映射的流都是 closed 在其内容被放入这个流之后。（如果使用映射的流是  null 一个空的流，则改为）。

      这是一个中间操作。

      参数：

      mapper -一个 非干扰 ，  无状态  功能应用到其产生新的值的流的每个元素

      返回：

      新的流

      也可以看看：

      flatMap(Function)

    • flatMapToDouble

      DoubleStream  flatMapToDouble（Function <？super T，？extends DoubleStream > mapper）

      返回一个 DoubleStream 包含将此流的每个元素替换为通过将所提供的映射函数应用于每个元素而生成的映射流的内容的结果。每个映射的流都是 closed 在其内容已被放入该流之后。（如果使用映射的流是  null 一个空的流，则改为）。

      这是一个中间操作。

      参数：

      mapper -一个 非干扰 ，  无状态  功能应用到其产生新的值的流的每个元素

      返回：

      新的流

      也可以看看：

      flatMap(Function)

    • distinct

      Stream < T > distinct（）

      返回 Object.equals(Object) 由此流的不同元素（根据 ）组成的流。

      对于有序流，选择不同的元素是稳定的（对于重复的元素，保持在遇到顺序中首先出现的元素）。对于无序流，没有稳定性保证。

      这是一个有状态的中间操作。

      API注意：

      distinct() 在并行管道中保持稳定性是相对昂贵的（要求操作充当完全屏障，具有大量的缓冲开销），并且通常不需要稳定性。如果您的情况的语义允许，使用无序的流源（如 generate(Supplier) ）或删除排序约束 BaseStream.unordered() 可能会导致 distinct() 在并行管道中显着更高效的执行。如果要求与遇到命令的一致性，并且 distinct() 在并行管道中遇到性能不佳或内存利用率较低的问题，则切换到顺序执行 BaseStream.sequential() 可能会提高性能。

      返回：

      新的流

    • sorted

      Stream < T > sorted（）

      返回由此流的元素组成的流，按照自然顺序排序。如果这个流的元素不是  Comparable ， java.lang.ClassCastException 执行终端操作时可能会抛出a 。

      对于有序的流，排序是稳定的。对于无序流，没有稳定性保证。

      这是一个有状态的中间操作。

      返回：

      新的流

    • sorted

      Stream sorted(Comparator comparator)
      

      返回由该流的元素组成的流，按照提供的顺序进行排序 Comparator 。

      对于有序的流，排序是稳定的。对于无序流，没有稳定性保证。

      这是一个有状态的中间操作。

      参数：

      comparator - 用于比较流元素的无 干扰 ，  无状态  Comparator

      返回：

      新的流

    • peek

      Stream < T > peek（Consumer <？super T > action）

      返回由此流的元素组成的流，另外对每个元素执行提供的操作，因为元素将从结果流中消耗。

      这是一个中间操作。

      对于并行流管线，可以在任何时间和任何线程中通过上游操作来调用该操作。如果操作修改共享状态，则负责提供所需的同步。

      API注意：

      此方法主要用于支持调试，您希望在元素流经管道中的某个点时看到这些元素：

      
           Stream.of("one", "two", "three", "four")
               .filter(e -> e.length() > 3)
               .peek(e -> System.out.println("Filtered value: " + e))
               .map(String::toUpperCase)
               .peek(e -> System.out.println("Mapped value: " + e))
               .collect(Collectors.toList());
       

      参数：

      action - 从流中消耗的对元素执行的  无干扰 操作

      返回：

      新的流

    • limit

      Stream limit(long maxSize)
      

      返回由此流的元素组成的流，截断的 maxSize 长度不得超过。

      这是一个短路状态中间操作。

      API注意：

      虽然 limit() 在顺序流管道上通常是一个便宜的操作，但是在有序并行流水线上，特别是对于大数值，这可能是非常昂贵的 maxSize ，因为 limit(n)  不仅要返回任何 n个 元素，还要返回遇到顺序中的  前n个 元素。如果您的情况的语义允许，使用无序的流源（如 generate(Supplier) ）或删除排序约束 BaseStream.unordered() 可能会导致 limit() 并行管道的显着加速。如果要求与遇到命令的一致性，并且 limit() 在并行管道中遇到性能不佳或内存利用率 较低的问题，则切换到顺序执行 BaseStream.sequential() 可能会提高性能。

      参数：

      maxSize  - 流应该被限制的元素的数量

      返回：

      新的流

      抛出：

      IllegalArgumentException - 如果 maxSize 是消极的

    • skip

      Stream < T > skip（long n）

      丢弃流的第一个 n 元素后，返回包含此流的其余元素的流。如果这个流包含少于 n 元素，那么将返回一个空的流。

      这是一个有状态的中间操作。

      API注意：

      虽然 skip() 在顺序流管线上通常是一个便宜的操作，但对于有序的并行流水线，特别是对于大数值，这可能是非常昂贵的 n ，因为 skip(n)  被约束不仅跳过任何 n个 元素，而且还跳过遇到次序中的  前n个 元素。如果您的情况的语义允许，使用无序的流源（如 generate(Supplier) ）或删除排序约束 BaseStream.unordered() 可能会导致 skip() 并行管道的显着加速。如果要求与遇到命令的一致性，并且 skip() 在并行管道中遇到性能不佳或内存利用率 较低的问题，则切换到顺序执行 BaseStream.sequential() 可能会提高性能。

      参数：

      n  - 要跳过的主要元素的数量

      返回：

      新的流

      抛出：

      IllegalArgumentException - 如果 n 是消极的

    • forEach

      void forEach（Consumer <？super T > action）

      对此流的每个元素执行操作。

      这是一个终端操作。

      这个操作的行为显然是不确定的。对于并行流管道，这个操作并不能 保证尊重流的相遇顺序，因为这样做会牺牲并行的利益。对于任何给定的元素，该动作可以在任何时间和在图书馆选择的任何线程中执行。如果操作访问共享状态，则负责提供所需的同步。

      参数：

      action - 对元素执行的  无干扰 行为

    • forEachOrdered

      void forEachOrdered（Consumer <？super T > action）

      为流的每个元素执行操作，如果流具有已定义的遇到顺序，则按流的遇到顺序执行操作。

      这是一个终端操作。

      这个操作一次处理一个元素，如果存在的话，按照顺序处理。执行一个元素的动作 发生在 为后续元素执行动作之前，但是对于任何给定的元素，动作可以在库选择的任何线程中执行。

      参数：

      action - 对元素执行的  无干扰 行为

      也可以看看：

      forEach(Consumer)

    • toArray

      Object [] toArray（）

      返回包含此流的元素的数组。

      这是一个终端操作。

      返回：

      包含此流的元素的数组

    • toArray

       A[] toArray(IntFunction generator)
      

      返回包含此流的元素的数组，使用提供的 generator 函数分配返回的数组，以及分区执行或调整大小时可能需要的其他数组。

      这是一个终端操作。

      API注意：

      生成器函数采用一个整数，它是所需数组的大小，并生成所需大小的数组。这可以用一个数组构造器引用来简洁地表示：

      
           Person[] men = people.stream()
                                .filter(p -> p.getGender() == MALE)
                                .toArray(Person[]::new);
       

      类型参数：

      A  - 结果数组的元素类型

      参数：

      generator  - 一个产生所需类型和提供长度的新数组的函数

      返回：

      包含此流中元素的数组

      抛出：

      ArrayStoreException  - 如果从数组生成器返回的数组的运行时类型不是该流中每个元素的运行时类型的超类型

    • reduce

      T reduce(T identity,
               BinaryOperator accumulator)
      

      使用提供的标识值和关联 累积函数执行此流的元素  缩减 ，并返回缩小的值。这相当于：

      
           T result = identity;
           for (T element : this stream)
               result = accumulator.apply(result, element)
           return result;
       

      但不限制顺序执行。

      该identity值必须是累加器函数的标识。这意味着，所有t， accumulator.apply(identity, t)等于t。该accumulator函数必须是一个 关联函数。

      这是一个终端操作。

      API注意：

      总和，最小值，最大值，平均值和字符串连接都是特殊的缩减情况。总结一串数字可以表示为：

      
           Integer sum = integers.reduce(0, (a, b) -> a+b);
       

      要么：

      
           Integer sum = integers.reduce(0, Integer::sum);
       

      虽然这可能看起来是一个更简单的方法来执行聚合，而不是简单地将循环中的运行总量进行变异，但是减少操作可以更加平滑地进行并行处理，而不需要额外的同步，并且大大降低了数据竞争的风险。

      参数：

      identity  - 积累函数的标识值

      accumulator - 用于组合两个值的 关联 ，  无干扰 ，  无状态 函数

      返回：

      减少的结果

    • reduce

      Optional reduce(BinaryOperator accumulator)
      

      使用关联累积函数执行此流的元素  缩减 ，并返回描述缩小的值（如果有的话）。这相当于：  Optional

      
           boolean foundAny = false;
           T result = null;
           for (T element : this stream) {
               if (!foundAny) {
                   foundAny = true;
                   result = element;
               }
               else
                   result = accumulator.apply(result, element);
           }
           return foundAny ? Optional.of(result) : Optional.empty();
       

      但不限制顺序执行。

      该accumulator函数必须是一个 关联函数。

      这是一个终端操作。

      参数：

      accumulator - 用于组合两个值的 关联 ，  无干扰 ，  无状态 函数

      返回：

      一个 Optional 描述减少的结果

      抛出：

      NullPointerException  - 如果减少的结果为空

      也可以看看：

      reduce(Object, BinaryOperator) ，  min(Comparator) ，  max(Comparator)

    • reduce

       U reduce(U identity,
                   BiFunction accumulator,
                   BinaryOperator combiner)
      

      使用提供的身份，积累和组合功能，执行此流的元素 缩减 。这相当于：

      
           U result = identity;
           for (T element : this stream)
               result = accumulator.apply(result, element)
           return result;
       

      但不限制顺序执行。

      该identity值必须是组合函数的标识。这意味着，所有u，combiner(identity, u) 等于u。此外，该combiner功能必须与该accumulator功能兼容; 对于所有 u和t，以下必须持有：

      
           combiner.apply(u, accumulator.apply(identity, t)) == accumulator.apply(u, t)
       

      这是一个终端操作。

      API注意：

      许多减少使用这种形式可以更简单地通过明确的组合 map 和 reduce 操作来表示。该 accumulator 函数作为一个融合的映射器和累加器，有时比单独的映射和减少更有效率，比如知道以前减少的值可以避免一些计算。

      类型参数：

      U  - 结果的类型

      参数：

      identity  - 组合函数的标识值

      accumulator -一个 缔合 ，  非干扰性 ，  无状态  用于将一个额外的元件到结果函数

      combiner -一个 缔合 ，  非干扰 ，  无状态  功能用于组合两个值，它必须与蓄能器功能兼容

      返回：

      减少的结果

      也可以看看：

      reduce(BinaryOperator) ，  reduce(Object, BinaryOperator)

    • collect

       R collect(Supplier supplier,
                    BiConsumer accumulator,
                    BiConsumer combiner)
      

      对此流的元素执行 可变减少 操作。一个可变的约简是减少的值是一个可变的结果容器，比如一个 ArrayList ，通过更新结果的状态而不是通过替换结果来结合元素。这产生了等同于下面的结果：

      
           R result = supplier.get();
           for (T element : this stream)
               accumulator.accept(result, element);
           return result;
       

      就像reduce(Object, BinaryOperator)，collect操作可以并行，而不需要额外的同步。

      这是一个终端操作。

      API注意：

      JDK中有许多现有的类，它们的签名非常适合用作方法引用作为参数 collect() 。例如，以下内容将把字符串累加到 ArrayList ：

      
           List asList = stringStream.collect(ArrayList::new, ArrayList::add,
                                                      ArrayList::addAll);
       

      以下内容将获取一串字符串并将它们连接成一个字符串：

      
           String concat = stringStream.collect(StringBuilder::new, StringBuilder::append,
                                                StringBuilder::append)
                                       .toString();
       

      类型参数：

      R  - 结果的类型

      参数：

      supplier  - 一个创建一个新的结果容器的函数。对于并行执行，可能会多次调用此函数，并且每次都必须返回一个新值。

      accumulator -一个 缔合 ，  非干扰性 ，  无状态  用于将一个额外的元件到结果函数

      combiner -一个 缔合 ，  非干扰 ，  无状态  功能用于组合两个值，它必须与蓄能器功能兼容

      返回：

      减少的结果

    • collect

       R collect(Collector collector)
      

      使用a对此流的元素执行 可变减少 操作  Collector 。A  Collector  将用作参数的函数封装起来  collect(Supplier, BiConsumer, BiConsumer) ，从而允许重用收集策略和收集操作的组合，例如多级分组或分区。

      如果流是平行的，并且Collector 是concurrent，并且或者流是无序或集电极是 unordered，那么将执行一个并发减少（见Collector用于并发还原细节）。

      这是一个终端操作。

      当并行执行时，可以实例化，填充和合并多个中间结果，以保持可变数据结构的隔离。因此，即使与非线程安全的数据结构（如ArrayList）并行执行，并行还原也不需要额外的同步。

      API注意：

      以下将把字符串累加到ArrayList中：

      
           List asList = stringStream.collect(Collectors.toList());
       

      以下将按Person城市对对象进行分类：

      
           Map> peopleByCity
               = personStream.collect(Collectors.groupingBy(Person::getCity));
       

      以下将按Person州和城市分类对象，将两个对象级联Collector在一起：

      
           Map>> peopleByStateAndCity
               = personStream.collect(Collectors.groupingBy(Person::getState,
                                                            Collectors.groupingBy(Person::getCity)));
       

      类型参数：

      R  - 结果的类型

      A  - 的中间积累类型  Collector

      参数：

      collector -  Collector 描述减少

      返回：

      减少的结果

      也可以看看：

      collect(Supplier, BiConsumer, BiConsumer) ，  Collectors

    • min

      Optional min(Comparator comparator)
      

      根据提供的返回此流的最小元素  Comparator 。这是 减少 的特殊情况 。

      这是一个终端操作。

      参数：

      comparator - 一个 无干扰 ，  无状态  Comparator 的比较这个流的元素

      返回：

      一个 Optional 描述该流的最小元素，或空 Optional 如果流是空

      抛出：

      NullPointerException  - 如果最小元素为null

    • max

      Optional max(Comparator comparator)
      

      根据提供的内容返回此流的最大元素  Comparator 。这是 减少 的特殊情况 。

      这是一个终端操作。

      参数：

      comparator - 一个 无干扰 ，  无状态  Comparator 的比较这个流的元素

      返回：

      一个 Optional 描述该流的最大元素，或空 Optional 如果流是空

      抛出：

      NullPointerException  - 如果最大元素为空

    • count

      long count（）

      返回此流中元素的数量。这是一个特殊的情况下 降低 ，等同于：

      
           return mapToLong(e -> 1L).sum();
       

      这是一个终端操作。

      返回：

      这个流中元素的数量

    • anyMatch

      boolean anyMatch(Predicate predicate)
      

      返回此流的任何元素是否与提供的谓词匹配。如果不需要确定结果，则不能评估所有元素的谓词。如果流是空的，则  false 返回并且不评估谓词。

      这是一个短路终端操作。

      API注意：

      这种方法评估流的元素上谓词的 存在量化 （对于一些x P（x））。

      参数：

      predicate - 适用于这个流的元素的一个 无干扰 ，  无状态的 谓词

      返回：

      true  如果流的任何元素与提供的谓词匹配，否则  false

    • allMatch

      boolean allMatch(Predicate predicate)
      

      返回此流的所有元素是否与提供的谓词匹配。如果不需要确定结果，则不能评估所有元素的谓词。如果流是空的，则 true 返回并且不评估谓词。

      这是一个短路终端操作。

      API注意：

      这种方法评估流的元素的谓词的 通用量化 （对于所有x P（x））。如果流是空的，量化被认为是 真实的满足 ，并且总是 true （不管P（x））。

      参数：

      predicate - 适用于这个流的元素的一个 无干扰 ，  无状态的 谓词

      返回：

      true  如果流的所有元素都匹配提供的谓词，或者流是空的，否则  false

    • noneMatch

      boolean noneMatch(Predicate predicate)
      

      返回此流的元素是否与提供的谓词匹配。如果不需要确定结果，则不能评估所有元素的谓词。如果流是空的，则 true 返回并且不评估谓词。

      这是一个短路终端操作。

      API注意：

      这种方法评估流元素上的否定谓词的 通用量化 （对于所有x〜P（x））。如果流是空的，则量化被认为是真实地满足，并且总是 true ，不管P（x）如何。

      参数：

      predicate - 适用于这个流的元素的一个 无干扰 ，  无状态的 谓词

      返回：

      true  如果流的任何元素都不匹配提供的谓词，或者流是空的，否则  false

    • findFirst

      Optional findFirst()
      

      返回 Optional 描述此流的第一个元素， Optional 如果流为空，则返回空。如果流没有遇到命令，则可以返回任何元素。

      这是一个短路终端操作。

      返回：

      一个 Optional 描述该流的第一个元素，或空 Optional 如果流是空

      抛出：

      NullPointerException  - 如果选择的元素为空

    • findAny

      Optional findAny()
      

      返回 Optional 描述流的某个元素， Optional 如果流为空，则返回一个空元素。

      这是一个短路终端操作。

      这个操作的行为是明确的不确定的; 它可以自由选择流中的任何元素。这是为了在并行操作中实现最高性能。成本是多个调用在同一来源可能不会返回相同的结果。（如果需要稳定的结果，请findFirst()改用。）

      返回：

      一个 Optional 描述该流的某些元件，或者一个空 Optional 如果流是空

      抛出：

      NullPointerException  - 如果选择的元素为空

      也可以看看：

      findFirst()

    • builder

      static  Stream.Builder builder()

      返回一个生成器 Stream 。

      类型参数：

      T  - 元素的类型

      返回：

      一个流建设者

    • empty

      static   Stream  empty（）

      返回一个空的顺序 Stream 。

      类型参数：

      T  - 流元素的类型

      返回：

      一个空的顺序流

    • of

      static  Stream of(T t)
      

      返回 Stream 包含单个元素的顺序。

      类型参数：

      T  - 流元素的类型

      参数：

      t  - 单个元素

      返回：

      一个单一的顺序流

    • of

      @SafeVarargs
      static  Stream of(T... values)
      

      返回一个顺序排列的流，其元素是指定的值。

      类型参数：

      T  - 流元素的类型

      参数：

      values  - 新流的元素

      返回：

      新的流

    • iterate

      static   Stream  iterate（T seed，
                                    UnaryOperator  f）

      返回一个无限连续有序 Stream 通过函数的迭代应用产生 f 为初始元素 seed ，产生 Stream 包括 seed ， f(seed) ，  f(f(seed)) ，等。

      第一个元素（位置0）Stream将会是提供的seed。为n > 0，在位置上的元素 n，将是将所述函数的结果f在位置到元件n - 1。

      类型参数：

      T  - 流元素的类型

      参数：

      seed  - 最初的元素

      f  - 应用于前一个元素以生成新元素的函数

      返回：

      一个新的顺序  Stream

    • generate

      static   Stream  generate（Supplier  s）

      返回无限顺序无序流，其中每个元素由提供的生成 Supplier 。这适用于生成恒定流，随机元素流等。

      类型参数：

      T  - 流元素的类型

      参数：

      s -  Supplier 生成的元素

      返回：

      一个新的无限顺序无序  Stream

    • concat

      static   Stream  concat（Stream <？extends T> a，
                                   Stream <？extends T> b）

      创建一个延迟连接的流，其元素是第一个流的所有元素，后跟第二个流的所有元素。如果两个输入流都是有序的，则生成的流是有序的;如果任意一个输入流是并行的，则生成的流是并行的。当结果流关闭时，调用两个输入流的关闭处理程序。

      实施说明：

      从重复连接构造流时要小心。访问深度级联流的元素可能会导致深度调用链，甚至导致深度调用链 StackOverflowException 。

      类型参数：

      T  - 流元素的类型

      参数：

      a  - 第一个流

      b  - 第二个流

      返回：

      两个输入流的连接