通过本章的学习，读者将深入掌握JPA中有关持久化上下文、事务处理的相关知识，从而能够更加深入地应用JPA。
11.1 获得EntityManager对象
那么如何获得EntityManager对象呢？这又是JPA中另外一个很重要的问题。
11.1.1 Java EE环境与J2SE环境
在详细讲述EntityManager对象之前，读者首先要分清楚两个概念，即Java EE环境与J2SE环境。因为在本章后面的学习中要经常提到这两个概念，所以读者一定要先理解它们，为以后的学习打好基础。
— Java EE环境，包括EJB容器和Web容器。
（1）Web容器：只运行Web应用的容器，例如Tomcat就是开源的Web容器，它可以运行JSP、Servlet等。
（2）EJB容器：运行在EJB组件的容器，提供EJB组件的状态管理、事务管理、线程管理、远程数据资源访问、连接管理和安全性管理等系统级服务。例如JBoss为EJB容器和Web容器（Web容器是集成了Tomcat）结合。
部署在EJB容器中的JAR包都可以认为是运行在EJB容器中。但JBoss中的Web应用，比如war包中的类就不是运行在EJB容器中，而是运行在Web容器中。
— J2SE环境
最普通Java运行环境，例如一个HelloWorld的Java程序就是运行在J2SE的环境中，通常使用main入口方法作为程序启动的触发。
如图11-1所示，它说明了Java EE与J2SE环境的关系。
11.1.2 两种类型的EntityManager对象
根据EntityManager对象的管理方式，可以有以下两种类型。
— 容器托管的（container-managed）EntityManager对象
容器托管的EntityManager对象最简单，程序员不需要考虑EntityManager连接的释放，以及事务等复杂的问题，所有这些都交 给容器去管理。容器托管的EntityManager对象必须在EJB容器中运行，而不能在Web容器和J2SE的环境中运行。本书前面讲述的 EntityManager对象都是通过注入 @PersistenceContext注释来获得的，其实，这种获得EntityManager对象的方式就是容器托管的。
— 应用托管的（application-managed）EntityManager对象
应用托管的EntityManager对象，程序员需要手动地控制它的释放和连接、手动地控制事务等。但这种获得应用托管的 EntityManager对象的方式，不仅可以在EJB容器中应用，也可以使 JPA脱离EJB容器，而与任何的Java环境集成，比如说Web容器、J2SE环境等。所以从某种角度上来说，这种方式是JPA能够独立于EJB环境运 行的基础。
理想状态下，最好是选用容器托管的EntityManager对象的方式，但在特殊的环境下，还是需要使用应用托管的EntityManager对象这种方式。
正是因为应用托管的EntityManager对象的连接释放、事务控制比较复杂，所以在使用时涉及的相关内容比较多，这些内容将在本章后面部分详细讲述，这里读者应对两种方式有一个大致的了解，两种EntityManager对象类型的比较如表11-1所示。
表11-1 容器托管与应用托管的EntityManager对象对比
比较内容
容器托管的（container-managed）EntityManager对象
应用托管的（application-managed）EntityManager对象
获得方式
两种方式：1 @PersistenceContex注入 2 JNDI获得
EntityManagerFactory创建
支持事务
JTA
JTA、RESOURCE_LOCAL
运行环境
EJB容器
EJB容器、Web容器、J2SE环境
11.1.3 容器托管的（container-managed）EntityManager对象
容器托管的EntityManager对象只能运行在EJB容器中。所以可以这样理解，只有在EJB-JAR包中，才可以获得容器托管的EntityManager对象，否则只能获得应用托管的EntityManager对象。
在EJB容器中获得EntityManager对象主要有两种方式，即@PersistenceContext注释注入和JNDI方式获得。
11.1.3.1 通过@PersistenceContext注释注入
这种方式获得EntityManager对象最为常用，例如下面代码所示。 1. @Stateless
2.
3. public class CustomerService implements
4.
5. @PersistenceContext(unitName = "jpaUnit")
6.
7. private
8.
9. public
10.
11. "SELECT c FROM CustomerEO c");
12.
13. List<CustomerEO> result = query.getResultList();
14.
15. for
16.
17. ","+c.getName());
18.
19. }
20.
21. return
22.
23. }
24.
25. }
在使用此种方式创建EntityManager对象时，需要注意以下几个问题。
— @PersistenceContext注释中，其中unitName为persistence.xml文件中<persistence-unit>元素中的属性“name”的值，表示要初始化哪个持久化单元，如下所示。
Xml代码
1. <persistence>
2.
3. <persistence-unit name="jpaUnit" transaction-type="JTA">
4.
5. </persistence-unit>
6.
7. </persistence>
— @PersistenceContext注释中还可以配置其他的设置，它的定义如下所示。
Java代码
1. @Target({TYPE, METHOD, FIELD}) @Retention(RUNTIME)
2.
3. public @interface
4.
5. default "";
6.
7. default "";
8.
9. default
10.
11. default
12.
13. }
— 其中PersistenceContextType可以设置创建EntityManager对象时，持久化上下文的作用范围，它的意义在于对有状态的Bean（Stateless Bean）可以跨事务操作实体。它主要有两种方式，定义如下所示。
Java代码
1. public enum
2.
3. TRANSACTION,
4.
5. EXTENDED
6.
7. }
默认情况下使用TRANSACTION，有关TRANSACTION方式和EXTENDED方式创建EntityManager对象的异同，将在下文中详细讲述，这里读者简单了解一下即可。
11.1.3.2 通过JNDI的方式获得
如果指定了@PersistenceContext注释中的name值，则设置了持久化上下文的JNDI名称。通过SessionContext可以创建EntityManager对象。
例如，下面代码为通过JNDI方式获得EntityManager对象。
1. @Stateless
2.
3. @PersistenceContext(name="jpa")
4.
5. public class CustomerService implements
6.
7. @Resource
8.
9. SessionContext ctx;
10.
11. public
12.
13. "jpa");
14.
15. "SELECT c FROM CustomerEO c");
16.
17. List<CustomerEO> result = query.getResultList();
18.
19. for
20.
21. ","+c.getName());
22.
23. }
24.
25. return
26.
27. }
28.
29. }
11.1.4 应用托管的（application-managed）EntityManager对象
应用托管的EntityManager对象，不仅可以在Java EE环境中获得，也可以应用在J2SE的环境中。但无论是在什么情况下获得的EntityManager对象，都是通过实体管理器工厂 （EntityManagerFactory）对象创建的。所以如何获得应用托管的EntityManager对象关键是 EntityManagerFactory对象如何获得。
下面就分别讲述在EJB容器、Web容器和J2SE环境中如何获得EntityManagerFactory对象。
11.1.4.1 EJB容器中获得
在EJB容器中，EntityManagerFactory对象可以通过使用注入@PersistenceUnit注释获得，例如下面代码为在EJB容器中，获得应用托管的EntityManager对象的方法。
1. @Stateless
2.
3. public class CustomerService implements
4.
5. @PersistenceUnit(unitName="jpaUnit")
6.
7. private
8.
9. public
10.
11. /**创建EntityManager对象*/
12.
13. EntityManager em = emf.createEntityManager();
14.
15. "SELECT c FROM CustomerEO c");
16.
17. List<CustomerEO> result = query.getResultList();
18.
19. for
20.
21. ","+c.getName());
22.
23. }
24.
25. /**关闭EntityManager */
26.
27. em.close();
28.
29. return
30.
31. }
32.
33. }
通过以上的EntityManager对象代码，可以总结出以下几个问题。
— 应用托管的EntityManager对象，要在代码中手动地创建和关闭，例如下面代码所示。
EntityManager em = emf.createEntityManager();
/**其他的业务逻辑*/
em.close();
这点正是与容器托管的EntityManager对象的最大不同之处。事实上，容器托管的EntityManager对象，它的创建和关闭是由容器负责管理的，所以不需要编写代码来控制。
— 应用托管的EntityManager对象，都是通EntityManagerFactory对象来创建的。在容器中可以通过使用注入@PersistenceUnit注释的方法实现，它的定义如下所示。
1. @Target({TYPE, METHOD, FIELD}) @Retention(RUNTIME)
2.
3. public @interface
4.
5. default "";
6.
7. default "";
8.
9. }
其中，属性unitName为persistence.xml文件中<persistence-unit>元素中的属性“name”的值，表示要初始化哪个持久化单元，与@PersistenceContext注释中unitName属性相同。
11.1.4.2 Web容器中获得
在Web容器中，EntityManagerFactory对象也可以通过使用注入@PersistenceUnit注释获得。例如，下面代码为在 Servlet中，获得应用托管的EntityManager对象的方法。 /syntaxhighlighter/clipboard_new.swf">
1. public class TestServlet extends
2.
3. @PersistenceUnit(unitName = "jpaUnit")
4.
5. private
6.
7. public
8.
9. super();
10.
11. }
12.
13. public void
14.
15. throws
16.
17. doPost(request, response);
18.
19. }
20.
21. public void
22.
23. throws
24.
25. "text/html");
26.
27. PrintWriter out = response.getWriter();
28.
29. "<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01 Transitional //EN\">");
30.
31. "<HTML>");
32.
33. " <HEAD><TITLE>A Servlet</TITLE></HEAD>");
34.
35. " <BODY>");
36.
37. if (emf != null) {
38.
39. /**创建EntityManager 对象*/
40.
41. EntityManager entityManager = emf.createEntityManager();
42.
43. try
44.
45. Query query = entityManager
46.
47. "SELECT c FROM CustomerEO c");
48.
49. List<CustomerEO> result = query.getResultList();
50.
51. for
52.
53. ","
54.
55. }
56.
57. finally
58.
59. /**关闭EntityManager*/
60.
61. entityManager.close();
62.
63. }
64.
65. }
66.
67. " </BODY>");
68.
69. "</HTML>");
70.
71. out.flush();
72.
73. out.close();
74.
75. }
76.
77. }
|