🛒 Collectors: Собираем урожай Stream API

Мы отфильтровали, преобразовали и отсортировали данные. Теперь их нужно сложить в коробочку, чтобы использовать дальше. Для этого существует терминальная операция .collect().

Внутрь нее мы передаем специальный объект - Collector. Чтобы не писать его вручную, в Java есть утилитный класс Collectors с готовыми решениями на все случаи жизни.

📦 Базовый набор (Must Have)

1. В список или множество
💙Collectors.toList() - собирает все в ArrayList (но тип не гарантирован).
💙Collectors.toSet() - собирает в HashSet (убирает дубликаты).
💙Java 16+ Update: Теперь можно просто писать .toList() прямо у стрима, без collect(...). Это создает неизменяемый список.


2. В строку (joining)
💙Больше не нужно мучиться с StringBuilder в циклах.
💙Collectors.joining(", ") - склеит строки через запятую.



🔑 Продвинутый уровень: Карты и Группировки

Самая мощная магия происходит здесь.

3. В Map (toMap)
Превращает список объектов в Map (ключ-значение).
💙Синтаксис: toMap(Function keyMapper, Function valueMapper)
💙Важно: Если ключи совпадут, вылетит IllegalStateException.
💙Лечение: Третий аргумент - "мердж-функция" (что делать при конфликте).


4. Группировка (groupingBy)
Аналог GROUP BY из SQL. Это киллер-фича Stream API.
💙Разделяет элементы на группы по какому-то признаку и кладет их в Map<Критерий, Список>.


💻 Примеры в коде

Представьте, у нас есть класс User(String name, String role).

List<User> users = List.of(
    new User("Alex", "ADMIN"),
    new User("Bob", "USER"),
    new User("Charlie", "USER")
);

// 1. Склеиваем имена в одну строку
String names = users.stream()
    .map(User::getName)
    .collect(Collectors.joining(", "));
// Результат: "Alex, Bob, Charlie"

// 2. Превращаем в Map: Имя -> Роль
Map<String, String> userMap = users.stream()
    .collect(Collectors.toMap(
        User::getName, // Ключ
        User::getRole  // Значение
    ));
// Результат: {Alex=ADMIN, Bob=USER, Charlie=USER}

// 3. Группируем по Роли (SQL GROUP BY)
Map<String, List<User>> byRole = users.stream()
    .collect(Collectors.groupingBy(User::getRole));
// Результат: 
// { 
//   "ADMIN": [User(Alex)], 
//   "USER":  [User(Bob), User(Charlie)] 
// }

⚡ Полезный лайфхак

В groupingBy можно передать второй коллектор! Например, чтобы не просто сгруппировать пользователей, а сразу посчитать их количество в каждой группе:

Map<String, Long> countByRole = users.stream()
    .collect(Collectors.groupingBy(
        User::getRole, 
        Collectors.counting() // Downstream collector
    ));
// Результат: {ADMIN=1, USER=2}

🔥 Итог

Collectors позволяют превратить поток данных в любую удобную структуру: от простого списка до сложной многоуровневой мапы.

#Java #StreamAPI #Collectors #JavaTips

📲 Мы в MAX

👉@BookJava