Formations — 1 037 leçons en français

Accueil › Java › Les collecteurs

Les collecteurs

Les streamsintermediaire

collect(Collector) est l'opération terminale la plus flexible : elle délègue l'accumulation à un objet Collector, le plus souvent pioché dans Collectors.

List<String> noms = catalogue.stream()
    .map(Produit::nom)
    .collect(Collectors.toList());          // ArrayList modifiable

List<String> nomsImmuables = catalogue.stream()
    .map(Produit::nom)
    .toList();                              // liste non modifiable (raccourci depuis Java 16)

Les collecteurs courants : toList/toSet/toUnmodifiableList, joining (concaténation de chaînes), counting, summingInt/averagingDouble/summarizingInt (agrégats numériques).

groupingBy regroupe par clé de classification, avec un collecteur en aval optionnel pour dire ce que contient chaque groupe :

Map<String, Long> nbParCategorie = catalogue.stream()
    .collect(Collectors.groupingBy(Produit::categorie, Collectors.counting()));

partitioningBy est un cas particulier de groupingBy avec une clé booléenne : toujours exactement deux groupes (true/false).

toMap(clé, valeur) lève une exception sur une clé en double — il faut alors la variante à trois arguments avec une fonction de fusion.

Les termes à connaître

collect(Collector)

Opération terminale générique qui accumule les éléments d'un stream dans un résultat quelconque (collection, Map, chaîne, valeur agrégée…), en déléguant toute la logique à un objet Collector fourni, le plus souvent via la classe utilitaire Collectors.

groupingBy

Collecteur qui regroupe les éléments par clé de classification dans une Map<K, List<T>> (par défaut). Un second argument, un collecteur en aval, change ce que contient chaque groupe (counting(), summingInt(), mapping()…) au lieu de la liste brute.

partitioningBy

Cas particulier de groupingBy où la clé de classification est un boolean : produit toujours une Map<Boolean, List<T>> avec exactement deux entrées (true et false), même si l'une des deux est vide.

toMap et les clés en double

Collectors.toMap(clé, valeur) lève une IllegalStateException (« Duplicate key ») si deux éléments produisent la même clé. Une variante à trois arguments accepte une fonction de fusion ((v1, v2) -> ...) pour résoudre les doublons.

teeing

Collecteur qui applique deux collecteurs en parallèle sur le même stream, puis combine leurs deux résultats en un seul via une fonction de fusion — utile pour calculer plusieurs agrégats en un seul parcours.

Collectors.reducing

Variante de reduce() sous forme de collecteur, utilisable comme collecteur en aval d'un groupingBy. Exige, comme reduce(), une opération associative.

stream.toList() vs collect(Collectors.toList())

stream.toList() (depuis Java 16) est un raccourci qui renvoie une liste non modifiable. collect(Collectors.toList()) ne garantit rien sur la mutabilité du résultat, mais renvoie en pratique une ArrayList modifiable.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.