Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Collector.of: własny kolektor z czterema funkcjami

Zdefiniuj własny kolektor strumienia: utwórz stan roboczy, dodawaj elementy, łącz wyniki częściowe i przekształć stan w wynik końcowy.

Wersja: Java SE 21

Składnia

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 to statyczna metoda fabrykująca interfejsu java.util.stream.Collector. Tworzy kolektor, który przekazujesz do operacji końcowej Stream.collect(collector). W typie Collector<T, A, R> parametr T oznacza typ elementu wejściowego, A — typ mutowalnego stanu pośredniego, a R — typ wyniku końcowego.

W przeciążeniu z czterema funkcjami supplier za każdym razem tworzy nowy, pusty kontener A; accumulator aktualizuje go o jeden element T i nic nie zwraca; combiner łączy dwa wyniki częściowe i zwraca połączony stan A; finisher przekształca końcowy stan A w R. Po funkcjach można podać opcjonalne flagi Collector.Characteristics. Oba przeciążenia zgłaszają NullPointerException, jeśli przekazany argument ma wartość null.

Przy redukcji równoległej strumień może napełniać osobne kontenery i potem je łączyć. Redukcja z podziałem danych i redukcja bez podziału muszą dawać równoważne wyniki. W przypadku kolektora z cechą UNORDERED wyniki mogą być równoważne mimo różnic wynikających wyłącznie z kolejności. Dołączenie pustego kontenera z prawej strony musi dawać równoważny wynik. Nie zwracaj z supplier wspólnego mutowalnego kontenera i nie ustawiaj CONCURRENT, jeśli accumulator nie może bezpiecznie aktualizować tego samego kontenera z kilku wątków naraz.

Przeciążenie z trzema funkcjami nie przyjmuje finisher: zwraca Collector<T, R, R> i automatycznie ustawia IDENTITY_FINISH. To flaga, nie metoda Collector.identityFinish; pozwala pominąć funkcję końcową. Nie ustawiaj jej, gdy finisher wykonuje potrzebne przekształcenie. Jeśli chcesz tylko połączyć teksty w kolejności napotykania elementów, użyj gotowego Collectors.joining.

Przykłady

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());
    }
}

Wynik

count=3, totalLength=9

Tablica `long[]` przechowuje liczbę napisów i sumę wartości `String.length()`. `combiner` dodaje odpowiadające sobie pola, a `finisher` tworzy rekord `Totals`. Zarówno strumień równoległy, jak i sekwencyjny daje dla tych danych `count=3, totalLength=9`.

Powiązane lekcje

  • Java · Lekcja 45 · Średniozaawansowany · Wersja: 2

Źródła