CKTIS / Java
Collectors: zbirne statistike in sočasno združevanje
Razred java.util.stream.Collectors ponuja zbiralnike za Stream.collect. Združite Collectors.groupingByConcurrent in Collectors.summarizingDouble ter izračunajte številske zbirne statistike ločeno za vsako skupino.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
stream.collect(Collectors.summarizingDouble(mapper))
stream.collect(Collectors.groupingByConcurrent(classifier, Collectors.summarizingDouble(mapper)))java.util.stream.Collectors ponuja ponovno uporabne strategije redukcije za terminalno operacijo Stream.collect. Zbiralnike je mogoče sestavljati: zunanji zbiralnik oblikuje skupine, nadaljnji zbiralnik pa izračuna rezultat za vsako skupino. Ta vnos se nanaša na Java SE 21; produkcijsko izvajalno okolje ni potrjeno.
Collectors.summarizingDouble(mapper) vrne Collector<T, ?, DoubleSummaryStatistics>. Pri uporabi v Stream.collect zbiralnik uporabi mapper na vsakem elementu, da dobi vrednost tipa double. Rezultat operacije collect je objekt DoubleSummaryStatistics, ki vsebuje število elementov, vsoto, najmanjšo in največjo vrednost ter povprečje. Pri praznem vhodu so število, vsota in povprečje enaki nič, najmanjša vrednost je Double.POSITIVE_INFINITY, največja pa Double.NEGATIVE_INFINITY. Zaokroževanje lahko spremeni vsoto in povprečje; vrednosti NaN vplivajo na statistiko.
Collectors.groupingByConcurrent(classifier) in preobremenjena različica z nadaljnjim zbiralnikom vrneta zbiralnik. Pri uporabi v Stream.collect prvi vrne ConcurrentMap<K, List<T>>, drugi pa ConcurrentMap<K, D>. Oba zbiralnika podpirata sočasno obdelavo in imata lastnost UNORDERED: ne zagotavljata, da se ohrani vrstni red, v katerem se elementi pojavijo v toku, vendar tega ne izključujeta. Pri zaporednem zbiranju lahko na primer elementi na seznamu vsake skupine ostanejo v tem vrstnem redu. Nasprotno pa groupingBy ni sočasen zbiralnik. Za same nastale sezname ni zagotovljena varnost pri dostopu iz več niti.
Sočasna redukcija zahteva vzporedni tok; zbiralnik ga sam ne zažene. Funkcije naj bodo brez stanja in naj ne spreminjajo vira. Sočasni zemljevid ne zagotavlja varnosti pri poznejšem spreminjanju njegovih vrednosti DoubleSummaryStatistics iz več niti. Primer razvrsti ključe šele pred izpisom; majhne, natančno predstavljive vrednosti omogočajo predvidljive statistike.
Primeri
import java.util.DoubleSummaryStatistics;
import java.util.List;
import java.util.Locale;
import java.util.TreeMap;
import java.util.concurrent.ConcurrentMap;
import java.util.stream.Collectors;
public class Main {
record Item(String category, double value) {}
public static void main(String[] args) {
var items = List.of(
new Item("A", 2.0),
new Item("B", 8.0),
new Item("A", 4.0)
);
ConcurrentMap<String, DoubleSummaryStatistics> stats =
items.parallelStream().collect(Collectors.groupingByConcurrent(
Item::category,
Collectors.summarizingDouble(Item::value)
));
new TreeMap<>(stats).forEach((category, s) ->
System.out.printf(Locale.ROOT,
"%s: count=%d sum=%.1f min=%.1f max=%.1f avg=%.1f%n",
category, s.getCount(), s.getSum(), s.getMin(),
s.getMax(), s.getAverage()));
}
}Rezultat
A: count=2 sum=6.0 min=2.0 max=4.0 avg=3.0 B: count=1 sum=8.0 min=8.0 max=8.0 avg=8.0
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.