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.