JPA中要对数据库进行操作前,必须先取得EntityManager实例,这有点类似JDBC在对数据库操作之前,必须先取得Connection实例,EntityManager是JPA操作的基础,它不是设计为线程安全(Thread-safe)。


EntityManager实例基本上是从EntityManagerFactory上调用createEntityManager()方法来取得,在 第一个 JPA(单机客户端) 中有看到实际的例子,若您使用容器管理,则可以使用@PersistenceContext注入EntityManger,像是第一个 JPA(容器管理) 所示范的,或者您可以使用@PersistenceUnit注入EntityManagerFactory,再用它来建立EntityManager,如 在 Servlet 中直接使用 JPA 所示范的。


EntityManager主要在管理Entity实例生命周期,透过EntityManager,您对Entity实例的操作,可以对应至数据库进行新增、查找、修改、删除、重清等动作,以下先简介API的使用,以Application-Managed EntityManager为例作说明,您必须搭配 Entity 生命周期 以对Entity在EntityManager中的Managed、Detached、Removed状态获得更进一步的了解。


要新增资料,可以使用EntityManager的persist()方法,这也会让Entity实例处于Managed状态,例如:


User user = new User();
// 设定 user 相关属性entityManager.persist(user);


若要取得数据表中的数据,使用EntityManager的find()方法,指定主键对象与Class实例来取得对应的数据并封装为对象,查找回的对象会处于Managed的状态:


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


若数据库中已有对应数据,则要修改数据有几种方式:


 

  • 若对象是在Managed状态,例如查找对象之后,直接更新对象,在交易确认之后,对象的更新就会反应至数据表之中:

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

user.setName("Justin Lin");


 

  • 若对象属于生命周期的Detached状态,您可以使用EntityManager的merge()方法将对象转至生命周期的Managed状态,合并对象上之变更:

// 若 user 状态有所变动

entityManager.merge(user);


 

  • 也可以先使用merge()方法将Detached状态的Entity实例转至Managed的状态,再更新对象,在交易确认之后,对象的更新就会反应至数据表之中:

User user1 = entityManager.merge(user);

user1.setName("Justin Lin");


若要删除数据表中的数据,则对象必须是在Managed的状态,例如用EntityManager的find()方法查找对象,以查找到的对象配合remove()方法来移除,或是使用merge(()方法将Entity处于Managed状态再用remove()移除,移除之后,对象对应不到数据表格中实际的数据,处于Removed状态:


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


若在加载某个Entity实例之后,而数据表格因另一个操作而发生变动,您可以使用EntityManager的refresh()方法,将数据表格的更动加载Entity实例中,若Entity先前有了一些更动操作,则会被覆盖:


entityManager.refresh(user);


您可以使用EntityManager的flush()方法,强制EntityManager中管理的所有Entity对应的数据表格与Entity的状态同步:


entityManager.flush();


EntityManager的clear()方法,可以将EntityManager所管理的Entity实例清除,使Entity处于Detached状态:


entityManager.clear();


每个EntityManager都与一个​ Persistence Context​ 关联,EntityManager不直接维护Entity,而是将之委托给Persistence Context,Persistence Context中会维护一组Entity实例,每个Entity在Persistence Context为Managed状态,Entity实例会有Managed、Detached、Removed状态,这在 ​Entity 生命周期​ 中再作进一步的说明。