Что делает метод flatMap в Stream API

flatMap преобразует каждый элемент стрима в новый стрим, а затем объединяет все полученные стримы в один. Это полезно, когда элемент стрима содержит вложенные коллекции или другие стримы.

Пример:

List<List<String>> nestedList = Arrays.asList(
    Arrays.asList("a", "b"),
    Arrays.asList("c", "d")
);

List<String> flatList = nestedList.stream()
    .flatMap(Collection::stream)
    .collect(Collectors.toList());
// Результат: [a, b, c, d]

Ключевые особенности:

1. Принимает Function<T, Stream<R>>
2. "Разворачивает" вложенные структуры
3. Возвращает Stream<R>
4. Может преобразовывать один элемент в 0, 1 или много элементов