作者：肖文鵬
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強(qiáng)大的功能和優(yōu)異的性能,，以及與Linux等GNU項目的結(jié)合,，目前已經(jīng)成為J2EE服務(wù)器端企業(yè)級應(yīng)用的一股強(qiáng)大力量。
安裝JBoss
JBoss的安裝和配置相對比較簡單,。首先到http://www.上下載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包是否正確地包含了所有的文件，可以用命令：
來查看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.。
|
