Hibernate 5.2非SQL实现咨询：当前最佳实践及标准用法

嘿，针对你提到的Hibernate 5.2里偏好无SQL代码风格的需求，我来给你梳理下当前的标准最佳实践——其实你注意到的EntityManager替代Session的方向完全是对的，这正是Hibernate 5.x版本开始对齐JPA规范后的首选路径。

下面详细拆解这种风格的实现方式：

核心API选择：EntityManager 是官方首选 #

Hibernate 5.2里，传统的Session API已经逐渐被JPA标准的EntityManager取代，原因很简单：EntityManager是跨ORM框架通用的标准API，同时完全兼容Hibernate的所有特性（包括HQL、Criteria、实体映射等）。Session本质上是EntityManager的底层实现，所以优先用EntityManager是当前的最佳实践。

无SQL操作的核心实现方式 #

1. 基础实体CRUD操作（零SQL写法） #

直接通过EntityManager的内置方法操作实体，完全不需要编写SQL语句：

// Spring环境下可通过@PersistenceContext注入EntityManager
@PersistenceContext
private EntityManager entityManager;

// 新增实体
public void saveUser(User user) {
    entityManager.persist(user);
}

// 根据ID查询实体
public User getUserById(Long id) {
    return entityManager.find(User.class, id);
}

// 更新实体
public void updateUser(User user) {
    entityManager.merge(user);
}

// 删除实体（处理游离态实体的兼容逻辑）
public void deleteUser(User user) {
    entityManager.remove(entityManager.contains(user) ? user : entityManager.merge(user));
}

2. HQL查询（面向对象的查询语言） #

如果需要复杂查询，用HQL替代SQL——它基于实体类和属性编写，完全不用关心数据库表结构：

// 查询所有启用状态的用户
public List<User> getEnabledUsers() {
    String hql = "SELECT u FROM User u WHERE u.enabled = :enabled";
    return entityManager.createQuery(hql, User.class)
                       .setParameter("enabled", true)
                       .getResultList();
}

3. Criteria API（类型安全的动态查询） #

如果需要动态拼接查询条件，Criteria API是更优选择——它是完全类型安全的，编译期就能发现错误，避免字符串拼接HQL的风险：

// 动态查询：根据用户名模糊匹配 + 启用状态筛选
public List<User> searchUsers(String usernameKeyword, Boolean enabled) {
    CriteriaBuilder cb = entityManager.getCriteriaBuilder();
    CriteriaQuery<User> query = cb.createQuery(User.class);
    Root<User> root = query.from(User.class);

    List<Predicate> predicates = new ArrayList<>();
    if (usernameKeyword != null && !usernameKeyword.isEmpty()) {
        predicates.add(cb.like(root.get("username"), "%" + usernameKeyword + "%"));
    }
    if (enabled != null) {
        predicates.add(cb.equal(root.get("enabled"), enabled));
    }

    query.where(cb.and(predicates.toArray(new Predicate[0])));
    return entityManager.createQuery(query).getResultList();
}

关于传统Session的兼容说明 #

如果你之前习惯使用Session，Hibernate 5.2仍然保留了对它的支持，但官方不推荐在新代码中使用。如果需要兼容旧代码，也可以通过EntityManager.unwrap(Session.class)获取Session实例，但这属于过渡性做法。

总结 #

截至Hibernate 5.2，基于JPA EntityManager的API + HQL/Criteria API就是无SQL操作的标准最佳实践，它既符合JPA规范，又能充分利用Hibernate的所有特性，完全匹配你偏好的代码风格。

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