CKTIS / Java
Collector — własna redukcja mutowalna strumienia
Collector<T, A, R> opisuje zbieranie elementów strumienia do mutowalnego stanu i przekształcenie go w wynik. Poznaj funkcje kolektora, wymagania dla przetwarzania równoległego i znaczenie jego charakterystyk w Java SE 21.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
Collector<T, A, R>
Collector.of(supplier, accumulator, combiner, characteristics...)
Collector.of(supplier, accumulator, combiner, finisher, characteristics...)Collector<T, A, R> opisuje redukcję mutowalną używaną przez Stream.collect: T to element, A — stan akumulacji, a R — wynik. Nie należy mylić interfejsu Collector z klasą Collectors, udostępniającą gotowe kolektory. Zakres wpisu: Java SE 21; środowisko repozytorium i środowisko produkcyjne nie zostały potwierdzone.
Collector.supplier() zwraca funkcję tworzącą nowy mutowalny pojemnik; Collector.accumulator() — funkcję dodającą element; Collector.combiner() — funkcję łączącą częściowe stany; Collector.finisher() — funkcję przekształcającą A w R. Collector.of buduje kolektor z tych funkcji. Wariant bez jawnego finiszera ma A = R i automatycznie deklaruje IDENTITY_FINISH.
Collector.characteristics() zwraca niemodyfikowalny zbiór deklarowanych właściwości. Collector.Characteristics.CONCURRENT dopuszcza równoczesne wywołania akumulatora na tym samym pojemniku. Collector.Characteristics.UNORDERED oznacza brak zobowiązania do zachowania kolejności napotkania elementów. Wspólna akumulacja współbieżna wymaga CONCURRENT oraz albo UNORDERED, albo nieuporządkowanego strumienia. Collector.Characteristics.IDENTITY_FINISH pozwala pominąć finiszer: musi on być tożsamościowy, a rzutowanie A na R musi się powieść. Flagi opisują gwarancje; nie zapewniają synchronizacji.
Łączenie musi być łączne i zgodne z akumulacją; dołączenie pustego stanu nie może zmienić wyniku. Kolektor bez CONCURRENT może działać równolegle: biblioteka izoluje stany częściowe, a następnie je łączy. Nie współdziel jednego mutowalnego pojemnika między wywołaniami dostawcy.
Przykład zachowuje kolejność i używa StringBuilder jako A, a String jako R. Nie deklaruje żadnych charakterystyk: StringBuilder nie obsługuje wspólnej akumulacji współbieżnej, a finiszer zmienia typ. Oba sposoby zbierania mają wypisać ABC.
Przykłady
import java.util.List;
import java.util.stream.Collector;
public class Main {
public static void main(String[] args) {
Collector<String, StringBuilder, String> concatenate = Collector.of(
StringBuilder::new,
(buffer, value) -> buffer.append(value),
(left, right) -> { left.append(right); return left; },
StringBuilder::toString
);
List<String> values = List.of("A", "B", "C");
System.out.println(values.stream().collect(concatenate));
System.out.println(values.parallelStream().collect(concatenate));
System.out.println(concatenate.characteristics().isEmpty());
}
}Wynik
ABC ABC true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.