CKTIS / Java
Stream.flatMap: referência prática
Stream.flatMap: referência prática: flatMap é uma operação intermédia um-para-muitos que substitui cada elemento pelo conteúdo de um stream produzido pelo mapper e achata os resultados.
Versão: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Sintaxe
Stream.flatMap(...)flatMap é uma operação intermédia um-para-muitos que substitui cada elemento pelo conteúdo de um stream produzido pelo mapper e achata os resultados.
Usa-a para expandir coleções aninhadas, linhas em palavras ou relações pai-filhos em que cada origem produz zero ou vários resultados.
O mapper deve ser stateless e non-interfering; cada stream produzido é fechado após consumir o conteúdo e não deve voltar a ser usado.
Um stream null devolvido pelo mapper é tratado como vazio; elementos null dentro do stream mapeado podem prosseguir e uma fonte ordenada mantém a ordem.
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 result = java.util.stream.Stream.of(java.util.List.of(1, 2), java.util.List.of(3)).flatMap(java.util.Collection::stream).toList();
System.out.println(result);
}
}
Resultado
[1, 2, 3]
O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.