@Query相关配置

<think>好的，用户想了解Spring Data JPA中@Query注解的用法和配置示例。我需要先回忆相关的知识，并参考提供的引用内容。 首先，用户提到了引用[1]和引用[2]，其中引用[2]详细介绍了@Query的基本使用和实例。我需要确保回答覆盖基本用法、参数绑定、分页处理以及原生SQL支持等内容。 接下来，要检查是否需要包含配置参数，比如nativeQuery和countQuery。用户的问题提到了配置方法，所以这些参数必须解释清楚。例如，nativeQuery用于切换JPQL和原生SQL，而countQuery在分页查询时使用。 然后，考虑示例代码的展示。用户提供的引用中有测试方法的代码，但需要转换到@Query的示例。例如，展示如何在Repository接口中使用@Query注解，绑定HQL或SQL语句，以及参数的不同绑定方式（索引参数和命名参数）。 还要注意是否需要提到排序和分页的处理，比如使用Pageable参数，并返回Page类型。这在实际开发中很常见，用户可能想知道如何结合@Query实现分页查询。 另外，用户可能想知道@Query的优先级，如引用[2]中提到的@Query优先级高于@NamedQuery，这点应该包含在回答中。 最后，生成相关问题时要围绕@Query的常见疑问，比如参数绑定方式、原生SQL的使用、分页支持以及动态查询的可能性。确保问题有针对性，帮助用户深入理解。</think>以下关于Spring Data JPA中@Query注解的用法及配置说明： ### 一、@Query注解基础用法 1. **声明式查询绑定** 通过直接在Repository接口方法上使用`@Query`注解，可以绑定自定义的JPQL或原生SQL语句。其优先级高于自动生成的查询语句和`@NamedQuery`[^2]。 ```java @Query("SELECT u FROM User u WHERE u.id = ?1") User findByIdHql(Long id); ``` 2. **参数绑定方式** - **索引参数**：使用`?1`、`?2`格式按参数位置绑定 ```java @Query("SELECT u FROM User u WHERE u.age > ?1 AND u.status = ?2") List<User> findByAgeAndStatus(int minAge, String status); ``` - **命名参数**：结合`@Param`注解绑定（需要Java 8+） ```java @Query("SELECT u FROM User u WHERE u.name = :name") User findByName(@Param("name") String username); ``` ### 二、进阶配置参数 1. **nativeQuery参数** 设置为`true`时执行原生SQL查询： ```java @Query(value = "SELECT * FROM users WHERE email LIKE %?1%", nativeQuery = true) List<User> findByEmailPattern(String pattern); ``` 2. **分页查询支持** 结合`Pageable`参数和返回类型`Page<T>`： ```java @Query("SELECT u FROM User u WHERE u.dept = ?1") Page<User> findByDepartment(String department, Pageable pageable); ``` 3. **countQuery配置** 为分页查询提供自定义count语句： ```java @Query(value = "SELECT * FROM users WHERE active = true", countQuery = "SELECT COUNT(*) FROM users WHERE active = true", nativeQuery = true) Page<User> findActiveUsers(Pageable pageable); ``` ### 三、特殊场景处理 1. **更新操作** 需添加`@Modifying`注解配合事务： ```java @Modifying @Query("UPDATE User u SET u.status = :status WHERE u.id = :id") @Transactional int updateUserStatus(@Param("id") Long userId, @Param("status") String newStatus); ``` 2. **排序处理** 动态排序可通过Pageable参数实现： ```java @Query("SELECT u FROM User u WHERE u.age > :minAge") List<User> findUsersAboveAge(@Param("minAge") int age, Sort sort); ``` ### 四、验证与调试 在测试类中通过注入Repository进行验证（如引用[1]所示）： ```java @Test void testCustomQuery() { User user = userRepository.findByIdHql(7L); assertThat(user.getName()).isEqualTo("testUser"); } ```