Hibernate中Session接口createQuery(String)方法弃用相关疑问咨询

1. createQuery(String) 被弃用的原因及替代方案 #

• 弃用核心原因：缺乏类型安全。该方法返回无类型的Query对象，HQL语句中的实体类名、属性名错误只能在运行时暴露，无法在编译期检查，增加了调试成本和潜在bug风险。
• 替代方案并非不存在，官方推荐的替代方式包括：
  • 带实体类型参数的createQuery(String queryString, Class<T> resultClass)：返回TypedQuery<T>，支持编译期类型检查，示例：

    TypedQuery<User> query = session.createQuery("from User u where u.name = :name", User.class);
    query.setParameter("name", "Alice");
    List<User> users = query.getResultList();
    

  • createMutationQuery(String queryString)：专门用于DML操作（删除、更新、插入），返回MutationQuery，更贴合修改类操作的场景。
  • 命名查询createNamedQuery(String name, Class<T> resultClass)：将HQL语句定义在实体注解或XML中，复用性更强且同样支持类型安全。

2. 支持字符串HQL的删除操作替代方法 #

完全存在支持字符串HQL的删除操作方法，推荐使用以下两种：

• 使用带类型参数的createQuery：针对删除操作，可指定返回类型为Integer（代表受影响行数），示例：

  int deletedCount = session.createQuery("delete from User u where u.id = :userId", Integer.class)
                          .setParameter("userId", 1001)
                          .executeUpdate();
  

• 使用createMutationQuery：Hibernate 5.4+引入的专门用于DML的API，更语义化，无需指定结果类型，示例：

  int deletedCount = session.createMutationQuery("delete from User u where u.status = 'DISABLED'")
                          .executeUpdate();
  

补充：为何执行正常却被标记弃用？ #

弃用标记仅表示官方不再推荐使用该方法，不代表当前版本无法运行。官方的目的是引导开发者转向更安全、更易维护的类型安全API，避免因HQL拼写错误导致的运行时异常，同时这类老旧API可能在未来的Hibernate版本中被移除。

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