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

«Что делает метод flatMap в Java Stream API?» — вопрос из категории Java Core, который задают на 10% собеседований Java Разработчик. Ниже — развёрнутый ответ с разбором ключевых моментов.

Ответ

Метод flatMap преобразует каждый элемент потока (Stream) в новый поток, а затем объединяет ("склеивает") все полученные потоки в один результирующий. Это ключевой инструмент для работы с вложенными структурами данных.

Зачем он нужен? map преобразует 1 элемент в 1 новый элемент. flatMap позволяет преобразовать 1 элемент в 0, 1 или множество элементов, "разворачивая" вложенность.

Пример: преобразование списка списков в плоский список

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

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

Другой пример: разбиение строк

List<String> words = Arrays.asList("Hello World", "Java Streams");
List<String> uniqueLetters = words.stream()
    .flatMap(phrase -> Arrays.stream(phrase.split(""))) // 1 строка -> много символов
    .distinct()
    .collect(Collectors.toList());
// Результат: ["H", "e", "l", "o", " ", "W", "r", "d", "J", "a", "v", "S", "t", "m", "s"]

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

  • Сигнатура: <R> Stream<R> flatMap(Function<T, Stream<R>> mapper)
  • Принимает функцию, которая возвращает Stream (а не одиночное значение).
  • Полезен для работы с Optional в Java 9+: optional.stream().