Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Collector — lastna spremenljiva redukcija toka

Collector<T, A, R> opisuje zbiranje elementov toka v spremenljivo stanje in pretvorbo tega stanja v rezultat. Spoznajte funkcije zbiralnika, zahteve za vzporedno obdelavo in pomen njegovih lastnosti v Java SE 21.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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

Collector<T, A, R> opisuje spremenljivo redukcijo, ki jo uporablja Stream.collect: T je element, A akumulacijsko stanje, R pa rezultat. Vmesnika Collector ne zamenjujte z razredom Collectors, ki ponuja že pripravljene zbiralnike. Obseg: Java SE 21; izvajalno okolje repozitorija in produkcijsko okolje nista potrjena.

Collector.supplier() vrne funkcijo, ki ustvari nov spremenljiv vsebnik; Collector.accumulator() vrne funkcijo, ki doda element; Collector.combiner() vrne funkcijo, ki združi delna stanja; Collector.finisher() vrne funkcijo, ki pretvori A v R. Collector.of izdela zbiralnik iz teh funkcij. Preobremenitev brez izrecnega zaključnega postopka ima A = R in samodejno deklarira IDENTITY_FINISH.

Collector.characteristics() vrne nespremenljivo množico deklariranih lastnosti. Collector.Characteristics.CONCURRENT dovoljuje sočasne klice akumulatorja na istem vsebniku. Collector.Characteristics.UNORDERED pomeni, da ni zaveze k ohranjanju vrstnega reda pojavitev. Skupno sočasno akumuliranje zahteva CONCURRENT in bodisi UNORDERED bodisi neurejen tok. Collector.Characteristics.IDENTITY_FINISH omogoča izpustitev zaključnega postopka: ta mora biti identična transformacija, pretvorba z ulivanjem iz A v R pa mora uspeti. Zastavice opisujejo jamstva; ne zagotavljajo sinhronizacije.

Združevanje mora biti asociativno in skladno z akumuliranjem; združitev praznega stanja ne sme spremeniti rezultata. Zbiralnik brez CONCURRENT se lahko izvaja vzporedno: knjižnica izolira delna stanja in jih nato združi. Med klici dobavitelja ne delite enega spremenljivega vsebnika.

Primer ohranja vrstni red ter uporablja StringBuilder kot A in String kot R. Ne deklarira nobenih lastnosti: StringBuilder ne podpira skupnega sočasnega akumuliranja, zaključni postopek pa spremeni tip. Pričakuje se, da bosta oba načina zbiranja izpisala ABC.

Primeri

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

Rezultat

ABC
ABC
true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri