Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Collector — vlastita promjenjiva redukcija toka

Collector<T, A, R> opisuje prikupljanje elemenata toka u promjenjivo stanje i njegovu pretvorbu u rezultat. Saznajte više o funkcijama collectora, zahtjevima za paralelnu obradu i značenju njegovih svojstava u Java SE 21.

Verzija: 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 promjenjivu redukciju koju upotrebljava Stream.collect: T je element, A akumulacijsko stanje, a R rezultat. Nemojte brkati sučelje Collector s klasom Collectors, koja pruža gotove collectore. Opseg: Java SE 21; okruženje izvođenja repozitorija i produkcijsko okruženje nisu potvrđeni.

Collector.supplier() vraća funkciju koja stvara novi promjenjivi spremnik; Collector.accumulator() vraća funkciju koja dodaje element; Collector.combiner() vraća funkciju koja spaja djelomična stanja; Collector.finisher() vraća funkciju koja pretvara A u R. Collector.of izrađuje collector iz tih funkcija. Preopterećenje bez izričitog finishera ima A = R i automatski deklarira IDENTITY_FINISH.

Collector.characteristics() vraća nepromjenjiv skup deklariranih svojstava. Collector.Characteristics.CONCURRENT dopušta istodobne pozive akumulatora nad istim spremnikom. Collector.Characteristics.UNORDERED znači da nema obveze očuvanja redoslijeda susretanja. Zajednička istodobna akumulacija zahtijeva CONCURRENT i ili UNORDERED ili neuređen tok. Collector.Characteristics.IDENTITY_FINISH dopušta preskakanje finishera: mora biti riječ o identičnoj transformaciji, a pretvorba tipa iz A u R mora uspjeti. Zastavice opisuju jamstva; ne pružaju sinkronizaciju.

Spajanje mora biti asocijativno i usklađeno s akumulacijom; spajanje praznog stanja ne smije promijeniti rezultat. Collector bez CONCURRENT može se izvoditi paralelno: biblioteka izolira djelomična stanja, a zatim ih spaja. Nemojte dijeliti jedan promjenjivi spremnik među pozivima dobavljača.

Primjer čuva redoslijed te upotrebljava StringBuilder kao A, a String kao R. Ne deklarira nikakva svojstva: StringBuilder ne podržava zajedničku istodobnu akumulaciju, a finisher mijenja tip. Očekuje se da će oba načina prikupljanja ispisati ABC.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori