Java中怎么实现条件查询？有哪些常用方法？

在Java中实现条件查询是数据处理中的常见需求，尤其在数据库操作、业务逻辑处理等场景中广泛应用，条件查询允许开发者根据动态生成的过滤条件从数据集中筛选出符合要求的结果，本文将详细介绍Java中实现条件查询的几种主流方法，包括原生SQL拼接、动态SQL框架、JPA Criteria API以及Spring Data JPA的Specification接口,并分析各自的优缺点及适用场景。

原生SQL拼接实现条件查询

原生SQL拼接是最基础的方式，通过手动构建SQL语句的WHERE子句来实现条件查询，这种方式适用于简单的查询需求，但在复杂场景下容易引发SQL注入风险且维护性较差，实现时，通常使用StringBuilder动态拼接SQL片段，并通过PreparedStatement参数化查询来防止SQL注入。

StringBuilder sql = new StringBuilder("SELECT * FROM user WHERE 1=1");
List<Object> params = new ArrayList<>();
if (name != null && !name.isEmpty()) {
    sql.append(" AND name LIKE ?");
    params.add("%" + name + "%");
}
if (age != null) {
    sql.append(" AND age > ?");
    params.add(age);
}
PreparedStatement ps = connection.prepareStatement(sql.toString());
for (int i = 0; i < params.size(); i++) {
    ps.setObject(i + 1, params.get(i));
}
ResultSet rs = ps.executeQuery();

优点：简单直观，无需额外依赖。
缺点：SQL拼接复杂时代码冗余，易出错；缺乏类型安全,需手动处理参数类型转换。

动态SQL框架实现条件查询

为解决原生SQL拼接的痛点，MyBatis等动态SQL框架提供了更优雅的解决方案，MyBatis通过XML映射文件或注解支持动态SQL语法，如<if>、<where>、<choose>等标签,可根据条件动态组装SQL语句。

<select id="findUsers" resultType="User">
    SELECT * FROM user
    <where>
        <if test="name != null and name != ''">
            AND name LIKE #{name}
        </if>
        <if test="age != null">
            AND age > #{age}
        </if>
    </where>
</select>

在Java代码中，通过Mapper接口直接调用该方法，MyBatis会自动解析动态SQL并执行查询。

优点：SQL与代码分离，可读性强；支持复杂动态逻辑，避免SQL注入。
缺点：需学习框架语法；对于简单查询可能显得过于复杂。

JPA Criteria API实现条件查询

使用JPA（Java Persistence API）的Criteria API可以通过Java代码动态构建查询条件，避免手动编写SQL，Criteria API提供了一套类型安全的API，适合基于JPA的ORM框架（如Hibernate），实现步骤包括：获取CriteriaBuilder、创建CriteriaQuery、构建Predicate条件组合等。

CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<User> query = cb.createQuery(User.class);
Root<User> root = query.from(User.class);
List<Predicate> predicates = new ArrayList<>();
if (name != null && !name.isEmpty()) {
    predicates.add(cb.like(root.get("name"), "%" + name + "%"));
}
if (age != null) {
    predicates.add(cb.gt(root.get("age"), age));
}
query.where(predicates.toArray(new Predicate[0]));
List<User> results = entityManager.createQuery(query).getResultList();

优点：完全类型安全，编译时检查；与JPA无缝集成，适合复杂对象关系查询。
缺点：API较为繁琐，代码可读性较差；对于简单查询效率较低。

Spring Data JPA的Specification接口

Spring Data JPA在Criteria API基础上封装了Specification接口，进一步简化动态查询的实现。Specification是一个函数式接口，允许通过lambda表达式定义查询条件。

public interface UserRepository extends JpaRepository<User, Long>, JpaSpecificationExecutor<User> {
}
// 使用Specification查询
List<User> results = userRepository.findAll((root, query, cb) -> {
    List<Predicate> predicates = new ArrayList<>();
    if (name != null && !name.isEmpty()) {
        predicates.add(cb.like(root.get("name"), "%" + name + "%"));
    }
    if (age != null) {
        predicates.add(cb.gt(root.get("age"), age));
    }
    return cb.and(predicates.toArray(new Predicate[0]));
});

Spring Data JPA还支持Example查询，通过构建Example对象实现简单的条件匹配：

User probe = new User();
probe.setName("John");
ExampleMatcher matcher = ExampleMatcher.matching()
    .withStringMatcher(ExampleMatcher.StringMatcher.CONTAINING);
Example<User> example = Example.of(probe, matcher);
List<User> results = userRepository.findAll(example);

优点：代码简洁，支持lambda表达式；可复用Specification组合复杂条件。
缺点：仅适用于Spring Data JPA环境；复杂查询仍需编写较多代码。

选择建议与最佳实践

1. 简单查询：若查询条件固定且简单，可直接使用Spring Data JPA的@Query注解或方法名查询（如findByName）。
2. 动态条件：对于需要动态组装条件的场景，优先选择Specification接口，兼顾类型安全与开发效率。
3. 复杂SQL：若涉及复杂SQL或存储过程，MyBatis的动态SQL能力更灵活。
4. 性能优化：无论哪种方式，都应避免N+1查询问题，合理使用JOIN或FETCH关联查询。
5. 安全防护：始终使用参数化查询或框架提供的防注入机制,杜绝SQL注入风险。

Java中实现条件查询的方法多样，开发者需根据项目需求、技术栈和团队技能选择合适的方案，原生SQL拼接适合快速实现简单需求，动态SQL框架（如MyBatis）提供了更强大的SQL控制能力，而JPA Criteria API与Spring Data JPA的Specification则通过类型安全和函数式编程提升了开发效率和代码可维护性，在实际应用中，合理结合多种方法，并遵循最佳实践，才能构建高效、安全的数据查询逻辑。