开发并部署一个简单的EJB

用JBoss部署一个EJB，并构建一个客户端应用程序来运用它。
by Budi Kurniawan

很多人在开始学习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”。本文的重点是讲述整个开发过程，所以我打算尽量地使代码简单。你可以通过这个小程序来证明我们要讲的概念。

图1. 你的小项目的目录结构

要开发和部署一个EJB应用程序，必须经历四个步骤：

1. 为你的bean编写类。

2. 编写部署描述符。

3. 创建一个部署文件。

4. 部署bean。

另外，我还将讲述如何构建一个客户端应用程序，因此你可以看到你的bean是如何运行的。 我将一步步地讲述。让我们以本文的例子为例， 首先建一个名为workplace的目录，作为你的工作区（workspace）。 你可以将你的bean classes放在com.javapro.ejb包中，所以你需要为源文件和Java类建几个目录（见图1）。在做完这些后，目录将会包含10个文件（见图2）。现在将注意力转移到构建你的EJB所需的步骤上。

图2. 项目文件

编写类
正如你所知道的，一个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（见列表4）。即，它是个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）和部署过程。关于这些问题，你应该参考服务器文件说明。