CKTIS / Java
Collector.of: собствен колектор с четири функции
Създайте колектор за поток, който подготвя работно състояние, добавя елементи, обединява частични резултати и връща крайна стойност.
Версия: Java SE 21
Синтаксис
import java.util.stream.Collector;
// Static overloads declared by java.util.stream.Collector:
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);
static <T, R> Collector<T, R, R> of(
Supplier<R> supplier, BiConsumer<R, T> accumulator,
BinaryOperator<R> combiner,
Collector.Characteristics... characteristics);Collector.of е статичен фабричен метод на интерфейса java.util.stream.Collector. Той създава колектор, който подавате на терминалната операция Stream.collect(collector). В Collector<T, A, R> T е типът на входните елементи, A е типът на изменяемото междинно състояние, а R е типът на крайния резултат.
Във варианта с четири функции supplier създава нов празен контейнер от тип A при всяко извикване; accumulator го обновява с един елемент от тип T и не връща стойност; combiner обединява два частични резултата и връща общото състояние от тип A; finisher преобразува крайното състояние от тип A в R. След функциите могат да се зададат незадължителни флагове от тип Collector.Characteristics. И двата варианта хвърлят NullPointerException, ако някой аргумент е null.
При паралелна редукция могат да се попълнят отделни контейнери, които след това се обединяват. Редукцията със и без разделяне на входа трябва да дава еквивалентни резултати. При колектор с флаг UNORDERED резултатите могат да са еквивалентни дори ако се различават само по реда. Обединяването на частичен резултат с празен контейнер като втори аргумент трябва да дава еквивалентен резултат. Не връщайте споделен изменяем контейнер от supplier и задавайте CONCURRENT само ако accumulator може безопасно да обновява един и същ контейнер от няколко нишки едновременно.
Вариантът с три функции не приема finisher: той връща Collector<T, R, R> и автоматично задава IDENTITY_FINISH. Това е флаг, а не метод Collector.identityFinish; той позволява на редукцията да пропусне finisher. Не го задавайте, ако finisher извършва необходимо преобразуване. Ако искате само да слепите текстове в реда, в който се срещат елементите, използвайте готовия колектор Collectors.joining.
Примери
import java.util.List;
import java.util.stream.Collector;
public class Main {
record Totals(long count, long totalLength) {}
public static void main(String[] args) {
Collector<String, long[], Totals> lengthTotals = Collector.of(
() -> new long[2],
(state, word) -> {
state[0]++;
state[1] += word.length();
},
(left, right) -> {
left[0] += right[0];
left[1] += right[1];
return left;
},
state -> new Totals(state[0], state[1])
);
Totals totals = List.of("ant", "bear", "ox")
.parallelStream()
.collect(lengthTotals);
System.out.println("count=" + totals.count()
+ ", totalLength=" + totals.totalLength());
}
}Резултат
count=3, totalLength=9
Масивът `long[]` пази броя на низовете и сумата от стойностите на `String.length()` за тях. `combiner` събира съответните позиции, а `finisher` създава запис `Totals`. За този вход и паралелният, и последователният поток дават `count=3, totalLength=9`.
Свързани уроци
- Java · Урок 45 · Средно · Версия: 2