CKTIS / Java
Nebenläufiges Gruppieren und Zählen in Java
`Collectors.groupingByConcurrent` gruppiert Stream-Elemente nach Schlüsseln und kann die Elemente je Kategorie zählen, ohne ihre ursprüngliche Reihenfolge zu erhalten.
Version: Java SE 21
Syntax
Declared in java.util.stream.Collectors:
public static <T, K> Collector<T, ?, ConcurrentMap<K, List<T>>> groupingByConcurrent(Function<? super T, ? extends K> classifier)
public static <T, K, A, D> Collector<T, ?, ConcurrentMap<K, D>> groupingByConcurrent(Function<? super T, ? extends K> classifier, Collector<? super T, A, D> downstream)
public static <T, K, A, D, M extends ConcurrentMap<K, D>> Collector<T, ?, M> groupingByConcurrent(Function<? super T, ? extends K> classifier, Supplier<M> mapFactory, Collector<? super T, A, D> downstream)In Java SE 21 erzeugt die statische Methode Collectors.groupingByConcurrent aus java.util.stream einen Kollektor für Stream.collect. Die Klassifizierungsfunktion classifier ordnet jedem Element vom Typ T einen Schlüssel vom Typ K zu. Der Kollektor funktioniert auch mit einem sequenziellen Stream und schaltet ihn nicht selbst auf parallele Verarbeitung um.
Mit nur classifier entsteht eine ConcurrentMap<K, List<T>>. Mit classifier, downstream reduziert der nachgeschaltete Kollektor die Elemente jeder Gruppe zu einem Ergebnis vom Typ D; das ergibt eine ConcurrentMap<K, D>. Collectors.counting() liefert beispielsweise für jeden vorkommenden Schlüssel eine Anzahl vom Typ Long, ohne Listen der Elemente anzulegen.
Bei classifier, mapFactory, downstream liefert die Fabrik eine neue, leere Map vom Typ M, der ConcurrentMap<K, D> implementiert. ConcurrentSkipListMap::new ermöglicht beispielsweise, die Schlüssel in sortierter Reihenfolge zu durchlaufen, stellt aber die Eingabereihenfolge innerhalb der Gruppen nicht wieder her. Ohne Fabrik garantiert die API weder die konkrete Implementierung noch die Veränderbarkeit oder Serialisierbarkeit der Map. Eine nebenläufige Map macht die Listen der ersten Überladung nicht threadsicher.
Alle drei Überladungen sind CONCURRENT und UNORDERED. Bei einem parallelen Stream kann collect auch mit einer geordneten Quelle nebenläufig in einer gemeinsamen Map sammeln; unordered() ist nicht nötig. Die Reihenfolge, in der die Elemente im Stream auftreten, wird innerhalb einer Gruppe nicht garantiert.
Collectors.groupingBy ist kein nebenläufiger Kollektor, kann aber korrekt mit parallelen Streams verwendet werden: Teil-Maps werden getrennt aufgebaut und anschließend zusammengeführt. Verwende ihn mit einem reihenfolgeerhaltenden nachgeschalteten Kollektor wie toList(), wenn bei einem geordneten Stream die Reihenfolge innerhalb der Gruppen wichtig ist. Nebenläufiges Gruppieren kann das Zusammenführen der Teil-Maps vermeiden, ist aber nicht garantiert schneller. Miss die Leistung mit repräsentativen Daten.
Beispiele
import java.util.List;
import java.util.TreeMap;
import java.util.concurrent.ConcurrentMap;
import java.util.function.Function;
import java.util.stream.Collectors;
public class Main {
public static void main(String[] args) {
List<String> categories = List.of("book", "game", "book", "music", "game", "book");
ConcurrentMap<String, Long> counts = categories.parallelStream()
.collect(Collectors.groupingByConcurrent(
Function.identity(), Collectors.counting()));
System.out.println(new TreeMap<>(counts));
}
}Ergebnis
{book=3, game=2, music=1}`Function.identity()` verwendet die Kategoriezeichenfolge selbst als Schlüssel. `Collectors.counting()` zählt jedes Vorkommen. Nach Abschluss von `collect` sortiert eine `TreeMap`-Kopie die Schlüssel nur für die Ausgabe.
Zugehörige Lektionen
- Java · Lektion 43 · Fortgeschritten · Version: 2
Quellen
- Collectors (Java SE 21 & JDK 21) — groupingByConcurrent(Function)
- Collectors (Java SE 21 & JDK 21) — groupingByConcurrent(Function, Collector)
- Collectors (Java SE 21 & JDK 21) — groupingByConcurrent(Function, Supplier, Collector)
- Collectors (Java SE 21 & JDK 21) — counting()
- Collectors (Java SE 21 & JDK 21) — groupingBy(Function, Collector)
- Stream (Java SE 21 & JDK 21) — collect(Collector)
- java.util.stream (Java SE 21 & JDK 21) — Reduction, concurrency, and ordering