compact1, compact2, compact3

java.util.stream

Interface Collector<T,A,R>

参数类型

T -还原操作的输入元素的类型

A -还原操作的积累型（经常隐藏实现细节）

R -减运算的结果类型

public interface Collector<T,A,R>

一个 mutable reduction operation积累输入元素到一个可变的结果的容器，可随意变换积累的结果到最后表示，毕竟输入元素已被处理。减少操作可以是顺序或并行执行。

可变减速操作的例子包括：积累元素为Collection；连接字符串使用StringBuilder；计算汇总信息等要素的总和，min，max，或平均值；计算“数据透视表”总结如“最大值的交易的卖方”等类Collectors提供许多常见的可变减少的实现。

一个Collector由四个功能一起工作，积累的作品成为一个可变的结果容器指定，和选择性的进行最后的变换结果。他们是:

• 一个新的容器（supplier()）创造的结果
• 将一个新的数据元素为一个容器（accumulator()）结果
• 结合两个结果容器为一（combiner()）
• 执行一个可选的最后变换在容器（finisher()）

收藏家也有一套特征，如Collector.Characteristics.CONCURRENT，提供暗示，可以通过减少实施应用提供更好的性能。

使用收集器的减少的顺序执行将创建一个单一的结果容器，使用供应商的功能，并调用一次为每个输入元件的蓄电池功能。并行执行分区的输入，创建每个分区结果的容器，积累各分区的内容到一个分区subresult，然后使用组合功能合并成一个综合结果subresults。

确保顺序和并行执行，产生相同的结果，集函数必须满足的一个身份和associativity约束。

身份约束说，对于任何部分积累的结果，将它与一个空的结果容器相结合，必须产生一个等效的结果。那是，一部分积累的结果，是a因蓄电池系列和组合调用，a必须相当于combiner.apply(a, supplier.get())。

相关性约束说，分裂的计算必须产生一个等效的结果。就是说，对于任何输入元素t1和t2，在下面的计算结果r1和r2必须等价：

     A a1 = supplier.get();
     accumulator.accept(a1, t1);
     accumulator.accept(a1, t2);
     R r1 = finisher.apply(a1);  // result without splitting

     A a2 = supplier.get();
     accumulator.accept(a2, t1);
     A a3 = supplier.get();
     accumulator.accept(a3, t2);
     R r2 = finisher.apply(combiner.apply(a2, a3));  // result with splitting
 

收藏家，没有UNORDERED特点，两积累的结果，a1和a2等效如果finisher.apply(a1).equals(finisher.apply(a2))。无序的收藏家，对等是放宽到允许不同订单相关的不平等。（例如，一个无序的收集器，积累的元素到一个List会考虑两个列表等效如果他们含有相同的元素，无视秩序。）

实现基于Collector减库，如Stream.collect(Collector)，必须坚持以下约束：

• 第一个参数传递给累加器的功能，无论是传入的参数组合的功能和参数传递到修整功能必须前一个调用的结果供应商，蓄能器的结果，或组合功能。
• 的实施不应与任何结果的供应商，蓄能器的结果做任何事，或组合功能比通过他们再次蓄能器、合路器，或修整功能，或返回到调用者的还原操作。
• 如果结果传递给合成器或修整功能，和相同的对象不是从函数返回，它不会再被使用。
• 一旦结果传递给合成器或修整功能，它是不会通过累加器的功能了。
• 非并发收集器，任何结果返回结果的供应商，蓄能器，或组合功能必须连续螺纹承压。这使得收集发生在平行而不需要执行任何额外的同步Collector。减少实施必须管理的输入是正确的分区，分区处理在隔离，并结合发生后，才积累完成。
• 对于并发收集器，一个实现是免费的（但不需要）同时实现减少。同时还原是一个蓄能器的功能是从多个线程并发调用，使用相同的同时改变的结果的容器，而不是保持结果中分离富集。同时减少是收藏家的Collector.Characteristics.UNORDERED特征或如果源数据是无序的应用。

除了在Collectors预定义的实现，静态工厂方法of(Supplier, BiConsumer, BinaryOperator, Characteristics...)可以用来构建器。例如，您可以创建一个收集器，积累成一个TreeSet与部件：

     Collector<Widget, ?, TreeSet<Widget>> intoSet =
         Collector.of(TreeSet::new, TreeSet::add,
                      (left, right) -> { left.addAll(right); return left; });
 

（这种行为也是通过预定义的收藏家 Collectors.toCollection(Supplier)实现）。

API Note:

执行与 Collector还原操作应该产生的结果相当于：

     R container = collector.supplier().get();
     for (T t : data)
         collector.accumulator().accept(container, t);
     return collector.finisher().apply(container);
 

