很多人在开始学习Enterprise JavaBeans(EJB)时,在编译第一个enterprise bean以及在所选择的J2EE服务器上部署它时常常会遇到问题。首先,与其它J2EE 技术相比较,EJB的学习曲线是很陡的。第二,在编写一个enterprise bean时, 你必须处理许多文件。许多有关EJB的书籍的作者在他们的书的前几章都狂热地谈论这种技术,但是很少有人教你如何让你的第一个EJB运行。作为技术引导性文章,本文主要是讲述如何开发一个简单的EJB并用JBoss部署它,而不是探讨EJB的规范和技术。用其它J2EE服务器进行部署的过程是同样的,只是有些微小的变化。
EJB是J2EE中的主要技术之一。你可能已经读到很多有关这个令人兴奋的技术的文章了, 现在可能正准备采取下个步骤:开发一个真正的EJB并在一个EJB容器中运行它。通过本文,你将学习到如何开发一个EJB、部署它、并构建一个客户端应用程序来运用它。
本文运用的这个EJB很简单:叫做StringProcessor,它唯一的功能就是将一个字符串转换成大写。即,输入“ejb”,StringProcessor就会将它转换成“EJB”。本文的重点是讲述整个开发过程,所以我打算尽量地使代码简单。你可以通过这个小程序来证明我们要讲的概念。
要开发和部署一个EJB应用程序,必须经历四个步骤:
1. 为你的bean编写类。
2. 编写部署描述符。
3. 创建一个部署文件。
4. 部署bean。
另外,我还将讲述如何构建一个客户端应用程序,因此你可以看到你的bean是如何运行的。 我将一步步地讲述。让我们以本文的例子为例, 首先建一个名为workplace的目录,作为你的工作区(workspace)。 你可以将你的bean classes放在com.javapro.ejb包中,所以你需要为源文件和Java类建几个目录。在做完这些后,目录将会包含10个文件。现在将注意力转移到构建你的EJB所需的步骤上。
编写类
正如你所知道的,一个enterprise bean最少由三个类构成(见列表1、2和3)。你应该在workplace/com/javapro/ejb目录中保存这些文件。编译源文件时,应该执行下面这些步骤。(假设你已经将javac.exe包含在你的“path”环境变量中了。注意这里的路径是针对Windows的。如果你在Linux/Unix中,应该对它做相应的修改。这不会是个大问题。)
1. 如果你是在Windows中,打开一个命令提示符。
2. 将目录改变到你的workplace目录。
3. 第一个要编译的源文件是StringProcessor.java,因为其它两个文件需要StringProcessor类。编译需要classpath中的jboss-j2ee.jar。这个包含EJB API的文件可以在JBoss安装目录的客户端目录中找到。
在这个例子中,我用的是JBoss 2.4.4,并将它安装在C:\Jboss-2.4.4中(在JBoss 3.0中, jboss-j2ee.jar文件也位于安装目录的客户端目录中):javac -classpath C:\JBoss-2.4.4\client\jboss-j2ee.jar com/javapro/ejb/StringProcessor.java
4. 用下面的命令编译StringProcessorHome.java文件 (注意它需要workplace下的StringProcessor.class文件,所以你需要提供当前的目录,通过jboss-j2ee.jar后的句点来表示该目录):
javac -classpath C:\JBoss-2.4.4\client\jboss-j2ee.jar;.com/javapro/ejb/StringProcessorHome.java
5. 编译StringProcessorBean.java文件。命令类似于步骤4中的命令:
javac -classpath C:\JBoss-2.4.4\client\jboss-j2ee.jar;.com/javapro/ejb/StringProcessorBean.java
编写部署描述符
一个EJB应用程序的部署描述符采用的名字是ejb-jar.xml。即,它是个XML文件。你必须将这个文件保存到workplace/META-INF目录中。
创建一个部署文件
为了部署你的EJB,你需要将java类和部署描述符打包到一个JAR或EAR文件中。从workplace目录输入下面的命令(假设jar.exe在你的path环境变量中):jar cfv StringProcessor.jar com/javapro/ejb/*.class META-INF/ejb-jar.xml
如果一切正常,下面就是来自jar应用程序的信息:
added manifest
adding: com/javapro/ejb/StringProcessor.class(in = 270) (out= 194)(deflated 28%)
adding: com/javapro/ejb/StringProcessorBean.class(in = 897) (out= 446)(deflated 50%)
adding: com/javapro/ejb/StringProcessorHome.class(in = 301) (out= 205)(deflated 31%)
adding: META-INF/ejb-jar.xml(in = 577) (out= 255)(deflated 55%)
部署你的Bean
在JBoss2.4中部署一个EJB是很简单的。你只需要将.jar文件拷贝到JBoss安装目录下的部署目录中就可以了。你甚至不需要重新启动JBoss。如果你在JBoss运行时将这个文件拷贝到部署目录中,它就会发出下面这个信息(遗憾的是,不能在JBoss的网站上免费得到如何用JBoss 3.0部署你的EJB的指令):
[INFO,AutoDeployer] Auto deploy of file:/C:/JBoss-2.4.4/deploy/StringProcessor.jar
[INFO,J2eeDeployer] Deploy J2EE application: file:/C:/JBoss-2.4.4/deploy/StringProcessor.jar
[INFO,J2eeDeployer] Create application StringProcessor.jar
[INFO,J2eeDeployer] install EJB module StringProcessor.jar
[INFO,ContainerFactory] Deploying:file:/C:/JBoss-2.4.4/tmp/deploy/Default/StringProcessor.jar
[INFO,ContainerFactory] Deploying StringProcessor
[INFO,StringProcessor] Initializing
[INFO,StringProcessor] Initialized
[INFO,StringProcessor] Starting
[INFO,StringProcessor] Started
[INFO,ContainerFactory] Deployed application: file:/C:/JBoss-2.4.4/tmp/deploy/Default/StringProcessor.jar
[INFO,J2eeDeployer] J2EE application: file:/C:/JBoss-2.4.4/deploy/StringProcessor.jar is deployed.
编写客户端应用程序
为了测试你的EJB是否运行,让我们来创建一个Client类(见列表5)。要编译客户端应用程序,从workplace目录输入下面的命令:
javac -classpath C:\JBoss-2.4.4\client\jboss-j2ee.jar;. Client.java
Client类需要一个参数,它是个字符串,将转换成大写。运用下面的命令从workplace运行客户端程序(假设java.exe已经包含在你的path环境变量中了):
java -classpath C:\JBoss-2.4.4\client\jboss-client.jar;C:\JBoss-2.4.4\client\jnp-client.jar;. Client "golden retriever"
上面命令的输出是:
Got context
Got reference
Uppercase of 'golden retriever' is GOLDEN RETRIEVER
你已经学习到如何开发你的第一个EJB并用JBoss部署它了。如果你用的是个不同的J2EE服务器,那么过程是类似的。你的工作区目录结构是一样的,而且你编写同样的源文件并用类似的名令来编译你的EJB、编译并运行你的客户端应用程序。不同的是你的classpath中需要的EJB API的位置(在JBoss中是jboss-j2ee.jar)和部署过程。关于这些问题,你应该参考服务器文件说明。
关于作者:
Budi Kurniawan是一名IT顾问,他专门从事Internet和面向对象的编程,曾教授Java和Microsoft技术。他是销量很好的Java for the Web with Servlets, JSP, and EJB;A Developer's Guide to Scalable Solutions(new Riders)一书的作者,他还开发了最受欢迎的Java Upload Bean,你可以从BrainySoftware.com得到它,许多重要的公司都得到许可并将它用于项目中了。Budi的联系方式是budi@brainysoftware.com。