Что делает метод distinct() в Java Stream API?

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

Ответ

Метод distinct() — это промежуточная операция в Java Stream API, которая возвращает поток, состоящий из уникальных элементов (удаляет дубликаты).

Особенности:

  • Для определения уникальности используется метод equals() и hashCode() объектов.
  • Это stateful intermediate operation (операция с состоянием), которая может требовать дополнительной памяти и не подходит для бесконечных потоков.
  • Порядок уникальных элементов в результирующем потоке соответствует порядку их первого появления в исходном потоке (для упорядоченных потоков).

Примеры:

// 1. Удаление дубликатов из списка строк
List<String> names = Arrays.asList("Alice", "Bob", "Alice", "Charlie", "Bob");
List<String> uniqueNames = names.stream()
                                .distinct()
                                .collect(Collectors.toList());
// Результат: ["Alice", "Bob", "Charlie"]

// 2. Удаление дубликатов из списка чисел
List<Integer> numbers = Arrays.asList(1, 2, 1, 3, 2, 4);
long count = numbers.stream().distinct().count();
// Результат count: 4

// 3. Работа с пользовательскими объектами
// Для корректной работы класса Person должен переопределять equals() и hashCode()
List<Person> people = ...;
List<Person> uniquePeople = people.stream()
                                  .distinct()
                                  .collect(Collectors.toList());

Важно: Если distinct() применяется после операций, меняющих элементы (например, map), сравнение происходит уже для преобразованных значений.