Ответ
Метод 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().