JPA动态条件查询

<think>好的，用户想了解如何在JPA中实现动态条件查询，特别是动态构建查询条件的示例教程。我需要结合提供的引用内容，整理出清晰的步骤和方法。 首先，根据引用[1]，CriteriaBuilder是JPA中用来构建查询条件的接口，提供了各种条件方法，如equal、like、greaterThan等，以及组合条件的方法and和or。这是动态查询的核心工具。 然后，引用[3]提到Example查询，可以通过实体对象和匹配器来创建查询条件。这可能适合简单的情况，但复杂条件可能需要CriteriaBuilder。 引用[2]指出@Query注解可以定义查询，但动态性可能不足，需要结合其他方法。而引用[4]展示了一个方法参数@RequestBody，可能涉及将DTO转换为查询条件。 接下来，我需要分步骤说明动态查询的实现方法。首先是使用CriteriaBuilder的方式，需要创建CriteriaQuery，使用Root、Predicate等，组合多个条件。例如，根据不同的参数是否存在来添加条件，最后执行查询。 其次是Example查询，适用于简单字段匹配，但无法处理范围查询或复杂组合条件。需要创建ExampleMatcher来配置匹配规则。 然后是@Query注解结合SpEL表达式，可以动态拼接JPQL语句，但可能不够灵活，适合条件较少的情况。 最后，可能需要将不同的方法结合起来使用，比如根据参数动态选择查询方式，或者在Service层处理逻辑。 在示例部分，使用CriteriaBuilder构建动态查询的代码示例是关键，需要展示如何逐步添加条件。例如，根据用户名模糊查询，年龄范围，部门精确匹配等，最后组合成Predicate列表，并用and连接。 可能需要注意的地方包括：如何管理多个条件之间的组合，避免空指针异常，以及如何正确使用CriteriaBuilder的方法。 用户可能的问题包括性能优化、复杂条件组合、与分页排序的结合等，这些可以作为相关问题列出。需要确保回答准确，引用正确的来源，如引用[1]提到的方法。 最后检查是否符合格式要求，数学表达式是否正确使用$，独立公式用$$，中文回答，生成相关问题。确保引用标识正确，如[^1]在对应的引用位置。</think>在JPA中实现动态条件查询主要有三种方式：Criteria API、Example查询和@Query注解拼接。以下是具体实现步骤和示例： ### 一、Criteria API（最灵活的方式） 1. **创建CriteriaBuilder对象** 通过`EntityManager.getCriteriaBuilder()`获取，用于构建查询条件。 2. **定义查询主体** ```java CriteriaQuery<Order> query = cb.createQuery(Order.class); Root<Order> root = query.from(Order.class); List<Predicate> predicates = new ArrayList<>(); ``` 3. **动态添加条件** ```java if (searchDTO.getUserName() != null) { predicates.add(cb.like(root.get("userName"), "%" + searchDTO.getUserName() + "%")); // 模糊查询 } if (searchDTO.getMinAge() != null) { predicates.add(cb.greaterThan(root.get("age"), searchDTO.getMinAge())); // 大于条件 } ``` 4. **组合查询条件** ```java query.where(cb.and(predicates.toArray(new Predicate[0]))); // AND组合 ``` 5. **执行查询** ```java TypedQuery<Order> typedQuery = entityManager.createQuery(query); return typedQuery.getResultList(); ``` ### 二、Example查询（简单字段匹配） ```java Order exampleOrder = new Order(); exampleOrder.setStatus("PAID"); ExampleMatcher matcher = ExampleMatcher.matching() .withIgnoreNullValues() .withMatcher("userName", match -> match.contains().ignoreCase()); List<Order> result = orderRepository.findAll(Example.of(exampleOrder, matcher)); // 精确匹配+忽略大小写[^3] ``` ### 三、@Query注解动态拼接 ```java @Query("SELECT o FROM Order o WHERE " + "(:keyword IS NULL OR o.orderNo LIKE %:keyword%) AND " + "(:status IS NULL OR o.status = :status)") List<Order> findByConditions(@Param("keyword") String keyword, @Param("status") String status); // 使用NULL检查实现动态条件[^2] ``` ### 完整示例代码 ```java public List<Order> dynamicQuery(SearchDTO dto) { CriteriaBuilder cb = entityManager.getCriteriaBuilder(); CriteriaQuery<Order> query = cb.createQuery(Order.class); Root<Order> root = query.from(Order.class); List<Predicate> predicates = new ArrayList<>(); if (dto.getOrderNo() != null) { predicates.add(cb.like(root.get("orderNo"), "%" + dto.getOrderNo() + "%")); } if (dto.getMinAmount() != null) { predicates.add(cb.greaterThanOrEqualTo(root.get("amount"), dto.getMinAmount())); } if (dto.getDepartments() != null) { predicates.add(root.get("department").in(dto.getDepartments())); // IN查询 } query.orderBy(cb.desc(root.get("createTime"))); // 动态排序[^1] query.where(predicates.toArray(new Predicate[0])); return entityManager.createQuery(query).getResultList(); } ```