如何利用Hibernate 6简写语法简化JPA查询中的枚举全限定名？

一、什么是Hibernate 6的枚举简写语法 #

在Hibernate 5及更早版本中，HQL/JPA查询里引用枚举必须写全限定名（FQN），比如你代码里的com.example.entity.EmailStatus$Description.ACTIVE，得包含完整包路径、外部类和内部枚举类的名称。

Hibernate 6新增的简写语法，允许直接用枚举类的简单名称（比如Description.ACTIVE）引用枚举值，不用再写冗长的全限定路径。核心逻辑是Hibernate 6会自动识别查询上下文里已关联的枚举类型——比如实体类直接使用的枚举，或是通过HQL的import语句显式导入的枚举，都能直接用简单名称调用。

二、怎么简化你的代码 #

你的场景里，Description是EmailStatus的内部枚举，而UserEmail实体又关联了EmailStatus，所以Hibernate 6的查询上下文已经能自动识别Description这个枚举类，无需额外配置，直接替换全限定名即可：

修改后的完整代码：

@Query("""
        SELECT email
        FROM UserEmail email
        WHERE email.emailStatus.description = Description.ACTIVE
        """)
Optional<UserEmail> findAllWithActiveStatus();

额外注意事项 #

• 必须确保项目使用Hibernate 6.x及以上版本，这个特性是Hibernate 6才新增的，低版本不支持。
• 如果要引用的枚举不是实体关联的类型，可以在HQL开头添加import语句手动导入，比如：

  import com.example.entity.SomeOtherEnum;
  SELECT ... WHERE ... = SomeOtherEnum.VALUE
  

• 这个简写是Hibernate对JPA规范的扩展，所以@Query不能指定nativeQuery=true（原生SQL不支持该特性，仅HQL模式下生效）。

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