JAVA认证：开发SessionBean

会计考友

Cabin实体已经就绪，我们需要创建一个session bean，作为和Cabin实体交互的接口。该session bean将承担业务流程和(实体)访问代理的职责，我们称其为TravelAgent EJB。 　　TravelAgentRemote：远程接口
/ l) b7 v  E% r1 v" O3 O　　创建TravelAgent EJB的第一步是定义它的远程接口。该接口规定了允许客户端调用的EJB业务方法。客户端与TravelAgent的createCaben()和findCabin()方法进行交互，以控制Cabin实体。
# h$ Y) [: G: b) i　　package com.titan.travelagent;
5 h8 l" I. ~+ L# r* u3 D　　import javax.ejb.Remote;
　　import com.titan.domain.Cabin;
2 k: o# Y* a2 \3 f( S　　@Remote
; C, P- ~# V8 j+ B  O& X( x　　public interface TravelAgentRemote {
　　public void createCabin(Cabin cabin);
　　public Cabin findCabin(int id);
# Q9 V) ~4 Q7 h$ k　　}
　　TravelAgent EJB的远程接口实在没有什么特别之处。除了被标以@javax.ejb.Remote外，它看起来就像一个普通的Java接口。该注解告诉EJB容器，这一特定接口是TravelAgent EJB的远程业务接口。还要注意的是，业务方法不必再像EJB2.1那样抛出java.rmi.RemoteException了。如果想抛的话依然还可以抛，但是这并非是必须的。
　　TravelAgentBean: Bean Class
　　TravelAgentBean: The Bean Class
5 [# R5 O, B9 y7 B9 U: {　　我们既已定义好针对TravelAgent EJB的远程接口，就要为该session bean实现包含业务逻辑的bean class了。TravelAgent EJB被定义为stateless bean。我们使用@javax.ejb.Stateless
　　注解来表达此意图。尽管不是必要的，但对stateless session bean而言，实现其全部业务接口是一条不错的实践，这样，client/bean契约就能够通过Java编译器得到强化。在本例中，业务接口即 TravelAgentRemote。下面是TravelAgentBean的完整定义。
　　package com.titan.travelagent;
  B2 t7 B3 \5 Y2 g　　import javax.ejb.Stateless;
' j/ c% }8 Q* h/ W( z$ H4 W　　import javax.persistence.EntityManager;
' s7 x4 Z& T1 ?! J6 t. `　　import javax.persistence.PersistenceContext;
% {& L- B6 T' H' J5 @　　import com.titan.domain.Cabin;
3 Q1 L1 ^- B, X, I) }9 A1 J% V- U
0 x  D! D- `: a7 h8 t5 a+ J- l7 U6 V　　@Stateless

会计考友

</p>
　　public class TravelAgentBean implements TravelAgentRemote{
　　@PersistenceContext(unitName= "titan") private EntityManager manager;
2 T3 J3 h, W- e: v　　public void createCabin(Cabin cabin) {
　　manager.persist(cabin);
* B8 z: z& L" u& v+ c) @　　}
$ M# o6 I! s/ g4 [2 d; y/ K5 z　　public Cabin findCabin(int pKey) {
　　return manager.find(Cabin.class, pKey);
  f5 v* o; E# w　　}
　　}
　　在该实现中，还有若干问题需要进一步阐明。首先，TravelAgentBean类使用了@javax. persistence. PersistenceContext注解来获得对EntityManager服务的访问，以此来创建和查找Cabin实体。注解 @PersistenceContext告知EJB容器，必须用一个EntityManager实例来设置manager数据成员。EJB容器发现数据成员的类型为javax.persistence.
　　EntityManager，便知道应该将数据成员设置为一个指向EntitiyManager服务的引用，此服务指向我们在 persistence.xml文件里定义的Titan persistence unit。这一数据成员将在bean实例被创建时初始化。
3 t% |4 h& z$ ?+ ]8 P" I　　接下来的两个方法与 EntityManager服务进行交互，用以在数据库中创建Cabin实体，并依据主键对其进行定位。createCabin()方法调用 EntityManager.persist()，并传入一个要进行持久化的实体实例。待该操作完成后，Cabin实例就会被纳入持久化管理机制，并被存储到数据库中。稍后我们将会看到，创建Cabin实例与创建任何其他普通Java对象一样没有什么区别。findCabin()方法将数据库中Cabin 实体的一个主键作为其参数。它调用EntityManager.find()方法，并传入Cabin bean的类型和实际的主键作为参数。Cabin bean的类型参数告知EntityManager，它在数据库中试图查找的是何种实体。随后findCabin()方法将找到的Cabin实体并返回给远程客户端。
　　titan.jar: JAR文件
　　JAR文件是一种平台独立的文件格式，用于将若干文件一并压缩、打包和发布。开发基于Zip文件格式和zlib压缩标准的 JAR(Java Archive)工具，其初衷是为了让Java applet的下载效率更高。然而作为一种打包机制，JAR文件格式是一种将组件及其他软件进行“压缩-包装”(shrink-wrap)以便发布给第三方的非常便捷的手段。在EJB部署中，JAR文件会把与bean有关的所有类和接口打成包。除了EJB定义和类以外，它还允许你将entity bean及其persistence.xml部署描述文件打入包中。
　　创建用于部署的JAR文件是很容易的。定位到dev目录，该目录恰好位于com/titan目录树之上，然后执行如下命令：
　　C:\dev> jar cf titan.jar com/titan/domain/*.class
　　com/titan/travelagent/*.class
　　META-INF/persistence.xml
　　选项c告知jar命令工具，新建一个JAR文件以包含后续参数中所指定的文件。该选项还告知jar工具，将生成的JAR文件输出至标准输出设备。选项f告诉jar，将标准输出重定向到一个新的文件(titan.jar)，该文件由第二个参数指明。选项字母的次序和与之匹配的命令行参数很重要。你可以在Java in a Nutshell或Learning Java中(均已由O'Reilly出版)学到更多有关jar工具和java.util.zip包的知识。
# h  m1 a+ y$ ?2 r. c9 ~　　jar工具在dev目录下创建了titan.jar文件。假如你对查看JAR文件的内容很感兴趣，可以使用任何标准的Zip应用程序(WinZip、PKZIP等)，或者使用命令jar tvf titan.jar。图4-2展示了该Jar文件的结构。