База знанияИзпитен център
BGБългарски
Избери език13

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

Източници