然而，图书馆自由分区的输入，对分区进行还原，然后使用组合功能相结合的部分结果实现并行还原。（取决于特定的还原操作，这可能会表现的更好或更糟的是，根据相对成本的蓄能器和合成器的功能。）

收藏家设计组成；在Collectors方法的许多函数，收藏家和产生一个新的收藏家。例如，给定以下的收集器，计算员工的工资的总和：

     Collector<Employee, ?, Integer> summingSalaries
         = Collectors.summingInt(Employee::getSalary))
 

如果我们想创造一个集按工资部门的总和，我们可以重用“笔薪水”逻辑使用 Collectors.groupingBy(Function, Collector)：

     Collector<Employee, ?, Map<Department, Integer>> summingSalariesByDept
         = Collectors.groupingBy(Employee::getDepartment, summingSalaries);
 

从以下版本开始：

一点八

另请参见：

Stream.collect(Collector)， Collectors

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Collector.Characteristics 特征表明一个 Collector性能，可用于优化还原的实现。

方法摘要

Modifier and Type	Method and Description
BiConsumer<A,T>	accumulator() 一个函数值为一个可变的结果折叠容器。
Set<Collector.Characteristics>	characteristics() 返回一个 Set的 Collector.Characteristics指示该除尘器的特点。
BinaryOperator<A>	combiner() 一个函数，它接受两个部分结果并将其合并。
Function<A,R>	finisher() 从中间堆积型 A到最终的结果 R型执行最终的转化。
static <T,A,R> Collector<T,A,R>	of(Supplier<A> supplier, BiConsumer<A,T> accumulator, BinaryOperator<A> combiner, Function<A,R> finisher, Collector.Characteristics... characteristics) 返回一个新的 Collector由给定的 supplier， accumulator， combiner描述，和 finisher功能。
static <T,R> Collector<T,R,R>	of(Supplier<R> supplier, BiConsumer<R,T> accumulator, BinaryOperator<R> combiner, Collector.Characteristics... characteristics) 返回一个新的 Collector由给定的 supplier， accumulator描述，和 combiner功能。
Supplier<A>	supplier() 一个函数创建并返回一个新的结果的容器。

方法详细信息

supplier

Supplier<A> supplier()

一个函数创建并返回一个新的结果的容器。

结果

一个函数，返回一个新的、可变的结果的容器

accumulator

BiConsumer<A,T> accumulator()

一个函数值为一个可变的结果折叠容器。

结果

一个函数的值为一个可变的结果折叠容器

combiner

BinaryOperator<A> combiner()

一个函数，它接受两个部分结果并将其合并。组合功能可折叠状态从一个参数到另一回，或者返回一个新的结果的容器。

结果

将两个部分结果合并成一个组合结果的函数

finisher

Function<A,R> finisher()

从中间堆积型 A到最终的结果 R型进行最后的转变。

如果特征IDENTITY_TRANSFORM设置，这个功能可认为是从A到R unchecked铸变换身份。

结果

将中间结果转换为最终结果的函数

characteristics

Set<Collector.Characteristics> characteristics()

返回一个 Set的 Collector.Characteristics指示该除尘器的特点。此设置应该是不可变的。

结果

一组不可变的集电极特性

of

static <T,R> Collector<T,R,R> of(Supplier<R> supplier,
                                 BiConsumer<R,T> accumulator,
                                 BinaryOperator<R> combiner,
                                 Collector.Characteristics... characteristics)

返回一个新的 Collector由给定的 supplier， accumulator描述，和 combiner功能。由此产生的 Collector有 Collector.Characteristics.IDENTITY_FINISH特性。

参数类型

T -新的集电极输入元素的类型

R -中间积累的结果的类型，和最终的结果，为新的收藏家

参数

supplier -新供应商的功能集

accumulator -新收集器累加器的功能

combiner -新型捕收剂的组合功能

characteristics -新的集热器的集热性能

结果

新 Collector

异常

NullPointerException -如果任一参数为空

of

static <T,A,R> Collector<T,A,R> of(Supplier<A> supplier,
                                   BiConsumer<A,T> accumulator,
                                   BinaryOperator<A> combiner,
                                   Function<A,R> finisher,
                                   Collector.Characteristics... characteristics)

返回一个新的 Collector由给定的 supplier， accumulator， combiner描述，和 finisher功能。

参数类型

T -新的集电极输入元素的类型

A -新型捕收剂的中间堆积型

R -新型捕收剂的最终结果类型

参数

supplier -新供应商的功能集

accumulator -新收集器累加器的功能

combiner -新型捕收剂的组合功能

finisher -新功能集的终结者

characteristics -新的集热器的集热性能

结果

新 Collector

异常

NullPointerException -如果任一参数为空