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

CKTIS / Java

Collector — vlastná mutabilná redukcia prúdu

Collector<T, A, R> opisuje zhromažďovanie prvkov prúdu do mutabilného stavu a jeho prevod na výsledok. Zoznámte sa s funkciami collectora, požiadavkami na paralelné spracovanie a významom jeho vlastností v Java SE 21.

Verzia: Java SE 21; repository runtime, production runtime not attested

Syntax

Collector<T, A, R>
Collector.of(supplier, accumulator, combiner, characteristics...)
Collector.of(supplier, accumulator, combiner, finisher, characteristics...)

Collector<T, A, R> opisuje mutabilnú redukciu používanú metódou Stream.collect: T je prvok, A akumulačný stav a R výsledok. Nezamieňajte rozhranie Collector s triedou Collectors, ktorá poskytuje hotové collectory. Rozsah: Java SE 21; behové prostredie repozitára ani produkčné prostredie nie sú potvrdené.

Collector.supplier() vracia funkciu, ktorá vytvára nový mutabilný kontajner; Collector.accumulator() vracia funkciu, ktorá pridá prvok; Collector.combiner() vracia funkciu, ktorá spája čiastkové stavy; Collector.finisher() vracia funkciu, ktorá prevádza A na R. Collector.of vytvorí collector z týchto funkcií. Preťaženie bez explicitného finishera má A = R a automaticky deklaruje IDENTITY_FINISH.

Collector.characteristics() vracia nemennú množinu deklarovaných vlastností. Collector.Characteristics.CONCURRENT povoľuje súčasné volania accumulatora nad tým istým kontajnerom. Collector.Characteristics.UNORDERED znamená, že nie je záväzok zachovať poradie výskytu. Zdieľaná súbežná akumulácia vyžaduje CONCURRENT a buď UNORDERED, alebo neusporiadaný stream. Collector.Characteristics.IDENTITY_FINISH umožňuje vynechať finisher: musí ísť o identickú transformáciu a pretypovanie A na R musí uspieť. Príznaky opisujú záruky; neposkytujú synchronizáciu.

Spájanie musí byť asociatívne a v súlade s akumuláciou; spojenie prázdneho stavu nesmie zmeniť výsledok. Collector bez CONCURRENT môže bežať paralelne: knižnica izoluje čiastkové stavy a potom ich spojí. Nezdieľajte jeden mutabilný kontajner medzi volaniami suppliera.

Príklad zachováva poradie a používa StringBuilder ako A a String ako R. Nedeklaruje žiadne vlastnosti: StringBuilder nepodporuje zdieľanú súbežnú akumuláciu a finisher mení typ. Očakáva sa, že oba spôsoby zberu vypíšu ABC.

Príklady

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

Výsledok

ABC
ABC
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje