Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Collectors.groupingBy: referência prática

Collectors.groupingBy: referência prática: Collectors.groupingBy classifica por função de chave e cria Map; overloads escolhem map supplier e downstream.

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

Sintaxe

Collectors.groupingBy(...)

Collectors.groupingBy classifica por função de chave e cria Map; overloads escolhem map supplier e downstream.

Usa-o em índices e resumos, por exemplo por comprimento de cadeia.

Java SE não garante chaves de classificação null: o classifier não as deve devolver; o OpenJDK 21 verificado lança NullPointerException. A forma simples não garante tipo Map nem segurança de threads.

Um stream vazio dá Map vazio; a ordem das chaves exige supplier explícito.

O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.

Exemplos

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);
    }
}

Resultado

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

O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.

Fontes