Что возвращает anyMatch?

Метод anyMatch(): Полное объяснение

Краткий ответ

anyMatch() возвращает boolean: true если хотя бы один элемент потока соответствует условию, иначе false. Это терминальная операция Stream API (не ленивая, выполняется сразу).

Сигнатура метода

// Stream API
public abstract boolean anyMatch(Predicate<? super T> predicate);

// Predicate: функция, которая возвращает true или false
public interface Predicate<T> {
    boolean test(T t);
}

// Пример использования
Stream<Integer> numbers = Stream.of(1, 2, 3, 4, 5);
boolean hasEven = numbers.anyMatch(n -> n % 2 == 0); // true (числа 2, 4)

Основные примеры

Пример 1: Простая проверка

List<Integer> numbers = Arrays.asList(1, 3, 5, 7);
boolean hasEven = numbers.stream()
    .anyMatch(n -> n % 2 == 0);
// Результат: false (нет чётных чисел)

List<Integer> numbers2 = Arrays.asList(1, 3, 5, 8);
boolean hasEven2 = numbers2.stream()
    .anyMatch(n -> n % 2 == 0);
// Результат: true (есть 8)

Пример 2: Проверка объектов

public class User {
    private String name;
    private int age;
    private boolean active;
    
    public boolean isAdult() {
        return age >= 18;
    }
}

List<User> users = Arrays.asList(
    new User("Alice", 25, true),
    new User("Bob", 17, false),
    new User("Charlie", 30, true)
);

// Есть ли взрослые пользователи?
boolean hasAdults = users.stream()
    .anyMatch(user -> user.getAge() >= 18);
// Результат: true (Alice и Charlie взрослые)

// Есть ли активные пользователи?
boolean hasActive = users.stream()
    .anyMatch(User::isActive);
// Результат: true (Alice и Charlie активны)

Пример 3: Проверка строк

List<String> emails = Arrays.asList(
    "user@gmail.com",
    "admin@company.com",
    "test@example.org"
);

// Есть ли email на gmail?
boolean hasGmail = emails.stream()
    .anyMatch(email -> email.contains("@gmail.com"));
// Результат: true

// Есть ли email, который пустой?
boolean hasEmpty = emails.stream()
    .anyMatch(String::isEmpty);
// Результат: false (все имеют текст)

// Есть ли email короче 10 символов?
boolean hasShort = emails.stream()
    .anyMatch(email -> email.length() < 10);
// Результат: false (все длинные)

Как anyMatch() работает внутри

Шаг за шагом

public class AnyMatchExplanation {
    public static void main(String[] args) {
        List<Integer> numbers = Arrays.asList(1, 2, 3, 4, 5);
        
        boolean result = numbers.stream()
            .anyMatch(n -> {
                System.out.println("Проверяю число: " + n);
                return n % 2 == 0; // true если чётное
            });
        
        System.out.println("Результат: " + result);
    }
}

// Вывод:
// Проверяю число: 1  → false, продолжаем
// Проверяю число: 2  → true, СТОП! Возвращаем true
// (числа 3, 4, 5 НЕ будут проверены)

// Результат: true

Ключевой момент: anyMatch() прерывается сразу как только находит первый элемент, соответствующий условию. Это эффективно для больших потоков.

Поток выполнения

public class StreamFlowExample {
    public static void main(String[] args) {
        List<Integer> numbers = Arrays.asList(10, 20, 30, 40, 50);
        
        boolean hasOver100 = numbers.stream()
            .filter(n -> {
                System.out.println("filter: " + n);
                return n > 25; // пропускаем числа <= 25
            })
            .anyMatch(n -> {
                System.out.println("anyMatch проверяет: " + n);
                return n > 35;
            });
        
        System.out.println("Результат: " + hasOver100);
    }
}

// Вывод:
// filter: 10      (10 <= 25, исключаем)
// filter: 20      (20 <= 25, исключаем)
// filter: 30      (30 > 25, пропускаем дальше)
// anyMatch проверяет: 30  (30 > 35? false, продолжаем)
// filter: 40      (40 > 25, пропускаем дальше)
// anyMatch проверяет: 40  (40 > 35? true, СТОП!)
// Результат: true

// Числа 50 не было проверено! (ленивое вычисление прервалось)

Сравнение с allMatch() и noneMatch()

List<Integer> numbers = Arrays.asList(2, 4, 6, 8);

// anyMatch: есть ли ХОТЬ БЫ один чётный?
boolean anyEven = numbers.stream().anyMatch(n -> n % 2 == 0);
// true (есть несколько чётных)

// allMatch: ВСЕ ли чётные?
boolean allEven = numbers.stream().allMatch(n -> n % 2 == 0);
// true (все числа чётные)

// noneMatch: НИ ОДИН не чётный?
boolean noneEven = numbers.stream().noneMatch(n -> n % 2 == 0);
// false (есть чётные, поэтому не true, что никто не чётный)

// Таблица сравнения
// List: [1, 2, 3, 4, 5]
// anyMatch(n % 2 == 0)  → true  (есть 2, 4)
// allMatch(n % 2 == 0)  → false (есть 1, 3, 5)
// noneMatch(n % 2 == 0) → false (есть 2, 4)

