1. 概述
在这篇文章中，我们将介绍如何在 Hibernate 中使用 JPA 静态元模型类来编写 Criteria 查询。
如果你对 Hibernate 的 Criteria 查询 API 还不太熟悉，建议先阅读我们之前的教程 Criteria Queries，以便更好地理解本文内容。
2. 为什么要使用 JPA 元模型？
在编写 Criteria 查询时，我们经常需要引用实体类及其属性。一种常见的做法是直接使用字符串来表示属性名，例如 "firstName" 或 "gradYear"。
✅ 优点：写起来简单
❌ 缺点：容易出错、难以维护
比如，一旦字段名在项目后期被修改了，所有使用字符串硬编码的地方都需要手动更新，否则就会在运行时报错。而且 IDE 也无法提供自动补全或重构支持。
为了解决这些问题，社区引入了 JPA Metamodel（元模型） 机制，它提供了对实体元数据的静态访问方式，避免了字符串硬编码带来的问题。
3. 实体类示例
假设我们要为客户开发一个学生管理系统，并且有一个需求是根据毕业年份查询学生信息。
我们先来看一下 Student 实体类：
@Entity
@Table(name = "students")
public class Student {
@Id
@GeneratedValue(strategy = GenerationType.AUTO)
private int id;
@Column(name = "first_name")
private String firstName;
@Column(name = "last_name")
private String lastName;
@Column(name = "grad_year")
private int gradYear;
// 标准 getter 和 setter
}
4. 生成 JPA 元模型类
要使用元模型，首先需要生成对应的元模型类。我们可以使用 JBoss 提供的工具 来自动生成这些类。
除了 JBoss，还有其他一些工具也支持元模型生成，如：
以 JBoss 工具为例，在 Maven 项目中添加如下依赖即可：
<dependency>
<groupId>org.hibernate</groupId>
<artifactId>hibernate-jpamodelgen</artifactId>
<version>6.1.7.Final</version>
</dependency>
然后执行 Maven 构建命令，工具会自动在 target/generated-classes 目录下生成元模型类。
⚠️ 注意：你需要将 target/generated-classes 添加到你的 IDE classpath 中，否则 IDE 可能无法识别这些类。
5. 静态 JPA 元模型类详解
按照 JPA 规范，每个实体类都会生成一个对应的元模型类，命名规则为：原类名 + 下划线 _。
例如，对于 Student 类，生成的元模型类就是 Student_，其内容如下：
@Generated(value = "org.hibernate.jpamodelgen.JPAMetaModelEntityProcessor")
@StaticMetamodel(Student.class)
public abstract class Student_ {
public static volatile SingularAttribute<Student, String> firstName;
public static volatile SingularAttribute<Student, String> lastName;
public static volatile SingularAttribute<Student, Integer> id;
public static volatile SingularAttribute<Student, Integer> gradYear;
public static final String FIRST_NAME = "firstName";
public static final String LAST_NAME = "lastName";
public static final String ID = "id";
public static final String GRAD_YEAR = "gradYear";
}
这些静态属性可以让我们在构建查询时获得编译期检查和 IDE 支持。
6. 使用 JPA 元模型类
现在我们可以用元模型类替代字符串方式来引用属性，提升类型安全性和可维护性。
下面是一个查询 2015 年毕业的所有学生的例子：
// session 初始化代码略
CriteriaBuilder cb = session.getCriteriaBuilder();
CriteriaQuery<Student> criteriaQuery = cb.createQuery(Student.class);
Root<Student> root = criteriaQuery.from(Student.class);
criteriaQuery.select(root).where(cb.equal(root.get(Student_.gradYear), 2015));
Query<Student> query = session.createQuery(criteriaQuery);
List<Student> results = query.getResultList();
可以看到，我们使用的是 Student_.gradYear 而不是 "grad_year" 字符串。这样做的好处包括：
✅ 编译期类型检查
✅ IDE 自动补全支持
✅ 重构友好
7. 总结
本文介绍了如何使用 JPA 静态元模型类来增强 Criteria 查询的安全性和可维护性。相比传统的字符串引用方式，元模型能够有效避免因字段名变更导致的运行时错误。
相关源码可以在 GitHub 上找到。