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