EJB核心技術及其應用
一、EJB技術簡介
EJB的全稱是Enterprise java bean。是JAVA中的商業應用組件技術。EJB結構中的角色 EJB 組件結構是基於組件的分佈式計算結構，是分佈式應用系統中的組件。
一個完整的基於EJB的分佈式計算結構由六個角色組成，這六個角色可以由不同的開發商提供，每個角色所作的工作必須遵循Sun公司提供的EJB規範，以保證彼此之間的兼容性。這六個角色分別是EJB組件開發者(Enterprise Bean Provider) 、應用組合者(Application Assembler)、部署者(Deployer)、EJB 服務器提供者(EJB Server Provider)、EJB 容器提供者(EJB Container Provider)、系統管理員(System Administrator)：
二、EJB中各角色的分析
1、EJB組件開發者(Enterprise Bean Provider)
EJB組件開發者負責開發執行商業邏輯規則的EJB組件，開發出的EJB組件打包成ejb-jar文件。EJB組件開發者負責定義EJB的remote和home接口，編寫執行商業邏輯的EJB class,提供部署EJB的部署文件(deployment descriptor)。部署文件包含EJB的名字，EJB用到的資源配置，如JDBC等。EJB組件開發者是典型的商業應用開發領域專家。
EJB組件開發者不需要精通系統級的編程，因此，不需要知道一些系統級的處理細節，如事務、同步、安全、分佈式計算等。
2、應用組合者(Application Assembler)
應用組合者負責利用各種EJB組合一個完整的應用系統。應用組合者有時需要提供一些相關的程序，如在一個電子商務系統裏，應用組合者需要提供JSP(Java Server Page)程序。
應用組合者必須掌握所用的EJB的home和remote接口，但不需要知道這些接口的實現。
3、部署者(Deployer)
部署者負責將ejb-jar文件部署到用戶的系統環境中。系統環境包含某種EJB Server和EJB Container。部署者必須保證所有由EJB組件開發者在部署文件中聲明的資源可用，例如，部署者必須配置好EJB所需的數據庫資源。
部署過程分兩步：部署者首先利用EJB Container提供的工具生成一些類和接口，使EJB Container能夠利用這些類和接口在運行狀態管理EJB。 部署者安裝EJB組件和其他在上一步生成的類到EJB Container中。 部署者是某個EJB運行環境的專家。
某些情況下，部署者在部署時還需要了解EJB包含的業務方法，以便在部署完成後，寫一些簡單的程序測試。
4、EJB 服務器提供者(EJB Server Provider)
EJB 服務器提供者是系統領域的專家，精通分佈式交易管理，分佈式對象管理及其它系統級的服務。EJB 服務器提供者一般由操作系統開發商、中間件開發商或數據庫開發商提供。
在目前的EJB規範中，假定EJB 服務器提供者和EJB 容器提供者來自同一個開發商，所以，沒有定義EJB 服務器提供者和EJB容器提供者之間的接口標準。
5、EJB 容器提供者(EJB Container Provider)
EJB 容器提供者提供以下功能：
提供EJB部署工具爲部署好的EJB組件提供運行環境 。EJB容器負責爲EJB提供交易管理，安全管理等服務。
EJB 容器提供者必須是系統級的編程專家，還要具備一些應用領域的經驗。EJB 容器提供者的工作主要集中在開發一個可伸縮的，具有交易管理功能的集成在EJB 服務器中的容器。EJB 容器提供者爲EJB組件開發者提供了一組標準的、易用的API訪問EJB 容器，使EJB組件開發者不需要了解EJB服務器中的各種技術細節。
EJB容器提供者負責提供系統監測工具用來實時監測EJB容器和運行在容器中的EJB組件狀態。
6、系統管理員(System Administrator)
系統管理員負責爲EJB服務器和容器提供一個企業級的計算和網絡環境。
系統管理員負責利用EJB 服務器和容器提供的監測管理工具監測EJB組件的運行情況。
三、EJB的體系結構：
EJB分佈式應用程序是基於對象組件模型的，低層的事務服務用了API技術。EJB技術簡化了用JAVA語言編寫的企業應用系統的開發，配置。EJB技術定義了一組可重用的組件：Enterprise Beans。你可以利用這些組件，象搭積木一樣的建立你的分佈式應用程序。當你把代碼寫好之後，這些組件就被組合到特定的文件中去。每個文件有一個或多個Enterprise Beans，在加上一些配置參數。最後，這些Enterprise Beans被配置到一個裝了EJB容器的平臺上。客戶能夠通過這些Beans的home接口，定位到某個beans，併產生這個beans的一個實例。這樣，客戶就能夠調用Beans的應用方法和遠程接口。
EJB服務器作爲容器和低層平臺的橋樑管理着EJB容器和函數。它向EJB容器提供了訪問系統服務的能力。例如：數據庫的管理和事務的管理，或者對於其它的Enterprise的應用服務器。所有的EJB 實例都運行在EJB容器中。 容器提供了系統級的服務，控制了EJB的生命週期。EJB中的有一些易於使用的管理工具如：Security--配置描述器（The Deployment descriptor）定義了客戶能夠訪問的不同的應用函數。容器通過只允許授權的客戶訪問這些函數來達到這個效果。Remote Connectivity--容器爲遠程鏈接管理着低層的通信issues，而且對Enterprise Beas的開發者和客戶都隱藏了通信細節。EJB的開發者在編寫應用方法的時候，就象是在條用本地的平臺一樣的。客戶也不清楚他們調用的方法可能是在遠程被處理的。Life Cycle managment--客戶簡單的創建一個Enterprise beans的實例，並通常取消一個實例。而容器管理着Enterprise Beans的實例，使Enterprise Beans實現最大的效能和內存利用率。容器能夠這樣來激活和使Enterprise Beans失效，保持衆多客戶共享的實例池。等等。 Trasction management-配置描述器定義了Enterprise beans 的事務處理的需求。容器管理着那些管理分佈式事務處理的複雜的issues。這些事務可能要在不同的平臺之間更新數據庫。容器使這些事務之間互相獨立，互不干擾。保證所有的更新數據庫都是成功發生的，否者，就回滾到事務處理之前的狀態。
EJB 組件是基於分佈式事務處理的企業級應用程序的組件。所有的EJB都有如下的特點：EJB包含了處理企業數據的應用邏輯。定義了EJB的客戶界面。這樣的界面不受容器和服務器的影響。於是，當一個EJB被集合到一個應用程序中去時，不用更改代碼和重新編譯。EJB能夠被定製 各種系統級的服務，例如安全和事務處理的特性，都不是屬於EJB類的。而是由配置和組裝應用程序的工具來實現。 有兩種類型的EJB: Session beans 和 entity beans.Session beans是一種作爲單用戶執行的對象。作爲對遠程的任務請求的相應，容器產生一個Session beans 的實例。一個Session beans有一個用戶.從某種程度上來說，一個Session bean 對於服務器來說就代表了它的那個用戶.Session beans 也能用於事務，它能夠更新共享的數據，但它不直接描繪這些共享的數據。Session beans 的生命週期是相對較短的。典型的是，只有當用戶保持會話的時候，Session beans 纔是活着的。一旦用戶退出了，Session beans 就不再與用戶相聯繫了。Session beans被看成是瞬時的，因爲如果容器崩潰了，那麼用戶必須重新建立一個新的Session對象來繼續會話。
Session bean典型的聲明瞭與用戶的互操作或者會話。也就是說，Session bean了在客戶會話期間，通過方法的調用，掌握用戶的信息。一個具有狀態的Session bean稱爲有狀態的Session bean.當用戶終止與Session beans互操作的時候.會話終止了，而且，bean 也不再擁有狀態值。Session bean也可能是一個無狀態的 session bean.無狀態的Session beans並不掌握它的客戶的信息或者狀態。用戶能夠調用beans的方法來完成一些操作。但是，beans只是在方法調用的時候才知道用戶的參數變量。當方法調用完成以後，beans並不繼續保持這些參數變量。這樣，所有的無狀態的session beans的實例都是相同的，除非它正在方法調用期間。這樣，無狀態的Session beans就能夠支持多個用戶.容器能夠聲明一個無狀態的Session beans.能夠將任何Session beans指定給任何用戶.
Entity Beans對數據庫中的數據提供了一種對象的視圖。例如：一個Entity bean能夠模擬數據庫表中一行相關的數據。多個client能夠共享訪問同一個Entity bean.多個client也能夠同時的訪問同一個Entity bean.Entity beans通過事務的上下文來訪問或更新下層的數據。這樣，數據的完整性就能夠被保證。Entity Beans能存活相對教長的時間，並且狀態是持續的。只要數據庫中的數據存在，Entity beans就一直存活。而不是按照應用程序或者服務進程來說的。即使EJB容器崩潰了，Entity beans也是存活的。Entity Beans生命週期能夠被容器或者 Beans自己管理。如果由容器控制着保證 Entity beans持續的issus。如果由Beans自己管理，就必須寫Entity beans的代碼，包括訪問數據庫的調用。
Entity Beans是由主鍵（primary key 一種唯一的對象標識符）標識的。通常，主鍵與標識數據庫中的一塊數據，例如一個表中的一行，的主鍵是相同的。主鍵是client能夠定位特定的數據塊。
四、開發EJB
1、類介紹：
開發EJB的主要步驟一般來說，整個的開發步驟（開發，配置，組裝）包括如下幾個方面。開發：首先要定義三個類：Bean類本身，Bean的本地和遠程接口類。 配置：配置包括產生配置描述器--這是一個XML文件、聲明瞭Enterprise Bean的屬性、綁定了bean的class文件（包括stub文件和skeleton文件）。最後將這些配置都放到一個jar文件中。還需要在配置器中定義環境屬性。組裝應用程序：包括將Enterprise beans安裝到Server服務器中，測試各層的連接情況。程序組裝器將若干個Enterprise Beans與其它的組件結合起來。組合成一個完整的應用程序。或者將若干個Enterprise beans組合成一個複雜的Enterprise Bean。管理Enterprise Bean。
我們必須定義和編寫一些EJB中的基本類。如Enterprise bean類：這是Enterprise bean內部應用邏輯的實現。編寫Enterprise bean的遠程接口類。編寫Enterprise bean的本地接口類。說明主鍵類，主鍵類只是對於Entity bean才需要的。在Enterprise bean的配置描述器中指定主鍵的名字。Enterprise beans提供者定義了遠程接口和本地接口，實現了EJB類本身。Remote接口中提供了客戶調用EJB實現的應用邏輯函數的接口。而home接口提供了產生和定位remote接口實例的方法。
在Enterprise bean本身類的實現，本地home接口，遠程remote接口之間並沒有正式的聯繫（例如繼承關係）。但是，在三個類裏聲明的方法卻必須遵守EJB裏面定義的規範。例如： 你在Enterprise bean裏面聲明瞭一個應用程序的方法或者說應用邏輯。也在beans的remote接口中聲明瞭這個方法，那麼，這兩個地方必須要同樣的名字。Bean的實現裏面必須至少有一個Create()方法：ejbCreate()。但是可以有多個帶有不同參數的create()方法。 在home接口中，也必須有相同的方法定義（參數的個數相同）。EjbCreate()方法返回的一個容器管理的持久對象。它們都返回一個容器管理持久性的主鍵值。但是，在home的相應的Create()方法中返回值的類型是remote接口。
注意：實體bean的實現的ejbCreate方法有點不同。實體bean可以不定義ejbCreate方法。如果實體只是通過應用程序或通過數據庫管理程序的途徑被加到數據庫中，實體bean就省略了ejbCreate方法。EjbCreate返回的值是主鍵類型。如果ejbCreate方法是容器管理持久性的實體bean的方法，它的返回值就是NULL類型。如果實體bean實現了Bean管理的持久性，ejbCreate方法就返回值類型就是主鍵類型。容器的任務是把各接口和Enterprise bean的實現類結合起來。保證在編譯時和運行時，各接口和實現類是相對應的。
EJB的實現類，各接口要從不同的基類中繼承下來。一個會話bean必須實現基類javax.ejb.SessionBean。而實體bean必須實現基類javax.ejb.EntiyBean。這些EJB的基類都是從javax.ejb.EnterpriseBean繼承而來。而javax.ejb.EnterpriseBean又是從java.io.Serializable繼承而來。每一個Enterprise Bean都必須有一個remote接口。Remote接口定義了應用程序規定客戶可以調用的邏輯操作。這些是一些可以由客戶調用的公共的方法，通常由Enterprise beans類來實現。注意，Enterprise bean的客戶並不直接訪問Bean。而是通過remote接口來訪問。Enterprise bean類的remote接口擴展了javax.ejb.EJBObject類的公共java接口。而Javax.ejb.EJBObject是所有remote接口的基類。其代碼如下：
| package javax.ejb; public interface EJBObject extends java.rmi.Remote{ public EJBHome getEJBHome() throws java.rmi.RemoteException; public Object getPrimaryKey() throws java.rmi.RemoteException; public void Remove() throws java.rmi.RemtoeException, java.rmi.RemoveException public Handle getHandle() throws java.rmi.RemoteException; boolean isIdentical (EJBObject p0) throws java.rmi.RemoteException; } |
getEJBHome()方法允許你取得一個相關的Home接口。對於 實體Bean，用getPrimaryKey（）方法獲得實體Bean的主鍵值。Remove（）可以刪除一個Enterprise bean。具體的語義在各種不同類型的enterprise beans的生命週期中，由上下文中解釋的。方法getHandle（）返回了一個Enterprise bean實例的持久的句柄。IsIndentical()方法允許你去比較Enterprise beans是否相同。
2、方法：
所有的remote接口中的方法必須聲明爲公共（public）的，並必須拋出java.rmi.RemotException異常。另外，所有的remote接口中的方法定義的參數和都必須是在RMI-IIOP中有效的。對每一個在remote接口中定義的方法，在Enterprise bean 類裏面都要有相應的方法。相應的方法必須要有同樣的名字，同樣類型和數量的參數，同樣的返回值，而且還要拋出同樣的例外。 如下代碼顯示了一個ATM例子的會話bean的remote接口Atm，。裏面聲明瞭一個應用方法transfer（）。黑體部分表示EJB規範中必須要有的內容。Remote接口必須擴展javax.ejb.EJBObject類。從客戶端調用的Enterprise bean的每一個方法都必須在remote接口中聲明。Transfer（）方法拋出了兩個意外。其中InSufficientFundsException例外是應用程序定義的意外。
| Public interface Atm extends javax.ejb.EJBObject{ Public void transfer(String Source, String Target, float amount) Throws java.rmi.RemoteException, InSufficientFundsException; } |
Home接口必須定義一個或多個的Create()方法。每一個這樣的Create()方法都必須命名爲Create。並且，它的參數，不管是類型還是數量都必須與bean類裏面的ejbCreate()方法對應。注意，home接口中的Create()方法和bean類中ejbCreate()方法的返回值類型是不同的。實體bean的home接口還包含find（）方法。 每一個Home接口都擴展了javax.ejb.EJBHome接口。如下代碼顯示了javax.ejb.EJBHome接口的定義：
| package javax.ejb; public interface EJBHome extends java.rmi.Remote() { void remove(Handle handle) throws java.rmi.RemoteException,RemoveException; void remove(Object primarykey) throws java.rmi.RemoteException,RemoveException; EJBMetaData getEJBMetaData() throws RemoteException; Homehandle getHomeHandle() throws RemoteException; } |
這裏提供了兩個remove（）方法來刪除Enterprise bean的實例。第一個remove方法是通過句柄來刪除一個Enterprise bean的實例。第二個remove方法通過主鍵來刪除一個Enterprise bean的實例。 在衆多的Enterprise bean實例中，句柄唯一的標識一個實例。一個句柄與它引用的Enterprise bean有相同的生命期。考慮一個實體對象，客戶可以通過一個句柄來重新獲得相應的Enterprise bean的實例。一個句柄能夠對應一個Enterprise bean對象的多個實例。例如，即使當Enterprise bean對象所在的主機崩潰了，或者Enterprise bean對象在不同的機器之間移動，句柄仍是有效的。這裏的句柄是Serialized句柄，與CORBA中的字符串化的CORBA對象的引用是相似的概念。在EJBHome接口中的第二個remove操作通過其主鍵來決定要刪除的Enterprise bean。主鍵可以是擴展了Java Object類的任何類型，但是，必須要實現Java的Serializable接口。主鍵是標識實體bean的主要的方法。通常，主鍵是數據庫中的一個關鍵字，唯一的定義了由實體bean代表的數據。
方法getEJBMetaData（）返回了Enterprise bean對象的metadata接口。這個接口允許客戶獲得Enterprise bean的metadata信息。當開發工具來編譯鏈接應用程序的時候，或者配置工具來配置的時候，可能會用到metadata信息。Javax.ejb.EJBMetadata接口提供了獲得javax.ejb.EJBHome接口，home類，remote接口，還有獲得主鍵的方法。也提供了一個isSesson()的方法來確定在放這個home接口的對象是會話bean還是實體bean。 IsStatelessSession()方法指示這個會話bean是有狀態還是無狀態的。如下代碼顯示了javax.ejb.EJBMetadata接口的定義部分的代碼。
| Public javax.ejb; Public interface EJBMetaData{ EJBHome getEJBHome(); Class getHomeInterfaceClass(); Class getRemoteInterfaceClasss(); Class getPrimaryKeyClass(); Boolean isSession(); Boolean isStatelesssSession(); } |
對每一個Create（）方法，EJB規範定義瞭如下的命名約定。它的返回值是會話bean的remote接口的類型。方法的名字只能是Create()。對會話bean類中的每一個ejbCreate()方法都必須有一個Create()與之對應。 對於每一個Create()方法的參數的類型和數量都必須與會話bean類中的ejbCreate()方法相對應。方法必須拋出java.rmi.RemoteException例外。 方法必須拋出javax.rmi.CreateExeption例外。 Create（）方法的參數是用來初始化新的會話bean對象的。 如下代碼顯示了一個會話bean對象的不同的Create()方法，其中必須的部分用粗體顯示：
| public interface AtmHome extends javax.ejb.EJBHome{ Atm create() throws java.rmi.RemoteException,javax.ejb.CreateException; Atm create(Profile preferredProfile) Throws java.rmi.RemoteExeption,javax.ehrows java.rmi.RemoteException,RemoveException; EJBMetaData getEJBMetaData() throws RemoteException; Homehandle getHomeHandle() throws RemoteException; } |
這裏提供了兩個remove（）方法來刪除Enterprise bean的實例。第一個remove方法是通過句柄來刪除一個Enterprise bean的實例。第二個remove方法通過主鍵來刪除一個Enterprise bean的實例。在衆多的Enterprise bean實例中，句柄唯一的標識一個實例。一個句柄與它引用的Enterprise bean有相同的生命期。考慮一個實體對象，客戶可以通過一個句柄來重新獲得相應的Enterprise bean的實例。一個句柄能夠對應一個Enterprise bean對象的多個實例。例如，即使當Enterprise bean對象所在的主機崩潰了，或者Enterprise bean對象在不同的機器之間移動，句柄仍是有效的。這裏的句柄是Serialized句柄，與CORBA中的字符串化的CORBA對象的引用是相似的概念。
在EJBHome接口中的第二個remove操作通過其主鍵來決定要刪除的Enterprise bean。主鍵可以是擴展了Java Object類的任何類型，但是，必須要實現Java的Serializable接口。主鍵是標識實體bean的主要的方法。通常，主鍵是數據庫中的一個關鍵字，唯一的定義了由實體bean代表的數據。方法getEJBMetaData（）返回了Enterprise bean對象的metadata接口。這個接口允許客戶獲得Enterprise bean的metadata信息。當開發工具來編譯鏈接應用程序的時候，或者配置工具來配置的時候，可能會用到metadata信息。Javax.ejb.EJBMetadata接口提供了獲得javax.ejb.EJBHome接口，home類，remote接口，還有獲得主鍵的方法。也提供了一個isSesson()的方法來確定在放這個home接口的對象是會話bean還是實體bean。IsStatelessSession()方法指示這個會話bean是有狀態還是無狀態的。如下代碼顯示了javax.ejb.EJBMetadata接口的定義部分的代碼。
| Public javax.ejb; Public interface EJBMetaData{ EJBHome getEJBHome(); Class getHomeInterfaceClass(); Class getRemoteInterfaceClasss(); Class getPrimaryKeyClass(); Boolean isSession(); Boolean isStatelesssSession(); } |
五、EJB的編程環境：
1、 使用Jbuilder
Jbuilder與EJB Container能夠進行無縫連接。Jbuilder和Inprise的應用服務器包括了所有的開發和配置Enterprise Beans的工具以及所需要的庫：運行和管理Enterprise Bean的容器、命名服務、 事務服務、Java數據庫、開發Enterprise Beans所需要的API、一個增強的java-to-iiop編譯器，支持值類型和RMI信號等等。
Jbuilder還提供了一個快速開發應用程序Enterprise Beans的工具和嚮導。通過簡單而且直觀的步驟，嚮導幫助你建立一個Enterprise Bean。自己設定某些缺省值，產生了bean的模板，在上面，我們可以增加我們自己的應用邏輯。Jbuilder也提供了一個EJB的接口生成嚮導。嚮導在Enterprise Bean的公共方法基礎上生成了Remote接口和Home接口。Jbuilder還提供一個配置器的嚮導幫助我們逐步的建立XML描述器文件。並將生成的Stubs集中到一個jar文件中。
2、使用Jbuilder之外的集成環境：
如果你使用其它的除了別的集成環境（IDE）。要確定使用了集成環境IDE所帶的容器工具。也要驗證IDE是否支持EJB規範的相應的版本，還要確定它是否正確的支持EJB的API。
要確定JD到所支持的EJB容器的版本。可以通過檢查Inprise的安裝說明來確定EJB容器所支持的支持JDK的版本。
在配置Enterprise Bean的時候，你必須使用Inprise的應用服務器所提供的工具。這些工具能夠編輯和修改第三方的代理商提供的Inprise配置描述器。還能夠驗證配置描述器，能夠驗證bean的源代碼。
六、一個簡單的HELLO例子
1、安裝Apusic Application Server
Note:以下以Linux爲例，來說明Apusic Application Server的安裝過程。其他平臺的安裝，可參考Apusic Application Server安裝手冊。
下載JDK1.2，Apusic Application Server必須運行在JDK1.2以上環境中。可從以下站點下載最新JDK。
http://java.sun.com ;下載Apusic Application Server
Apusic Application Server 試用版可從以下網址得到：
http://www.apusic.com/download/enter.jsp ;在下載完成後，你可以得到一個包裹文件apusic.zip，選定安裝目錄，假設安裝到/usr下，則用以下命令：
cd /usr
jar xvf apusic.zip
/usr下會出現一個目錄apusic，Apusic Application Server的所有程序都被解壓到/usr/apusic下。
將以下路徑加入到CLASSPATH中
/usr/apusic/lib/apusic.jar
$JAVA_HOME/lib/tools.jar
用以下命令運行Apusic Application Server
java -Xms64m com.apusic.server.Main -root /usr/apusic
2、定義EJB遠程接口(Remote Interface)
任何一個EJB都是通過Remote Interface被調用，EJB開發者首先要在Remote Interface中定義這個EJB可以被外界調用的所有方法。執行Remote Interface的類由EJB生成工具生成。
以下是HelloBean的Remote Inteface程序：
| package ejb.hello; import java.rmi.RemoteException; import java.rmi.Remote; import javax.ejb.*; public interface Hello extends EJBObject, Remote { //this method just get "Hello World" from HelloBean. public String getHello() throws RemoteException; } |
3、定義Home Interface
EJB容器通過EJB的Home Interface來創建EJB實例，和Remote Interface一樣，執行Home Interface的類由EJB生成工具生成。
以下是HelloBean 的Home Interface程序：
| package ejb.hello; import javax.ejb.*; import java.rmi.Remote; import java.rmi.RemoteException; import java.util.*; /** * This interface is extremely simple it declares only * one create method. */ public interface HelloHome extends EJBHome { public Hello create() throws CreateException, RemoteException; } |
4、寫EJB類
在EJB類中，編程者必須給出在Remote Interface中定義的遠程方法的具體實現。EJB類中還包括一些 EJB規範中定義的必須實現的方法，這些方法都有比較統一的實現模版，編程者只需花費精力在具體業務方法的實現上。
以下是HelloBean的代碼：
| package ejb.hello; import javax.ejb.*; import java.util.*; import java.rmi.*; public class HelloBean implements SessionBean { static final boolean verbose = true; private transient SessionContext ctx; // Implement the methods in the SessionBean // interface public void ejbActivate() { if (verbose) System.out.println("ejbActivate called"); } public void ejbRemove() { if (verbose) System.out.println("ejbRemove called"); } public void ejbPassivate() { if (verbose) System.out.println("ejbPassivate called"); } /** * Sets the session context. * * @param SessionContext */ public void setSessionContext(SessionContext ctx) { if (verbose) System.out.println("setSessionContext called"); this.ctx = ctx; } /** * This method corresponds to the create method in * the home interface HelloHome.java. * The parameter sets of the two methods are * identical. When the client calls * HelloHome.create(), the container allocates an * instance of the EJBean and calls ejbCreate(). */ public void ejbCreate () { if (verbose) System.out.println("ejbCreate called"); } /** * **** HERE IS THE BUSINESS LOGIC ***** * the getHello just return a "Hello World" string. */ public String getHello() throws RemoteException { return("Hello World"); } } |
5、創建ejb-jar.xml文件
ejb-jar.xml文件是EJB的部署描述文件，包含EJB的各種配置信息，如是有狀態Bean(Stateful Bean) 還是無狀態Bean(Stateless Bean)，交易類型等。ejb-jar.xml文件的詳細信息請參閱EJB規範。以下是HelloBean的配置文件：
| <?xml version="1.0"?> <!DOCTYPE ejb-jar PUBLIC "-//Sun Microsystems Inc.//DTD Enterprise JavaBeans 1.2//EN" " http://java.sun.com/j2ee/dtds/ejb-jar_1_2.dtd";> <ejb-jar> <enterprise-beans> <session> <ejb-name>Hello</ejb-name> <home>ejb.hello.HelloHome</home> <remote>ejb.hello.Hello</remote> <ejb-class>ejb.hello.HelloBean</ejb-class> <session-type>Stateless</session-type> <transaction-type>Container</transaction-type> </session> </enterprise-beans> <assembly-descriptor> <container-transaction> <method> <ejb-name>Hello</ejb-name> <method-name>*</method-name> </method> <trans-attribute>Required</trans-attribute> </container-transaction> </assembly-descriptor> </ejb-jar> |
6、編譯和部署
編譯Java源文件並將編譯後class和ejb-jar.xml打包到Hello.jar
mkdir build
mkdir build/META-INF
cp ejb-jar.xml build/META-INF
javac -d build *.java
cd build
jar cvf Hello.jar META-INF ejb
cd ..
用EJB工具生成可部署到Apusic Application Server中運行的jar文件:
java com.apusic.ejb.utils.EJBGen -d /usr/apusic/classes/Hello.jar build/Hello.jar
增加/usr/apusic/classes/Hello.jar到CLASSPATH中
將Hello.jar加入到Apusic Application Server配置文件中。在/usr/apusic/config/server.xml 加入以下幾行：
| <module> <ejb> <ejb-uri>classes/Hello.jar</ejb-uri> <bean> <ejb-name>Hello</ejb-name> <jndi-name>HelloHome</jndi-name> </bean> </ejb> </module> |
啓動服務器
java -Xms64m com.apusic.server.Main -root /usr/apusic
7、寫客戶端調用程序
您可以從Java Client，JSP，Servlet或別的EJB調用HelloBean。
調用EJB有以下幾個步驟：
通過JNDI(Java Naming Directory Interface)得到EJB Home Interface
通過EJB Home Interface 創建EJB對象，並得到其Remote Interface
通過Remote Interface調用EJB方法
以下是一個從Java Client中調用HelloBean的例子：
[code]package ejb.hello;
import javax.naming.Context;
import javax.naming.InitialContext;
import java.util.Hashtable;
import javax.ejb.*;
import java.rmi.RemoteException;
/**
* @author Copyright (c) 2000 by Apusic, Inc. All Rights Reserved.
*/
public class HelloClient{
public static void main(String args[]){
String url = "rmi://localhost:6888";
Context initCtx = null;
HelloHome hellohome = null;
try{
Hashtable env = new Hashtable();
env.put(Context.INITIAL_CONTEXT_FACTORY,
"com.apusic.jndi.InitialContextFactory");
env.put(Context.PROVIDER_URL, url);
initCtx = new InitialContext(env);
}catch(Exception e){
System.out.println("Cannot get initial context: " + e.getMessage());
System.exit(1);
}
try{
hellohome = (HelloHome)initCtx.lookup("HelloHome");
Hello hello = hellohome.create();
String s = hello.getHello();
System.out.println(s);
}catch(Exception e){
System.out.println(e.getMessage());
System.exit(1);
}
}
} [/code]運行HelloClient，可得到以下輸出：
Hello World