作者：未知 來源：月光軟件站 加入時間：2005-2-28 月光軟件站
作者：肖文鵬
JBoss是一個開放源碼的EJB服務(wù)器，它與其它服務(wù)器整合后可以提供一個完整的J2EE平臺。本文介紹如何在Linux/windows環(huán)境下安裝和配置JBoss，以及如何在JBoss平臺上實現(xiàn)EJB的開發(fā)和部署。
作為J2EE架構(gòu)中最重要的構(gòu)件，EJB是實現(xiàn)服務(wù)器端分布式計算的核心。EBJ服務(wù)器是EJB的容器，它控制著EJB的運行，并為其提供事務(wù)處理、數(shù)據(jù)庫訪問、安全控制等一系列系統(tǒng)級的服務(wù)。
EJB服務(wù)器是J2EE應(yīng)用服務(wù)器的一個重要組成部分。Sun公司的J2EE SDK、IBM公司的WebSphere，以及BEA公司的WebLogic等J2EE實現(xiàn)都內(nèi)嵌了EJB服務(wù)器。雖然JBoss目前還不是一個完整的J2EE應(yīng)用服務(wù)器，但它卻是一個完整的EJB服務(wù)器，在與Tomcat、Jetty等Web服務(wù)器整合后，能夠提供一個完整的J2EE平臺。
JBoss最大的優(yōu)點在于它是源代碼開放的自由軟件，并完全遵循J2EE規(guī)范。由于JBoss強大的功能和優(yōu)異的性能，以及與Linux等GNU項目的結(jié)合，目前已經(jīng)成為J2EE服務(wù)器端企業(yè)級應(yīng)用的一股強大力量。
安裝JBoss
JBoss的安裝和配置相對比較簡單。首先到
http://www.jboss.org上下載JBoss軟件包。目前JBoss的最高版本為3.0，建議下載相對穩(wěn)定的JBoss2.4.4和Tomcat3.2.3集成的二進(jìn)制軟件包，這樣就避免了單個軟件包下載后JBoss和Tomcat之間的配置問題。
下載的軟件包解壓縮到/usr目錄后，將生成/usr/JBoss-2.4.4_Tomcat-3.2.3這目錄。為方便今后的使用，把該目錄更名為/usr/jb_tom。在/usr/jb_tom目錄下可以找到/usr/jb_tom/jboss和/usr/jb_tom/tomcat兩個子目錄，它們分別為JBoss和Tomcat的根目錄。
在正式啟動JBoss之前，應(yīng)該先安裝好JDK（建議安裝JDK 1.3以上的版本），并將環(huán)境變量ClassPath設(shè)置好。位于/usr/jb_tom/jboss/bin目錄下的run_withtomcat.sh文件是JBoss和Tomcat的啟動腳本，按照J(rèn)Boss和Tomcat的默認(rèn)配置，運行該腳本后將分別在8080和8083端口啟動JBoss和Tomcat的HTTP服務(wù)。如果一切正常，此時在瀏覽器中輸入http://localhost:8080將出現(xiàn)Tomcat的首頁，而輸入http://localhost:8080則出現(xiàn)無錯誤的空白頁面。
創(chuàng)建EJB
下面以一個簡單的無狀態(tài)會話Bean為例，講述如何為JBoss平臺編寫EJB。按照EJB規(guī)范，一個EJB中至少應(yīng)該包含如下三個類的實現(xiàn)：
◆遠(yuǎn)程接口
遠(yuǎn)程接口暴露了整個EJB對外界的接口，在本例中遠(yuǎn)程接口封裝在greet.Greet類中。
◆本地接口
本地接口描述了創(chuàng)建、管理和銷毀EJB時的行為，在本例中本地接口封裝在greet.GreetHome類中。
◆Bean類
Bean類實現(xiàn)了遠(yuǎn)程接口中定義的所有方法，在本例中Bean類封裝在greet.GreatBean類中。
EJB在發(fā)布時是以一個JAR包的形式提供的。EJB服務(wù)器要求該JAR包中必須包含所有的類文件和相應(yīng)的部署文件，并且要按照EJB開發(fā)時的目錄結(jié)構(gòu)進(jìn)行組織。在我們的例子中，所有的類文件都位于greet目錄下，部署文件則位于META-INF目錄下，相應(yīng)的目錄結(jié)構(gòu)為：
greet +-- Greet.java +-- GreetHome.java +-- GreetBean.java META-INF +-- ejb-jar.xml +-- jboss.xml
1.定義遠(yuǎn)程接口
EJB向外界暴露的接口都在遠(yuǎn)程接口中進(jìn)行定義，本例中的EJB只向外界提供了一個接口為calculateMagic，相應(yīng)的源文件為Greet.java，代碼如下:
package greet; import javax.ejb.EJBObject; import java.rmi.RemoteException; /** * 這個接口為‘Greet’定義了遠(yuǎn)程接口 public interface Greet extends EJBObject { public double calculateMagic(double seed) throws RemoteException; }
2.定義本地接口
EJB的本地接口對創(chuàng)建、管理和銷毀EJB的行為進(jìn)行了描述，本地接口至少應(yīng)該提供create()方法，以便對EJB創(chuàng)建時的行為進(jìn)行相應(yīng)的描述。例子中本地接口對應(yīng)的源文件為GreetHome.java，代碼如下：
package greet; import java.io.Serializable; import java.rmi.RemoteException; import javax.ejb.CreateException; import javax.ejb.EJBHome; public interface GreetHome extends EJBHome { Greet create() throws RemoteException, CreateException; }
3. 實現(xiàn)Bean類
EJB真正完成的工作是在Bean類中實現(xiàn)的，Bean類必須為遠(yuǎn)程接口中定義的所有方法提供相應(yīng)的實現(xiàn)。本例中的Bean類對應(yīng)的源文件為GreetBean.java：
package greet; import java.rmi.RemoteException; import javax.ejb.SessionBean; import javax.ejb.SessionContext; public class GreetBean implements SessionBean { public double calculateMagic(double seed) { System.out.println ("Someone called `calculateMagic!‘"); return seed * Math.random(); } public GreetBean() {} public void ejbCreate() { System.out.println("Create Greet EJB."); } public void ejbRemove() { System.out.println("Remove Greet EJB."); } public void ejbActivate() { System.out.println("Activate Greet EJB"); } public void ejbPassivate() { System.out.println("Passivate Greet EJB"); } /** * Set context for `Greet‘ EJB */ public void setSessionContext(SessionContext sc) { System.out.println("Set context for Greet EJB"); } }
在給出EJB的接口定義并提供了Bean類的具體實現(xiàn)后，用下面的命令對這些.java文件進(jìn)行編譯，生成相應(yīng)的.class文件：
javac *.java -classpath /usr/jb_tom/jboss/lib/ext/jboss-j2ee.jar:.
部署描述符
根據(jù)EJB規(guī)范，要想將EJB成功地部署到EJB服務(wù)器上，必須為EJB服務(wù)器提供相應(yīng)的部署描述符。部署描述符對所要部署的EJB進(jìn)行了說明，包括該EJB的遠(yuǎn)程描述符、本地描述符和Bean類等信息。由于EJB服務(wù)器只有在獲得這些基本信息后才能正確完成EJB的部署，因此編寫EJB描述符是開發(fā)EJB時必不可少的一個環(huán)節(jié)。
對于不同的EJB服務(wù)器來說，部署同一EJB時所需的部署描述符可能并不相同。在JBoss平臺上，任何將要被部署的EJB都必須提供ejb-jar.xml和jboss.xml兩個文件，這兩個文件均位于JAR包中的META-INF目錄下，用于對將要部署的EJB進(jìn)行簡要的說明。
ejb-jar.xml
ejb-jar.xml是EJB規(guī)范定義的標(biāo)準(zhǔn)部署描述符，在任何EJB服務(wù)器上部署EJB時都需要用到該部署描述符。本例中用到的ejb-jar.xml代碼如下所示：
<?xml version="1.0" encoding="Cp1252"?> <ejb-jar> <description>jBoss test application </description> <display-name>Test</display-name> <enterprise-beans> <session> <ejb-name>GreetEJB</ejb-name> <home>greet.GreetHome</home> <remote>greet.Greet</remote> <ejb-class>greet.GreetBean</ejb-class> <session-type>Stateless</session-type> <transaction-type>Bean</transaction-type> </session> </enterprise-beans> </ejb-jar>
jboss.xml
雖然ejb-jar.xml對所有的EJB服務(wù)器都是通用的，但它并沒有為EJB服務(wù)器提供將要被部署的EJB的全部信息。為了能夠?qū)JB的部署進(jìn)行更靈活的控制，大部分EJB服務(wù)器都要求EJB開發(fā)者同時提供另外一個文件來對將要部署的EJB進(jìn)行描述，在JBoss中該文件為jboss.xml，它也位于JAR包中的META-INF目錄中。jboss.xml中可以對EJB對應(yīng)的JNDI名字以及相應(yīng)的持久性進(jìn)行說明，在本例中用到的jboss.xml如下所示：
<?xml version="1.0" encoding="ISO-8859-1"?> <jboss> <enterprise-beans> <session> <ejb-name>GreetEJB</ejb-name> <jndi-name>GreetingEJB</jndi-name> </session> <secure>false</secure> </enterprise-beans> <resource-managers/> </jboss>
部署EJB
開發(fā)EJB的最后一步是將其中所有的類文件和相應(yīng)的部署描述符壓縮成JAR包，然后部署到EJB服務(wù)器上。在本例中，JAR包的生成可以通過下面這條命令來實現(xiàn)：
jar cf greetejb.jar greet/*.class META-INF/*.xml
該命令將greet目錄下的.class文件和META-INF目錄下的.xml文件壓縮成greetejb.jar文件。如果想知道生成的JAR包是否正確地包含了所有的文件，可以用命令：
jar cvf greetejb.jar
來查看greetejb.jar中包含的文件。如果得到如下的類似信息，則說明所需的文件都已經(jīng)被正確地包含在該壓縮包中了，信息如下：
0 Sun May 24 15:32:10 CST 2002 META-INF/ 68 Sun May 24 15:32:10 CST 2002 META-INF/MANIFEST.MF 1007 Sun May 24 14:35:46 CST 2002 greet/GreetBean.class 209 Sun May 24 14:35:46 CST 2002 greet/Greet.class 251 Sun May 24 14:35:46 CST 2002 greet/GreetHome.class 493 Sun May 24 08:40:00 CST 2002 META-INF/ejb-jar.xml 303 Sun May 24 08:43:22 CST 2002 META-INF/jboss.xml
生成的JAR包在JBoss上的部署相當(dāng)簡單，只需要將該文件復(fù)制到JBoss的deploy目錄下就可以了，命令如下：
cp greetejb.jar /usr/jb_tom/jboss/deploy/
JBoss支持熱部署，deploy目錄下所有文件的改變都會被JBoss自動檢測到，并根據(jù)檢測結(jié)果對相應(yīng)的EJB進(jìn)行 [INFO,ContainerFactory] Deploying GreetEJB [INFO,GreetEJB] Initializing [INFO,GreetEJB] Initialized [INFO,GreetEJB] Starting [INFO,GreetEJB] Started
至此，EJB在JBoss平臺上的部署就全部完成了，如果想知道該EJB能否正常地工作，則需要為其編寫專門的客戶端程序進(jìn)行測試。
測試EJB
EJB存在的價值在于為其客戶提供相應(yīng)的服務(wù)，EJB客戶包含的范圍相當(dāng)廣泛，可以是另外的EJB、普通的JavaBean、JSP頁面、Applet或者標(biāo)準(zhǔn)的Java應(yīng)用程序。GreetClient.java是已經(jīng)部署好的EJB的客戶程序，其完整的源碼如下所示：
import javax.naming.*; import java.util.Hashtable; import javax.rmi.PortableRemoteObject; import greet.*; class GreetClient { public static void main(String[] args) { System.setProperty("java.naming.factory.initial", "org.jnp.interfaces.Naming ContextFactory"); System.setProperty("java.naming.provider.url", "localhost:1099"); try { // Get a naming context InitialContext jndiContext = new InitialContext(); System.out.println（"Got context"）; Object ref = jndiContext.lookup("GreetingEJB"); System.out.println("Got reference"); GreetHome home = (GreetHome) PortableRemoteObject.narrow (ref, GreetHome.class); Greet greet = home.create(); System.out.print("The magic number from server is "); System.out.println(greet.calculateMagic(123.456)); } catch(Exception e) { System.out.println(e.toString()); } } }
用下面的命令對EJB客戶端程序進(jìn)行編譯：
javac GreetClient.java -classpath /usr/jb_tom/jboss/lib/ext/jboss-j2ee.jar:.
如果一切正常，就可以運行客戶端程序來對EJB進(jìn)行測試了，命令如下：
java -cp $CLASSPATH:/usr/jb_tom/jboss/client/jboss-client.jar:. GreetClient
小結(jié)
本文以一個無狀態(tài)的會話Bean為例，講述了在JBoss平臺上開發(fā)和部署EJB的全過程，對JBoss的安裝、EJB的創(chuàng)建、EJB的部署及EJB的測試做了簡要介紹。作為一個開放源碼的EJB服務(wù)器，JBoss已經(jīng)開始被越來越多的企業(yè)所接受，基于JBoss的成功案例屢見不鮮。有關(guān)JBoss的更多信息，請訪問JBoss的網(wǎng)站http://www.jboss.org。
