Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Collector.of: vlastný kolektor so štyrmi funkciami

Vytvorte vlastný kolektor prúdu, ktorý založí pracovný stav, pridáva prvky, zlučuje čiastkové výsledky a prevedie stav na konečnú hodnotu.

Verzia: Java SE 21

Syntax

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 statická továrenská metóda rozhrania java.util.stream.Collector. Vytvára kolektor, ktorý odovzdáte koncovej operácii Stream.collect(collector). V type Collector<T, A, R> označuje T typ vstupných prvkov, A typ meniteľného medzistavu a R typ konečného výsledku.

V preťažení so štyrmi funkciami supplier pri každom volaní vytvorí nový prázdny kontajner typu A; accumulator ho aktualizuje o jeden prvok typu T a nič nevracia; combiner zlúči dva čiastkové výsledky a vráti zlúčený stav typu A; finisher prevedie výsledný stav typu A na typ R. Za funkciami možno uviesť voliteľné príznaky typu Collector.Characteristics. Obe preťaženia vyvolajú NullPointerException, ak má niektorý argument hodnotu null.

Pri paralelnej redukcii sa môžu naplniť oddelené kontajnery a potom sa zlúčiť. Redukcia s rozdelením vstupu aj bez neho musí dať rovnocenné výsledky. Pri kolektore s príznakom UNORDERED môžu byť výsledky rovnocenné, aj keď sa líšia iba poradím. Zlúčenie čiastkového výsledku s prázdnym kontajnerom ako druhým argumentom musí dať rovnocenný výsledok. Z supplier nevracajte zdieľaný meniteľný kontajner a CONCURRENT nastavte len vtedy, ak accumulator dokáže bezpečne aktualizovať ten istý kontajner z viacerých vlákien naraz.

Preťaženie s tromi funkciami neprijíma finisher: vracia Collector<T, R, R> a automaticky nastavuje IDENTITY_FINISH. Je to príznak, nie metóda Collector.identityFinish; redukcia vďaka nemu môže vynechať finisher. Nenastavujte ho, ak finisher robí potrebnú transformáciu. Ak chcete iba spájať texty v poradí, v akom sa prvky v prúde vyskytujú, použite hotový kolektor Collectors.joining.

Príklady

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

Výsledok

count=3, totalLength=9

Pole `long[]` obsahuje počet reťazcov a súčet ich hodnôt `String.length()`. `combiner` sčíta zodpovedajúce položky a `finisher` vytvorí záznam `Totals`. Pre tieto údaje dá paralelný aj sekvenčný prúd výsledok `count=3, totalLength=9`.

Súvisiace lekcie

  • Java · Lekcia 45 · Stredne pokročilá · Verzia: 2

Zdroje