Hibernate查询案例

wen java案例 2026-08-10 2

本文目录导读：

Hibernate查询案例

目录导读
Hibernate查询体系概览
基础查询案例：HQL与Criteria API
高级查询：动态条件与分页排序
性能优化：N+1问题与批量抓取
常见异常与解决方案（FAQ）
总结与最佳实践建议

Hibernate查询实战指南：从基础到性能优化的完整案例解析

目录导读

Hibernate查询体系概览
基础查询案例：HQL与Criteria API
高级查询：动态条件与分页排序
性能优化：N+1问题与批量抓取
常见异常与解决方案（FAQ）
总结与最佳实践建议

Hibernate查询体系概览

Hibernate作为Java领域最经典的ORM框架，其查询方式经历了从HQL（Hibernate Query Language）到Criteria API，再到如今Spring Data JPA（底层仍基于Hibernate）的演进，理解查询的本质需要抓住三条主线：面向对象的HQL、类型安全的Criteria、原生SQL的SQLQuery。

核心机制：所有查询最终都会转化为SQL，但Hibernate提供了缓存、懒加载、自动状态同步等增强能力，在选择查询方式时，优先级建议为：Criteria API（动态条件） > HQL（固定复杂查询） > Native SQL（特殊数据库特性）。

基础查询案例：HQL与Criteria API

1 HQL基础查询

HQL直接操作实体对象,例如查询所有用户：

String hql = "FROM User WHERE age > :minAge";
List<User> users = session.createQuery(hql, User.class)
    .setParameter("minAge", 18)
    .list();

关键点：HQL使用类名而非表名，支持属性导航（如u.address.city）。

2 Criteria API类型安全查询

JPA标准Criteria适合动态组合条件：

CriteriaBuilder cb = session.getCriteriaBuilder();
CriteriaQuery<User> cq = cb.createQuery(User.class);
Root<User> root = cq.from(User.class);
cq.select(root).where(cb.greaterThan(root.get("age"), 18));
List<User> users = session.createQuery(cq).getResultList();

实际开发推荐：使用JpaSpecificationExecutor或QueryDSL，它们能自动生成元模型类,避免字符串硬编码。

高级查询：动态条件与分页排序

1 动态多条件查询（QBC）

场景：用户列表筛选（姓名、部门、状态动态组合）。

public List<User> searchUsers(String name, String dept, Integer status) {
    CriteriaBuilder cb = session.getCriteriaBuilder();
    CriteriaQuery<User> cq = cb.createQuery(User.class);
    Root<User> root = cq.from(User.class);
    List<Predicate> predicates = new ArrayList<>();
    if (name != null && !name.isEmpty()) {
        predicates.add(cb.like(root.get("name"), "%" + name + "%"));
    }
    if (dept != null) {
        predicates.add(cb.equal(root.get("dept"), dept));
    }
    if (status != null) {
        predicates.add(cb.equal(root.get("status"), status));
    }
    cq.where(predicates.toArray(new Predicate[0]));
    return session.createQuery(cq).getResultList();
}

2 分页与排序最佳实践

Query<User> query = session.createQuery("FROM User ORDER BY createTime DESC", User.class);
query.setFirstResult((pageNum - 1) * pageSize);
query.setMaxResults(pageSize);

注意：分页必须在查询线程内执行，避免懒加载失效,排序字段最好加索引。

性能优化：N+1问题与批量抓取

1 N+1问题案例

当查询100个用户并访问每个用户的dept属性时，Hibernate默认会执行101条SQL（1条主查询 + 100条子查询）。

解决方案一：JOIN FETCH

String hql = "FROM User u JOIN FETCH u.dept";

解决方案二：@BatchSize

@Entity
public class User {
    @ManyToOne
    @BatchSize(size = 20)  // 批量加载，每20个用户一次性查部门
    private Dept dept;
}

2 二级缓存与查询缓存

对于数据变动少但频繁查询的场景（如字典表）,启用二级缓存：

@Cache(usage = CacheConcurrencyStrategy.READ_WRITE)
@Entity
public class Dict { ... }

并在配置中开启：

<property name="cache.use_second_level_cache">true</property>

常见异常与解决方案（FAQ）

Q1：`org.hibernate.LazyInitializationException` 怎么解决？

原因：Session已关闭，但仍在访问懒加载属性。方案：

在事务内完成所有属性访问（推荐）
或使用Hibernate.initialize(proxy)强制初始化
或配置spring.jpa.open-in-view=false并改用DTO投影

Q2：HQL查询返回`Object[]`而非实体，如何转换？

使用DTO构造器表达式：

String hql = "SELECT new com.example.UserDTO(u.id, u.name) FROM User u";
List<UserDTO> list = session.createQuery(hql).list();

Q3：查询结果集过大导致内存溢出？

使用ScrollableResults游标分批处理：

try (ScrollableResults results = session.createQuery("FROM User").scroll()) {
    while (results.next()) {
        User user = (User) results.get(0);
        // 处理逻辑
    }
}