Hibernate HQL 核心语法详解与实战技巧

注意： 通过 new 关键字构造的对象只包含构造函数中指定的字段，其他状态未初始化，不能用于更新操作。

此外，HQL 支持统计函数和去重：

// 聚合查询
String hql = "select count(*), min(user.age) from TUser as user";

// 去重
String distinctHql = "select distinct user.name from TUser as user";

批量更新与删除

在 Hibernate 3 及更高版本中，提供了高效的批量操作接口，无需先加载实体再修改。

// 批量更新
Query updateQuery = session.createQuery("update TUser set age = 18 where id = ?");
int rows = updateQuery.executeUpdate();

// 批量删除
Query deleteQuery = session.createQuery("delete TUser where age >= 18");
rows = deleteQuery.executeUpdate();

这种方式直接生成 SQL 执行，不触发实体生命周期回调，性能远高于循环加载后逐个保存。

分组与排序

处理复杂报表时，分组和排序必不可少。

// 排序
String orderByHql = "from TUser user order by user.name, user.age desc";

// 分组与筛选
String groupByHql = "select count(user), user.age from TUser user group by user.age having count(user) > 10";

参数绑定

硬编码值不仅不安全，还容易引发注入攻击。推荐使用参数绑定。

位置占位符

// 问号占位符
Query query = session.createQuery("from TUser user where user.name = ? and user.age > ?");
query.setString(0, "Erica");
query.setInteger(1, 20);

// 或者传递数组（旧版 API 常见）
Object[] args = {"Erica", 20};
Type[] types = {Hibernate.STRING, Hibernate.INTEGER};
// 现代版本推荐直接使用 setParameter 链式调用

命名占位符

String hql = "from TUser where name = :name";
Query query = session.createQuery(hql);
query.setParameter("name", "Erica");

对象属性映射

可以将查询条件封装为 JavaBean，利用反射自动映射属性：

class UserQuery {
    private String name;
    private Integer age;
    // getter/setter
}

UserQuery uq = new UserQuery();
uq.setName("Erica");
uq.setAge(20);

Query query = session.createQuery("from TUser where name = :name and age = :age");
query.setProperties(uq); // 需确保类名与属性名匹配
query.list();

联合查询

多表关联查询同样支持标准的 Join 语法：

// 内连接
String innerJoin = "from TUser t join t.address a";

// 左外连接
String leftJoin = "from TUser t left outer join t.address a";

// 隐式关联（逗号分隔）
String commaJoin = "from TUser t, TAddress a where t.id = a.userId";

实际开发中，优先使用显式的 join 语法，语义更清晰，便于维护。

掌握 HQL 的精髓在于理解其与面向对象编程的结合点。合理使用参数绑定、批量操作以及投影查询，能显著提升数据访问层的性能与安全性。