CKTIS / Java
Collector.of: zbiralnik po meri s štirimi funkcijami
Ustvari zbiralnik za tok, ki pripravi delovno stanje, dodaja elemente, združuje delne rezultate in pretvori stanje v končno vrednost.
Različica: Java SE 21
Sintaksa
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 je statična tovarniška metoda vmesnika java.util.stream.Collector. Ustvari zbiralnik, ki ga podaš končni operaciji Stream.collect(collector). V tipu Collector<T, A, R> je T tip vhodnih elementov, A tip spremenljivega vmesnega stanja in R tip končnega rezultata.
Pri preobremenjeni različici s štirimi funkcijami supplier ob vsakem klicu ustvari nov prazen vsebnik tipa A; accumulator ga posodobi z enim elementom tipa T in ne vrne ničesar; combiner združi dva delna rezultata in vrne združeno stanje tipa A; finisher pretvori končno stanje iz A v R. Za funkcijami lahko navedeš neobvezne zastavice tipa Collector.Characteristics. Obe različici sprožita NullPointerException, če je kateri od argumentov null.
Pri vzporedni redukciji se lahko najprej napolnijo ločeni vsebniki, nato pa se združijo. Redukcija z razdelitvijo vhoda in brez nje mora dati enakovredne rezultate. Pri zbiralniku z zastavico UNORDERED so lahko rezultati enakovredni, tudi če se razlikujejo samo po vrstnem redu. Če delni rezultat združiš s praznim vsebnikom kot drugim argumentom, mora biti rezultat enakovreden. Naj supplier ne vrača skupnega spremenljivega vsebnika. Zastavico CONCURRENT nastavi le, če lahko accumulator varno posodablja isti vsebnik iz več niti hkrati.
Različica s tremi funkcijami ne sprejme finisher: vrne Collector<T, R, R> in samodejno nastavi IDENTITY_FINISH. To je zastavica, ne metoda Collector.identityFinish; redukcija lahko zato preskoči finisher. Ne nastavi je, če finisher opravlja potrebno pretvorbo. Če želiš zgolj stakniti besedila v vrstnem redu, v katerem se elementi pojavijo, uporabi vnaprej pripravljeni Collectors.joining.
Primeri
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());
}
}Rezultat
count=3, totalLength=9
Polje `long[]` hrani število nizov in vsoto njihovih vrednosti `String.length()`. `combiner` sešteje vrednosti na ustreznih mestih, `finisher` pa ustvari zapis `Totals`. Za ta vhod vzporedni in zaporedni tok dasta `count=3, totalLength=9`.
Povezane lekcije
- Java · Lekcija 45 · Srednja · Različica: 2