jpa，querydsl 原生sql 查询分页，动态参数

<think>好的，用户现在想了解如何在JpaRepository中使用方法查询进行条件查询，特别是用法和示例。根据用户提供的引用内容，我需要结合之前的回答和引用中的信息来构建一个清晰的解答。首先，用户提到了几个引用，其中引用[2]、[3]、[4]和[5]都涉及到JpaRepository的条件查询方法。比如引用[4]中的UserRepository接口，展示了方法名查询的示例，如findByUserName、findByUserNameAndAge等。这说明用户可能已经了解到通过方法命名规则进行查询的方式，但需要更详细的解释和示例。接下来，我需要回顾之前的回答，用户之前的问题是关于JpaRepository的多表关联查询，现在转向了更基础的方法查询条件。这可能意味着用户对JpaRepository的使用还不够熟悉，需要从简单条件查询开始了解。用户的问题核心是方法查询的条件查询用法和示例，所以我需要分步骤解释JpaRepository支持的几种条件查询方式，包括方法名约定、@Query注解、Example查询等。同时，要结合引用中的示例代码，如引用[4]中的代码，展示具体的实现方法。需要注意用户可能存在的误区，比如方法名的拼写规则，参数顺序是否正确，以及如何处理更复杂的条件。例如，用户可能想知道如何实现模糊查询或者范围查询，这时候需要提供对应的示例，如findByNameLike或findByAgeBetween。此外，用户可能对动态条件查询感兴趣，比如如何根据不同的参数组合查询，这时候可以提到使用JPA Specification或者Querydsl，但根据用户的问题，可能更倾向于基本的方法名约定和@Query注解。需要确保回答结构清晰，分点说明每种方法，并给出代码示例。同时，引用相关的引用内容，如引用[2]中提到的JpaRepository支持接口规范方法名查询，引用[4]中的具体方法示例，来增强回答的可信度。 最后，生成的相关问题需要围绕方法查询的进一步应用，如动态排序、复杂条件组合等，帮助用户深入理解。</think>### JpaRepository 方法查询条件查询详解 #### 一、基于方法命名规则的查询（核心方法） 通过规范的方法命名自动生成查询逻辑[^2]，适用于简单条件组合： ```java public interface UserRepository extends JpaRepository<User, Integer> { // 精确匹配（等于） User findByUserName(String userName); // 等价 WHERE user_name = ? [^4] // 多条件 AND 连接 List<User> findByUserNameAndAge(String userName, Integer age); // WHERE user_name=? AND age=? // 模糊查询（LIKE） List<User> findByUserNameLike(String pattern); // WHERE user_name LIKE ? // 范围查询 List<User> findByAgeBetween(int min, int max); // WHERE age BETWEEN ? AND ? // 空值判断 List<User> findByEmailIsNull(); // 排序控制 List<User> findByAgeGreaterThanOrderByCreateTimeDesc(int age); // WHERE age > ? ORDER BY create_time DESC } ``` **关键命名规则**： - `属性名`：必须与实体类字段名严格匹配（区分大小写） - `条件关键词`：`And`/`Or`/`Between`/`LessThan`/`IsNull`等 - `排序控制`：`OrderBy[属性名][Asc/Desc]` #### 二、@Query 注解自定义查询 当方法名过于复杂时，使用 JPQL 或原生 SQL 实现[^2]： ```java // JPQL 查询（推荐） @Query("SELECT u FROM User u WHERE u.age > :minAge AND u.createTime < :endDate") List<User> findActiveUsers(@Param("minAge") int age, @Param("endDate") LocalDateTime date); // 原生 SQL 查询（需严格匹配结果集） @Query(value = "SELECT * FROM users WHERE DATEDIFF(NOW(), last_login) > 30", nativeQuery = true) List<User> findInactiveUsers(); ``` **参数绑定方式**： 1. 位置参数：`?1`、`?2`（易出错，不推荐） 2. 命名参数：`:paramName` + `@Param`注解（推荐） #### 三、动态条件查询（Example 查询） 适用于不确定查询条件的场景： ```java // 创建 Example 模板 User probe = new User(); probe.setName("张%"); // 设置模糊查询条件 ExampleMatcher matcher = ExampleMatcher.matching() .withMatcher("name", match -> match.startsWith()) // 姓名以"张"开头 .withIgnorePaths("age"); // 忽略age字段 List<User> results = userRepository.findAll(Example.of(probe, matcher)); ``` **支持的匹配模式**： - `exact`：精确匹配（默认） - `contains`：包含模式（LIKE %value%） - `start`/`ending`：开头/结尾匹配 #### 四、分页与排序组合查询 结合`Pageable`参数实现分页排序[^5]： ```java // 创建分页请求（页码从0开始） Pageable pageable = PageRequest.of(0, 10, Sort.by("createTime").descending()); // 方法名查询分页 Page<User> page1 = userRepository.findByAgeGreaterThan(18, pageable); // @Query 分页查询 @Query("SELECT u FROM User u WHERE u.status = 1") Page<User> findActiveUsers(Pageable pageable); ``` **返回类型选择**： - `List<User>`：仅获取数据 - `Page<User>`：包含分页元数据（总页数、当前页码等） - `Slice<User>`：轻量级分页（不计算总数） #### 五、复合条件处理技巧 1. **Optional 处理空结果**： ```java Optional<User> optionalUser = userRepository.findByEmail("[email protected]"); optionalUser.ifPresent(user -> System.out.println(user.getName())); ``` 2. **流式处理结果集**： ```java try (Stream<User> stream = userRepository.findAllByStatus("ACTIVE")) { stream.filter(u -> u.getAge() > 30) .forEach(System.out::println); } ``` 3. **修改查询（需加@Modifying）**： ```java @Modifying @Query("UPDATE User u SET u.loginCount = u.loginCount + 1 WHERE u.id = :userId") int incrementLoginCount(@Param("userId") Long id); ``` --- ### 最佳实践建议 1. **索引优化**：对`WHERE`条件中的高频查询字段添加`@Index` ```java @Entity @Table(indexes = @Index(name = "idx_user_name", columnList = "userName")) public class User { /*...*/ } ``` 2. **N+1 查询规避**：使用`@EntityGraph`预加载关联数据 ```java @EntityGraph(attributePaths = {"orders"}) List<User> findByCompanyId(Long companyId); ``` 3. **查询结果缓存**：添加`@Cacheable`注解 ```java @Cacheable("users") User findByEmployeeId(String empId); ``` ---