JPA/Hibernate动态复杂查询如何实现动态参数绑定？

你原来的JDBC写法核心是根据非空参数动态拼接查询条件，JPA下有几种成熟的实现方式：

方案1：动态拼接JPQL + 命名参数绑定 #

你可以沿用类似JDBC的拼接逻辑，但是把占位符换成命名参数，同时用JPA的Query接口绑定参数，不需要像JDBC那样逐个拼=条件，列表参数直接用IN语句即可，和你原有逻辑的迁移成本最低，示例代码：

// 构建查询语句
public String buildFilteredQuery(List<Long> extensions, List<Long> categories, Long courseId) {
    StringBuilder jpql = new StringBuilder("SELECT f FROM File f WHERE 1=1 ");
    if (!extensions.isEmpty()) {
        jpql.append("AND f.fileExtensionId IN :extensions ");
    }
    if (!categories.isEmpty()) {
        jpql.append("AND f.categoryId IN :categories ");
    }
    if (courseId != null) {
        jpql.append("AND f.courseId = :courseId ");
    }
    return jpql.toString();
}

// 执行查询绑定参数
public List<File> executeFilteredQuery(List<Long> extensions, List<Long> categories, Long courseId) {
    String jpql = buildFilteredQuery(extensions, categories, courseId);
    Query query = entityManager.createQuery(jpql);
    // 仅绑定非空的参数
    if (!extensions.isEmpty()) {
        query.setParameter("extensions", extensions);
    }
    if (!categories.isEmpty()) {
        query.setParameter("categories", categories);
    }
    if (courseId != null) {
        query.setParameter("courseId", courseId);
    }
    return query.getResultList();
}

IN语句的效果和你原来拼接多个OR的逻辑完全一致，代码更简洁。

方案2：使用JPA Criteria API #

如果要避免字符串拼接的硬编码问题，可以用JPA自带的类型安全的Criteria API实现动态查询：

public List<File> findByFilters(List<Long> extensions, List<Long> categories, Long courseId) {
    CriteriaBuilder cb = entityManager.getCriteriaBuilder();
    CriteriaQuery<File> cq = cb.createQuery(File.class);
    Root<File> fileRoot = cq.from(File.class);
    
    List<Predicate> predicates = new ArrayList<>();
    if (!extensions.isEmpty()) {
        predicates.add(fileRoot.get("fileExtensionId").in(extensions));
    }
    if (!categories.isEmpty()) {
        predicates.add(fileRoot.get("categoryId").in(categories));
    }
    if (courseId != null) {
        predicates.add(cb.equal(fileRoot.get("courseId"), courseId));
    }
    
    cq.where(predicates.toArray(new Predicate[0]));
    return entityManager.createQuery(cq).getResultList();
}

方案3：Spring Data JPA Specification（适用于集成Spring Data JPA的项目） #

如果项目已经集成了Spring Data JPA，可以直接用Specification封装查询条件，代码更简洁：
首先让你的Repository接口继承JpaSpecificationExecutor<File>：

public interface FileRepository extends JpaRepository<File, Long>, JpaSpecificationExecutor<File> {
}

然后构建Specification动态条件：

public Specification<File> buildFilterSpecification(List<Long> extensions, List<Long> categories, Long courseId) {
    return (root, query, cb) -> {
        List<Predicate> predicates = new ArrayList<>();
        if (!extensions.isEmpty()) {
            predicates.add(root.get("fileExtensionId").in(extensions));
        }
        if (!categories.isEmpty()) {
            predicates.add(root.get("categoryId").in(categories));
        }
        if (courseId != null) {
            predicates.add(cb.equal(root.get("courseId"), courseId));
        }
        return cb.and(predicates.toArray(new Predicate[0]));
    };
}

调用的时候直接传入Specification即可：

List<File> result = fileRepository.findAll(buildFilterSpecification(extensions, categories, courseId));

内容的提问来源于stack exchange，提问作者Delsh