Как Spring позволяет реализовать в методе с аннотацией Query в Repository добавить сложную Java логику

Добавление логики в @Query методы Spring Data Repository

Вопрос касается интеграции Java-логики в SQL-запросы Spring Data. Вот несколько подходов для реализации сложной бизнес-логики рядом с @Query аннотацией.

Подход 1: Использование @Query с плейсхолдерами

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    
    @Query(value = """
        SELECT u FROM User u 
        WHERE u.age >= :minAge 
        AND u.createdAt >= :date
        AND u.status = 'ACTIVE'
        ORDER BY u.createdAt DESC
    """)
    List<User> findActiveUsersSinceDate(
        @Param("minAge") int minAge,
        @Param("date") LocalDateTime date
    );
}

Метод контроллера обрабатывает результат и добавляет дополнительную логику:

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;
    
    public List<UserDto> getFilteredUsers(int minAge, LocalDateTime date) {
        List<User> users = userRepository.findActiveUsersSinceDate(minAge, date);
        
        // Добавляем сложную Java-логику
        return users.stream()
            .filter(u -> u.hasValidEmail())
            .filter(u -> calculateScore(u) > 50)
            .map(UserDto::fromEntity)
            .sorted(Comparator.comparing(UserDto::getScore).reversed())
            .collect(Collectors.toList());
    }
}

Подход 2: Использование SpEL (Spring Expression Language)

Spring позволяет использовать выражения для динамических фильтров:

@Query(value = """
    SELECT u FROM User u 
    WHERE (:#{#user.minAge} IS NULL OR u.age >= :#{#user.minAge})
    AND (:#{#user.status} IS NULL OR u.status = :#{#user.status})
""")
List<User> findByDynamicCriteria(@Param("user") UserFilter filter);

Подход 3: Кастомная реализация Repository

Это наиболее гибкий подход для сложной логики:

// Интерфейс с кастомными методами
public interface UserRepositoryCustom {
    List<User> findByComplexCriteria(UserSearchRequest request);
}

// Реализация
@Repository
public class UserRepositoryCustomImpl implements UserRepositoryCustom {
    @PersistenceContext
    private EntityManager em;
    
    @Override
    public List<User> findByComplexCriteria(UserSearchRequest request) {
        CriteriaBuilder cb = em.getCriteriaBuilder();
        CriteriaQuery<User> cq = cb.createQuery(User.class);
        Root<User> root = cq.from(User.class);
        
        // Построение динамических предикатов
        List<Predicate> predicates = new ArrayList<>();
        
        if (request.getMinAge() != null) {
            predicates.add(cb.ge(root.get("age"), request.getMinAge()));
        }
        
        if (request.getStatus() != null) {
            predicates.add(cb.equal(root.get("status"), request.getStatus()));
        }
        
        // Сложная логика для рангирования
        if (request.isRanked()) {
            cq.orderBy(cb.desc(root.get("score")));
        }
        
        cq.where(cb.and(predicates.toArray(new Predicate[0])));
        return em.createQuery(cq).getResultList();
    }
}

// Основной интерфейс расширяет кастомный
public interface UserRepository 
    extends JpaRepository<User, Long>, UserRepositoryCustom {
}

Подход 4: Использование Specification (предпочтительно)

public class UserSpecifications {
    public static Specification<User> activeUsersOlderThan(int age) {
        return (root, query, cb) -> cb.and(
            cb.equal(root.get("status"), "ACTIVE"),
            cb.ge(root.get("age"), age)
        );
    }
    
    public static Specification<User> createdSince(LocalDateTime date) {
        return (root, query, cb) -> cb.ge(root.get("createdAt"), date);
    }
}

// Использование в Repository
public interface UserRepository extends JpaRepository<User, Long>, 
    JpaSpecificationExecutor<User> {
}

// В сервисе
@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;
    
    public List<User> findFiltered(int age, LocalDateTime date) {
        Specification<User> spec = 
            UserSpecifications.activeUsersOlderThan(age)
                .and(UserSpecifications.createdSince(date));
        
        return userRepository.findAll(spec);
    }
}

Рекомендации

• Простые фильтры: используй @Query с параметрами
• Средняя сложность: используй Specification
• Высокая сложность: кастомная реализация Repository
• Post-processing: всегда можно обработать результаты в Java-коде после получения из БД