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