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.