Что такое Spring Data Specification?

Spring Data Specification — это интерфейс из модуля Spring Data JPA, позволяющий создавать динамические запросы к базе данных, основанные на Criteria API JPA. Он предоставляет типизированный способ определения предикатов (условий фильтрации) для запросов, что делает их более читаемыми и поддерживаемыми по сравнению с нативным SQL или JPQL.

Основные компоненты:

• Specification<T>: Главный интерфейс. Метод toPredicate(Root<T> root, CriteriaQuery<?> query, CriteriaBuilder criteriaBuilder) возвращает предикат, который будет применен к запросу.
• Root<T>: Представляет корневую сущность в выражении запроса. Позволяет обращаться к полям сущности.
• CriteriaQuery<?>: Представляет конструктор запроса.
• CriteriaBuilder: Предоставляет методы для создания различных предикатов (равенство, неравенство, like, greater than, less than и т.д.), логических операторов (AND, OR, NOT) и агрегатных функций.

Преимущества использования Specification:

• Типизация: Избавляет от необходимости использовать строковые имена полей при построении запросов, уменьшая вероятность ошибок.
• Переиспользование: Позволяет создавать спецификации для общих условий фильтрации и комбинировать их.
• Читаемость: Код, построенный с помощью Specification, более нагляден и понятен, чем сложные JPQL-запросы, особенно при наличии многих условий.
• Тестируемость: Отдельные спецификации легче тестировать изолированно.
• Безопасность: Помогает предотвратить SQL-инъекции, так как условия строятся программно, а не из строковых выражений.

Пример использования:

interface UserRepository extends JpaRepository<User, Long>, JpaSpecificationExecutor<User> {
}

// Спецификация для поиска пользователей по имени
public static Specification<User> hasName(String name) {
    return (root, query, criteriaBuilder) ->
            criteriaBuilder.equal(root.get("name"), name);
}

// Спецификация для поиска активных пользователей
public static Specification<User> isActive() {
    return (root, query, criteriaBuilder) ->
            criteriaBuilder.equal(root.get("active"), true);
}

// Использование спецификаций
// userRepository.findAll(Specification.where(hasName("John")).and(isActive()));

Интерфейс JpaSpecificationExecutor<T> должен быть реализован вашим репозиторием, чтобы получить доступ к методам, принимающим Specification (например, findAll, findOne, count).