Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Collector.of: prilagođeni kolektor s četiri funkcije

Definirajte kolektor za tok koji stvara radno stanje, dodaje elemente, spaja djelomične rezultate i pretvara stanje u konačnu vrijednost.

Verzija: 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 statička je tvornička metoda sučelja java.util.stream.Collector. Stvara kolektor koji prosljeđujete završnoj operaciji Stream.collect(collector). U tipu Collector<T, A, R> oznaka T predstavlja tip ulaznih elemenata, A tip promjenjivog međustanja, a R tip konačnog rezultata.

U preopterećenju s četiri funkcije supplier pri svakom pozivu stvara novi prazan spremnik tipa A; accumulator ga ažurira jednim elementom tipa T i ne vraća ništa; combiner spaja dva djelomična rezultata i vraća spojeno stanje tipa A; finisher pretvara konačno stanje tipa A u R. Nakon funkcija možete navesti neobavezne oznake tipa Collector.Characteristics. Oba preopterećenja bacaju NullPointerException ako je neki argument null.

Pri paralelnoj redukciji mogu se popuniti zasebni spremnici i zatim spojiti. Redukcija s podjelom ulaza i bez nje mora dati jednakovrijedne rezultate. Kod kolektora s oznakom UNORDERED rezultati mogu biti jednakovrijedni čak i ako se razlikuju samo po redoslijedu. Spajanje djelomičnog rezultata s praznim spremnikom kao drugim argumentom mora dati jednakovrijedan rezultat. Nemojte iz supplier vraćati zajednički promjenjivi spremnik niti postavljati CONCURRENT ako accumulator ne može sigurno ažurirati isti spremnik iz više dretvi istodobno.

Preopterećenje s tri funkcije ne prima finisher: vraća Collector<T, R, R> i automatski postavlja IDENTITY_FINISH. To je oznaka, a ne metoda Collector.identityFinish; omogućuje redukciji da preskoči finisher. Nemojte je postaviti ako finisher obavlja potrebnu pretvorbu. Ako samo želite spojiti tekstove redoslijedom kojim se elementi pojavljuju, upotrijebite gotovi kolektor Collectors.joining.

Primjeri

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[]` čuva broj nizova znakova i zbroj njihovih vrijednosti `String.length()`. `combiner` zbraja odgovarajuće stavke, a `finisher` stvara zapis `Totals`. Za ovaj ulaz paralelni i sekvencijalni tok daju `count=3, totalLength=9`.

Povezane lekcije

  • Java · Lekcija 45 · Srednje · Verzija: 2

Izvori