作者：未知 來(lái)源：月光軟件站 加入時(shí)間：2005-2-28 月光軟件站
作者：肖文鵬
JBoss是一個(gè)開(kāi)放源碼的EJB服務(wù)器，它與其它服務(wù)器整合后可以提供一個(gè)完整的J2EE平臺。本文介紹如何在Linux/windows環(huán)境下安裝和配置JBoss，以及如何在JBoss平臺上實(shí)現EJB的開(kāi)發(fā)和部署。
作為J2EE架構中最重要的構件，EJB是實(shí)現服務(wù)器端分布式計算的核心。EBJ服務(wù)器是EJB的容器，它控制著(zhù)EJB的運行，并為其提供事務(wù)處理、數據庫訪(fǎng)問(wèn)、安全控制等一系列系統級的服務(wù)。
EJB服務(wù)器是J2EE應用服務(wù)器的一個(gè)重要組成部分。Sun公司的J2EE SDK、IBM公司的WebSphere，以及BEA公司的WebLogic等J2EE實(shí)現都內嵌了EJB服務(wù)器。雖然JBoss目前還不是一個(gè)完整的J2EE應用服務(wù)器，但它卻是一個(gè)完整的EJB服務(wù)器，在與Tomcat、Jetty等Web服務(wù)器整合后，能夠提供一個(gè)完整的J2EE平臺。
JBoss最大的優(yōu)點(diǎn)在于它是源代碼開(kāi)放的自由軟件，并完全遵循J2EE規范。由于JBoss強大的功能和優(yōu)異的性能，以及與Linux等GNU項目的結合，目前已經(jīng)成為J2EE服務(wù)器端企業(yè)級應用的一股強大力量。
安裝JBoss
JBoss的安裝和配置相對比較簡(jiǎn)單。首先到
http://www.jboss.org上下載JBoss軟件包。目前JBoss的最高版本為3.0，建議下載相對穩定的JBoss2.4.4和Tomcat3.2.3集成的二進(jìn)制軟件包，這樣就避免了單個(gè)軟件包下載后JBoss和Tomcat之間的配置問(wèn)題。
下載的軟件包解壓縮到/usr目錄后，將生成/usr/JBoss-2.4.4_Tomcat-3.2.3這目錄。為方便今后的使用，把該目錄更名為/usr/jb_tom。在/usr/jb_tom目錄下可以找到/usr/jb_tom/jboss和/usr/jb_tom/tomcat兩個(gè)子目錄，它們分別為JBoss和Tomcat的根目錄。
在正式啟動(dòng)JBoss之前，應該先安裝好JDK（建議安裝JDK 1.3以上的版本），并將環(huán)境變量ClassPath設置好。位于/usr/jb_tom/jboss/bin目錄下的run_withtomcat.sh文件是JBoss和Tomcat的啟動(dòng)腳本，按照JBoss和Tomcat的默認配置，運行該腳本后將分別在8080和8083端口啟動(dòng)JBoss和Tomcat的HTTP服務(wù)。如果一切正常，此時(shí)在瀏覽器中輸入http://localhost:8080將出現Tomcat的首頁(yè)，而輸入http://localhost:8080則出現無(wú)錯誤的空白頁(yè)面。
創(chuàng )建EJB
下面以一個(gè)簡(jiǎn)單的無(wú)狀態(tài)會(huì )話(huà)Bean為例，講述如何為JBoss平臺編寫(xiě)EJB。按照EJB規范，一個(gè)EJB中至少應該包含如下三個(gè)類(lèi)的實(shí)現：
◆遠程接口
遠程接口暴露了整個(gè)EJB對外界的接口，在本例中遠程接口封裝在greet.Greet類(lèi)中。
◆本地接口
本地接口描述了創(chuàng )建、管理和銷(xiāo)毀EJB時(shí)的行為，在本例中本地接口封裝在greet.GreetHome類(lèi)中。
◆Bean類(lèi)
Bean類(lèi)實(shí)現了遠程接口中定義的所有方法，在本例中Bean類(lèi)封裝在greet.GreatBean類(lèi)中。
EJB在發(fā)布時(shí)是以一個(gè)JAR包的形式提供的。EJB服務(wù)器要求該JAR包中必須包含所有的類(lèi)文件和相應的部署文件，并且要按照EJB開(kāi)發(fā)時(shí)的目錄結構進(jìn)行組織。在我們的例子中，所有的類(lèi)文件都位于greet目錄下，部署文件則位于META-INF目錄下，相應的目錄結構為：
greet +-- Greet.java +-- GreetHome.java +-- GreetBean.java META-INF +-- ejb-jar.xml +-- jboss.xml
1.定義遠程接口
EJB向外界暴露的接口都在遠程接口中進(jìn)行定義，本例中的EJB只向外界提供了一個(gè)接口為calculateMagic，相應的源文件為Greet.java，代碼如下:
package greet; import javax.ejb.EJBObject; import java.rmi.RemoteException; /** * 這個(gè)接口為‘Greet’定義了遠程接口 public interface Greet extends EJBObject { public double calculateMagic(double seed) throws RemoteException; }
2.定義本地接口
EJB的本地接口對創(chuàng )建、管理和銷(xiāo)毀EJB的行為進(jìn)行了描述，本地接口至少應該提供create()方法，以便對EJB創(chuàng )建時(shí)的行為進(jìn)行相應的描述。例子中本地接口對應的源文件為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. 實(shí)現Bean類(lèi)
EJB真正完成的工作是在Bean類(lèi)中實(shí)現的，Bean類(lèi)必須為遠程接口中定義的所有方法提供相應的實(shí)現。本例中的Bean類(lèi)對應的源文件為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類(lèi)的具體實(shí)現后，用下面的命令對這些.java文件進(jìn)行編譯，生成相應的.class文件：
javac *.java -classpath /usr/jb_tom/jboss/lib/ext/jboss-j2ee.jar:.
部署描述符
根據EJB規范，要想將EJB成功地部署到EJB服務(wù)器上，必須為EJB服務(wù)器提供相應的部署描述符。部署描述符對所要部署的EJB進(jìn)行了說(shuō)明，包括該EJB的遠程描述符、本地描述符和Bean類(lèi)等信息。由于EJB服務(wù)器只有在獲得這些基本信息后才能正確完成EJB的部署，因此編寫(xiě)EJB描述符是開(kāi)發(fā)EJB時(shí)必不可少的一個(gè)環(huán)節。
對于不同的EJB服務(wù)器來(lái)說(shuō)，部署同一EJB時(shí)所需的部署描述符可能并不相同。在JBoss平臺上，任何將要被部署的EJB都必須提供ejb-jar.xml和jboss.xml兩個(gè)文件，這兩個(gè)文件均位于JAR包中的META-INF目錄下，用于對將要部署的EJB進(jìn)行簡(jiǎn)要的說(shuō)明。
ejb-jar.xml
ejb-jar.xml是EJB規范定義的標準部署描述符，在任何EJB服務(wù)器上部署EJB時(shí)都需要用到該部署描述符。本例中用到的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ù)器都是通用的，但它并沒(méi)有為EJB服務(wù)器提供將要被部署的EJB的全部信息。為了能夠對EJB的部署進(jìn)行更靈活的控制，大部分EJB服務(wù)器都要求EJB開(kāi)發(fā)者同時(shí)提供另外一個(gè)文件來(lái)對將要部署的EJB進(jìn)行描述，在JBoss中該文件為jboss.xml，它也位于JAR包中的META-INF目錄中。jboss.xml中可以對EJB對應的JNDI名字以及相應的持久性進(jìn)行說(shuō)明，在本例中用到的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
開(kāi)發(fā)EJB的最后一步是將其中所有的類(lèi)文件和相應的部署描述符壓縮成JAR包，然后部署到EJB服務(wù)器上。在本例中，JAR包的生成可以通過(guò)下面這條命令來(lái)實(shí)現：
jar cf greetejb.jar greet/*.class META-INF/*.xml
該命令將greet目錄下的.class文件和META-INF目錄下的.xml文件壓縮成greetejb.jar文件。如果想知道生成的JAR包是否正確地包含了所有的文件，可以用命令：
jar cvf greetejb.jar
來(lái)查看greetejb.jar中包含的文件。如果得到如下的類(lèi)似信息，則說(shuō)明所需的文件都已經(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上的部署相當簡(jiǎn)單，只需要將該文件復制到JBoss的deploy目錄下就可以了，命令如下：
cp greetejb.jar /usr/jb_tom/jboss/deploy/
JBoss支持熱部署，deploy目錄下所有文件的改變都會(huì )被JBoss自動(dòng)檢測到，并根據檢測結果對相應的EJB進(jìn)行 [INFO,ContainerFactory] Deploying GreetEJB [INFO,GreetEJB] Initializing [INFO,GreetEJB] Initialized [INFO,GreetEJB] Starting [INFO,GreetEJB] Started
至此，EJB在JBoss平臺上的部署就全部完成了，如果想知道該EJB能否正常地工作，則需要為其編寫(xiě)專(zhuān)門(mén)的客戶(hù)端程序進(jìn)行測試。
測試EJB
EJB存在的價(jià)值在于為其客戶(hù)提供相應的服務(wù)，EJB客戶(hù)包含的范圍相當廣泛，可以是另外的EJB、普通的JavaBean、JSP頁(yè)面、Applet或者標準的Java應用程序。GreetClient.java是已經(jīng)部署好的EJB的客戶(hù)程序，其完整的源碼如下所示：
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客戶(hù)端程序進(jìn)行編譯：
javac GreetClient.java -classpath /usr/jb_tom/jboss/lib/ext/jboss-j2ee.jar:.
如果一切正常，就可以運行客戶(hù)端程序來(lái)對EJB進(jìn)行測試了，命令如下：
java -cp $CLASSPATH:/usr/jb_tom/jboss/client/jboss-client.jar:. GreetClient
小結
本文以一個(gè)無(wú)狀態(tài)的會(huì )話(huà)Bean為例，講述了在JBoss平臺上開(kāi)發(fā)和部署EJB的全過(guò)程，對JBoss的安裝、EJB的創(chuàng )建、EJB的部署及EJB的測試做了簡(jiǎn)要介紹。作為一個(gè)開(kāi)放源碼的EJB服務(wù)器，JBoss已經(jīng)開(kāi)始被越來(lái)越多的企業(yè)所接受，基于JBoss的成功案例屢見(jiàn)不鮮。有關(guān)JBoss的更多信息，請訪(fǎng)問(wèn)JBoss的網(wǎng)站http://www.jboss.org。
