Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Collectors.groupingBy: référence pratique

Collectors.groupingBy: référence pratique: Collectors.groupingBy classe les éléments par une fonction de clé et construit une Map ; les surcharges choisissent map supplier et downstream.

Version : Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Syntaxe

Collectors.groupingBy(...)

Collectors.groupingBy classe les éléments par une fonction de clé et construit une Map ; les surcharges choisissent map supplier et downstream.

À utiliser pour des index et résumés, par exemple par longueur de chaîne.

Java SE ne garantit pas les clés de classification null : le classifier ne doit pas en renvoyer ; OpenJDK 21 vérifié lance NullPointerException. La forme simple ne garantit ni type de Map ni sûreté multithread.

Un stream vide donne une Map vide ; l’ordre des clés exige un supplier explicite.

L’exemple exerce l’élément documenté dans un petit programme déterministe et compare exactement la sortie standard.

Exemples

public class Main {
    public static void main(String[] args) throws Exception {
        var grouped = java.util.stream.Stream.of("a", "bb", "c")
                .collect(java.util.stream.Collectors.groupingBy(String::length, java.util.TreeMap::new, java.util.stream.Collectors.toList()));
        System.out.println(grouped);
    }
}

Résultat

{1=[a, c], 2=[bb]}

L’exemple exerce l’élément documenté dans un petit programme déterministe et compare exactement la sortie standard.

Sources