对于 Spring Boot 项目 使用Hibernate

一、结论

对于 Spring Boot 项目：

推荐：
EntityManager

不推荐：
HibernateTemplate

甚至可以说：

Spring Boot + JPA
基本已经不再使用 HibernateTemplate

---

二、HibernateTemplate 是什么

来自：

org.springframework.orm.hibernate3.HibernateTemplate

或者：

org.springframework.orm.hibernate5.HibernateTemplate

属于 Spring 早期对 Hibernate 的封装。

当年（Spring2.x、Spring3.x）写法：

public class UserDao {

    private HibernateTemplate hibernateTemplate;

    public void update(User user){
        hibernateTemplate.merge(user);
    }
}

当时的 Hibernate 原生代码：

Session session = sessionFactory.openSession();

Transaction tx = session.beginTransaction();

session.merge(user);

tx.commit();

session.close();

代码比较繁琐。

所以 Spring 提供了：

HibernateTemplate

帮你处理：

获取Session
关闭Session
异常转换
事务同步

---

三、EntityManager 是什么

JPA标准接口：

javax.persistence.EntityManager

Spring Boot 默认就是：

Spring Data JPA
↓
EntityManager
↓
Hibernate

关系：

EntityManager
      ↓
Hibernate Session

实际上：

entityManager.merge(entity);

最终也是调用：

Session.merge(entity);

---

四、merge() 本质区别

HibernateTemplate

源码（Hibernate3时代）：

hibernateTemplate.merge(entity)

内部：

Session session = getSession();

session.merge(entity);

最后：

return mergedObject;

---

EntityManager

entityManager.merge(entity);

最终：

Session.merge(entity);

---

所以从 Hibernate 角度：

HibernateTemplate.merge
        =
EntityManager.merge
        =
Session.merge

最终执行逻辑几乎一样。

---

五、最大的区别

不是 merge 本身。

而是：

整个框架体系

---

HibernateTemplate

依赖：

SessionFactory

代码：

@Autowired
private HibernateTemplate hibernateTemplate;

DAO风格：

hibernateTemplate.save()

hibernateTemplate.update()

hibernateTemplate.merge()

hibernateTemplate.find()

典型老项目：

Spring3
Hibernate3
Struts1
Struts2

---

EntityManager

依赖：

@PersistenceContext
private EntityManager entityManager;

代码：

entityManager.persist()

entityManager.merge()

entityManager.remove()

entityManager.find()

典型现代项目：

Spring Boot
JPA
Hibernate5/6

---

六、Spring Boot 官方推荐

Spring Boot 官方路线：

Repository
 ↓
JPA
 ↓
EntityManager
 ↓
Hibernate

例如：

@Repository
public interface UserRepository
        extends JpaRepository<User,Long> {
}

底层就是：

EntityManager

不是：

HibernateTemplate

---

七、性能有区别吗

几乎没有。

例如：

entityManager.merge(user);

最终：

Session.merge(user);

---

hibernateTemplate.merge(user);

最终：

Session.merge(user);

---

执行 SQL：

update user set ...

完全一样。

---

八、Spring Boot 推荐哪种写法

推荐级别：

第一推荐

JpaRepository

例如：

public interface UserRepository
        extends JpaRepository<User,Long> {
}

---

第二推荐

@PersistenceContext
private EntityManager entityManager;

复杂查询：

entityManager.createQuery(...)

---

第三推荐

特殊场景：

Session session =
    entityManager.unwrap(Session.class);

直接使用 Hibernate API：

session.createQuery(...)

---

不推荐

HibernateTemplate

原因：

属于老Spring时代产物
JPA标准不兼容
Spring Boot生态基本不用
大量新特性不支持

---

九、如果是新项目

Spring Boot 3.x + Hibernate 6.x

推荐：

@Service
@Transactional
public class UserService {

    @PersistenceContext
    private EntityManager entityManager;

    public void update(Long id){

        User user =
            entityManager.find(User.class,id);

        user.setUserName("张三");

        // 不需要 merge
        // 脏检查自动更新
    }
}

甚至：

userRepository.save(user);

都可以省掉。

因为：

Managed Entity
+
@Transactional
+
Dirty Checking

已经足够。

---

所以如果你的项目是：

Spring Boot 2.x / 3.x
Hibernate 5.x / 6.x

建议优先使用：

EntityManager

或者直接：

JpaRepository

而不要再引入：

HibernateTemplate