Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Collectors: sažete statistike i konkurentno grupiranje

Klasa java.util.stream.Collectors nudi collectore za Stream.collect. Kombinirajte Collectors.groupingByConcurrent s Collectors.summarizingDouble kako biste zasebno izračunali numeričke sažete statistike za svaku grupu.

Verzija: 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 nudi ponovno upotrebljive strategije redukcije za završnu operaciju Stream.collect. Collectori se mogu kombinirati: vanjski collector oblikuje grupe, a nizvodni collector računa rezultat svake grupe. Ovaj se zapis odnosi na Java SE 21; produkcijsko okruženje izvođenja nije potvrđeno.

Collectors.summarizingDouble(mapper) vraća Collector<T, ?, DoubleSummaryStatistics>. Kad se upotrijebi u Stream.collect, collector primjenjuje mapper na svaki element kako bi dobio vrijednost tipa double. Rezultat operacije collect jest objekt DoubleSummaryStatistics koji sadrži broj elemenata, zbroj, minimum, maksimum i prosjek. Za prazan ulaz broj elemenata, zbroj i prosjek iznose nula, minimum je Double.POSITIVE_INFINITY, a maksimum Double.NEGATIVE_INFINITY. Zaokruživanje može promijeniti zbroj i prosjek; vrijednosti NaN utječu na statistiku.

I Collectors.groupingByConcurrent(classifier) i preopterećena inačica s nizvodnim collectorom vraćaju collector. Kad se upotrijebi u Stream.collect, prvi daje ConcurrentMap<K, List<T>>, a drugi ConcurrentMap<K, D>. Oba su collectora konkurentna i imaju svojstvo UNORDERED: ne jamče očuvanje redoslijeda pojavljivanja elemenata u toku, ali ga ne isključuju. Primjerice, pri sekvencijalnom prikupljanju elementi u listi svake grupe mogu ostati u redoslijedu kojim su se pojavili u toku. Nasuprot tome, groupingBy nije konkurentni collector. Za same rezultirajuće liste nije zajamčena sigurnost pri pristupu iz više dretvi.

Konkurentna redukcija zahtijeva paralelni stream; sam collector ga ne pokreće. Funkcije trebaju biti bez stanja i ne smiju mijenjati izvor. Konkurentna mapa ne čini naknadne izmjene njezinih vrijednosti DoubleSummaryStatistics sigurnima za pristup iz više dretvi. Primjer sortira ključeve tek prije ispisa; male, točno predstavljive vrijednosti čine statistike predvidljivima.

Primjeri

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

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

Izvori