// List: [1, 3, 5, 7]
// anyMatch(n % 2 == 0)  → false (нет чётных)
// allMatch(n % 2 == 0)  → false (есть нечётные)
// noneMatch(n % 2 == 0) → true  (все нечётные)

Практические примеры из реальной разработки

Пример 1: Валидация данных

@Service
public class PaymentValidator {
    public void validateOrder(Order order) throws ValidationException {
        // Проверяем: есть ли хотя бы один товар в заказе?
        if (!order.getItems().stream().anyMatch(item -> item.getPrice() > 0)) {
            throw new ValidationException("Order has no valid items");
        }
        
        // Проверяем: есть ли товар с ценой ниже минимальной?
        if (order.getItems().stream().anyMatch(item -> item.getPrice() < 0.01)) {
            throw new ValidationException("Item price is too low");
        }
    }
}

Пример 2: Проверка прав доступа

@Service
public class AuthorizationService {
    public boolean userHasPermission(User user, String requiredPermission) {
        // Есть ли у пользователя нужное разрешение?
        return user.getRoles().stream()
            .anyMatch(role -> role.getPermissions()
                .stream()
                .anyMatch(perm -> perm.getName().equals(requiredPermission))
            );
    }
    
    public boolean isUserAdmin(User user) {
        return user.getRoles().stream()
            .anyMatch(role -> role.getName().equals("ADMIN"));
    }
}

Пример 3: Проверка на production issues

@Service
@AllArgsConstructor
public class HealthCheckService {
    private final DatabaseService dbService;
    private final CacheService cacheService;
    private final ExternalApiService externalApi;
    
    public boolean isSystemDown() {
        List<ServiceHealth> services = Arrays.asList(
            dbService.getHealth(),
            cacheService.getHealth(),
            externalApi.getHealth()
        );
        
        // Система вниз, если ХОТЯ БЫ один сервис down
        return services.stream()
            .anyMatch(health -> health.getStatus() == Status.DOWN);
    }
    
    public boolean hasAnyErrors() {
        return services.stream()
            .anyMatch(service -> service.getLastError() != null);
    }
}

Пример 4: Фильтрация данных для отправки уведомления

@Service
@AllArgsConstructor
public class NotificationService {
    public void notifyIfNeeded(List<User> users) {
        // Отправляем уведомление, если есть хотя бы один активный пользователь
        if (users.stream().anyMatch(User::isActive)) {
            sendNotification(users);
        }
        
        // Отправляем alert, если есть хотя бы один пользователь с просроченной подпиской
        if (users.stream().anyMatch(user -> user.getSubscription().isExpired())) {
            sendAlertToBillingTeam(users);
        }
    }
}

Performance и оптимизация

Важно: anyMatch() прерывается рано

public class PerformanceComparison {
    
    // Плохой подход: нужно проверять ВСЕ элементы
    public boolean hasActiveUserBad(List<User> users) {
        return users.stream()
            .map(user -> {
                System.out.println("Загружаю профиль для: " + user.getName());
                return user.getProfile(); // дорогая операция!
            })
            .anyMatch(profile -> profile.isActive());
    }
    // Результат: даже если первый пользователь активен,
    // мы загрузим профили для ВСЕХ пользователей
    // (потому что map() не знает о условии в anyMatch())
    
    // Хороший подход: фильтруем ДО дорогой операции
    public boolean hasActiveUserGood(List<User> users) {
        return users.stream()
            .anyMatch(user -> {
                System.out.println("Проверяю: " + user.getName());
                return user.getProfile().isActive(); // дорогая операция
            });
    }
    // Результат: загружаем профили только до первого активного юзера!
}

// Запуск на 1000 пользователях, 10-й активен
hasActiveUserBad:  загружает профили 1000 юзеров
hasActiveUserGood: загружает профили 10 юзеров (100x быстрее!)

Когда использовать anyMatch()

Хорошие примеры:

// ✓ Быстрая проверка на существование
boolean hasAdmin = users.stream().anyMatch(u -> u.isAdmin());

// ✓ Валидация
boolean isValid = items.stream().anyMatch(item -> item.getPrice() < 0);
if (isValid) throw new Exception();

// ✓ Optional check
boolean canProcess = data.stream().anyMatch(d -> d != null);

Плохие примеры:

// ✗ Если нужно найти КОНКРЕТНЫЙ элемент
User admin = users.stream()
    .anyMatch(u -> u.isAdmin()) // возвращает boolean!
    // используй .filter().findFirst() вместо этого

// ✗ Если нужно трансформировать данные
List<Integer> squared = numbers.stream()
    .anyMatch(n -> n > 5) // это не подходит
    // используй .map() вместо этого

Итоговый вывод

anyMatch() возвращает boolean:

• true если хотя бы один элемент соответствует условию
• false если ни один элемент не соответствует
• Прерывается рано как только находит первый true (эффективно)
• Терминальная операция (выполняется сразу, не ленива)
• Используется для простых проверок (есть ли, валидна ли, может ли)

Сравнение:

• anyMatch(condition) → true если есть хотя бы один, соответствующий condition
• allMatch(condition) → true если ВСЕ соответствуют condition
• noneMatch(condition) → true если НИ ОДИН не соответствует condition
• filter().anyMatch() → неправильно (filter уже вернёт пустой stream если ничего не подходит)