http://dev2dev.bea.com.cn/techdoc/webser/200406201.html
開發實體EJB 增強的性能和開發
摘要
Enterprise JavaBean (EJB) 是一些應用程序組件，它們實現了 EJB 體系結構規范，并且是 Java 2 Enterprise Edition (J2EE) 平臺的一部分。EJB 是開發和部署分布式的、可伸縮的、事務型的、安全的、可移植的、基于組件的商業應用的理想選擇。
Enterprise JavaBean (EJB)是一些應用程序組件，它們實現了EJB體系結構規范，并且是Java 2 Enterprise Edition (J2EE) 平臺的一部分。EJB是開發和部署分布式的、可伸縮的、事務型的、安全的、可移植的、基于組件的商業應用的理想選擇。
基于EJB的商業應用需要一個EJB容器，用于運行時的執行。所有遵從J2EE規范的應用服務器，包括WebLogic 8.1在內，都提供了EJB容器。
EJB體系結構背后的主要動機是關系的分離：它將與應用程序基礎設施相關的部分（例如事務處理和安全性）與核心應用程序部分（例如業務邏輯）分離開來。簡言之，EJB體系結構通過指定EJB容器與EJB開發者之間職責的區別，從而達到這種關系上的分離。例如，透明地實現事務處理是EJB容器的職責，而實現業務邏輯則應由EJB開發者負責。雖然EJB容器執行任務時可能需要某些線索（hint），但是，比起實際地實現這些與基礎設施相關的活動來，提供這類線索（通過基于XML的部署描述符）的代價是非常少的。總之，這種關系分離的策略使得商業應用的開發比其他方式要高效得多。
EJB體系結構規范有4種版本：1.0、1.1、2.0和2.1。事實上，EJB version 1.0已經過時了，而最新版本，即2.1，由于剛剛才出現，所以還沒有廣泛提供。BEA WebLogic Server 8.1同時支持1.1和2.0這兩種版本。我們強烈建議在WebLogic Server 8.1中進行開發時使用EJB version 2.0。
實體bean是一種EJB。除了EJB背后的一般動機外，使用實體bean的特定動機是為持久存儲中的業務域（business-domain）實體提供一種駐留在內存中的、可共享的、面向對象的視圖。通常，業務域對象就是關系數據庫中一個表里面的一行。在本文中，我們討論了關于在WebLogic Server 8.1環境下Entity EJB的設計、開發和部署的特定問題。至于關于EJB技術的綜合教程，我們推薦http://java.sun.com/j2ee上的J2EE教程。
概述
實體bean是設計用來管理關系數據庫中的數據的。在BEA WebLogic Server 8.1環境下，Entity EJB的開發包括EJB的設計、生成、打包和部署。
從設計的角度來看，實體bean可以由兩條正交軸線來分類：持久性和訪問。順著持久性這條軸線，有兩種類型的實體bean：Bean管理的持久性（Bean-managed persistence，BMP）和容器管理的持久性（Container-managed persistence，CMP）。如果是CMP，則EJB容器將管理實體bean的持久性。而對于BMP，則由實體bean的開發者通過指定的Java代碼來管理實體bean的持久性。CMP和BMP之間的選擇是互斥的。順著訪問這條軸線，又有兩種類型的bean：遠程的和本地的。遠程實體bean提供了定位的透明性，并且可以從不同的Java虛擬機上訪問。相反，本地實體bean只能在同一應用服務器內訪問。本地和遠程之間的選擇不是互斥的，因此可以設計具有雙重接口的bean。
在EJB體系結構規范中，每個實體EJB組件都是由一組指定的Java類和一組指定的XML部署描述符組成。EJB的打包過程包括將所有指定的EJB Java類文件和XML部署描述符文件打包到一個Java Archive (JAR)文件中。如果實體EJB還要依賴于一些Java助手類文件，那么也可以將這樣的類文件包括到EJB JAR文件中，或者將它們單獨打包到一個不同的JAR文件中。
EJB的部署可分為兩種方式，要么是在BEA WebLogic Server 8.1內直接部署EJB JAR文件以及所依賴的任何JAR文件，要么是首先將EJB jar文件和所有依賴的JAR文件打包到一個企業應用歸檔（enterprise application archive，EAR）文件內，然后再在WebLogic Server 8.1內部署這個EAR文件。
設計EJB
在設計一個實體時，需要考慮的幾個重要選擇是：
- 是設計一個CMP實體bean還是一個BMP實體bean。
- 是設計一個本地實體bean，還是設計一個遠程實體bean，抑或是設計一個雙重接口的實體bean。
- 是設計一個粗粒度（coarse-grained）的實體bean，還是一個細粒度（fine-grained）的實體bean。
- 是使用數據傳輸對象，還是使用get和set方法來訪問實體EJB中的數據。
下面將討論在開發實體EJB時要面臨的這些設計選擇。
CMP與BMP
記住，雖然可能存在一些很合理的例外，但是一般情況下我們強烈推薦使用CMP這種設計。至于為什么要選擇CMP，而不是BMP，這里有三大主要原因。
- 與BMP相比，CMP提供了跨多種不同數據庫的可移植性，因為CMP實體bean不包含任何特定于數據庫的持久性代碼。CMP易于設計、實現和維護。
- 通常，CMP擁有好于BMP的性能，因為EJB容器將自動生成特定于數據庫的代碼，并且這些代碼將為目標數據庫而優化。
- CMP通過使用本地接口，使得在相關EJB的網絡中程序性地（programmatically）進行導航變得非常容易。
本地接口、遠程接口和雙重接口
因為CMP通過本地接口管理著實體EJB之間的關系，所以我們強烈建議總是提供一個本地接口。我們認為遠程接口需要的時候很少，但是如果仔細評估一下就會證明遠程接口也是需要的。所以，我們還是設計一個雙重接口吧。
本地接口通過本地客戶機提供了對EJB的優化的訪問；遠程方法調用（remote method invocation，RMI）的語義不要求通過本地客戶機、使用本地接口來訪問EJB。
遠程客戶機與EJB容器位于不同的虛擬機上，它需要RMI和遠程接口來訪問EJB。從理論上講，單單設計一個本地實體存在著一個明顯的缺點，那就是只有在相同應用服務器內的客戶機才能訪問該實體bean。然而，這只是一個理論上的缺點，因為實際上很少需要從應用服務器之外訪問實體EJB。
粗粒度與細粒度
這是一個非常有爭議的專題，所以還應根據您個人的經驗小心地評價關于此專題的一些不同觀點。我們的選擇是，實體EJB最常用于表示應用程序業務域中各個實體，所以應該讓實體EJB盡量地細粒度，不過也應將設計限定為僅提供一個本地接口。關于這個問題的爭論始于EJB體系結構規范1.x版本，當時只能通過一個遠程接口來訪問實體EJB。建立在EJB 1.x版本基礎上的任何反對使用細粒度實體EJB的觀點，雖然當時也有合理之處，但是在EJB體系結構規范2.0 中卻已不合時宜了，并且最終遭到反對。請謹記：有些專家可能不同意我們的觀點，所以我們鼓勵您通過實驗進行考證，并在此專題上形成自己的觀點。
數據傳輸對象與Get和Set方法
這又是一個有爭議的專題。我們的觀點如下所述：
- 在實體EJB的本地接口中暴露CMP持久字段的所有get訪問器（accessor）方法。
- 為不屬于實體EJB主鍵的一部分的每個CMP持久字段創建包裝器（wrapper）set方法，并且在實體EJB的本地接口中暴露這些包裝器方法。使用這些包裝器方法背后的動機是，CMP要求所有持久字段都具有抽象方法setXXX，如果需要在這些setXXX方法內進行任何驗證，那么就可以先在包裝器方法內完成驗證，然后再調用相應的setXXX方法。如果不需要這樣的驗證，那么省掉包裝器方法而直接包括setXXX方法也無不可。
- 在某些少見的環境下，可能要求實體EJB有一個遠程接口，這時可以為每個實體EJB定義一個數據傳輸對象，將該數據傳輸對象作為實體EJB的遠程接口中的一個參數，暴露其get和set方法。
生成和打包EJB
在EJB體系結構規范中，每個實體EJB組件都由一組指定的Java類和一組指定的XML部署描述符組成：
- 一個必需的實現實體bean核心功能的bean類。
- 一個遠程接口、本地接口或雙重接口，該接口為實體bean提供了適當的客戶機視圖。
- 一個遠程主接口（home interface）、本地主接口或者雙重主接口，該接口為實體bean的生命周期管理提供了適當的接口。
- 如果是具有組合主鍵的實體bean，那么還有一個必需的主鍵類。
- 一個ejb-jar XML部署描述符文件，EJB體系結構規范version 2.0對此作了規定。
- 一個特定于供應商的 weblogic-ejb-jar XML部署描述符文件，BEA WebLogic Server 8.1 對此有規定。
- 如果是CMP實體bean，那么還應有一個特定于供應商的weblogic-cmp-rdbms-jar XML 部署描述符文件，BEA WebLogic Server 8.1對此有規定。
這里使用的例子實體EJB是一個CMP實體EJB，它有一個遠程接口，它的名稱是AccountEJB。在隨WebLogic Server 8.1一起安裝的示例文件中，即 /weblogic81/samples/server/examples/src/examples/ejb20/basic/containerManaged目錄下，可以找到這個實體EJB。
實體bean EJB類和接口可以用EJBGen工具來生成。
EJBGen
EJBGen是一種EJB 2.0代碼生成器，它能夠從一個EJB bean類生成本地接口/遠程接口、本地主接口/遠程主接口、主鍵類和部署描述符。在EJB bean類中使用EJBGen標記來指定不同的EJB設計配置（例如，本地/遠程和CMP/BMP）。在WebLogic Server 8.1 SP01 中，EJBGen 類被包括在/weblogic81/server/lib/weblogic.jar中。在WebLogic Server 8.1 SP02 & SP03中，EJBGen類被包括在/weblogic81/server/lib/ejbgen.jar文件中。將ejbgen.jar添加到Classpath中，以便使用EJBGen工具。
EJBGen通過以下命令來調用：
javadoc -docletpath ejbgen.jar -doclet weblogic.tools.ejbgen.EJBGen
<EjbBeanClass>.java
該命令有一些選項：
- -d [directory]: 創建EJB類/接口和部署描述符時所在的目錄。
- -descriptorDir [directory]: 創建部署描述符時所在的目錄。
- -wls7: 有了–wls7這個選項，就會生成WebLogic Serve 7.1部署描述符。
如果要將更早版本的BEA WebLogic Server部署描述符轉換成WebLogic Server 8.1部署描述符，那么可以使用DDConverter。
DDConverter
DDConverter是一個命令行工具，用于將更早版本的XML部署描述符（ejb-jar.xml、weblogic-ejb-jar.xml和weblogic-cmp-rdbms-jar.xml）轉換成當前版本的WebLogic Server。 DDConverter可以用以下命令來調用：
java weblogic.ejb20.utils.DDConverter [options] –d destDir file1 [file2...]
在這個命令中，file是指包含EJB 1.1部署描述符的一個EJB 1.0部署描述符文件或JAR文件。DDConverter的一部分選項有：
- -d destDir:部署描述符輸出到的目錄。
- -EJBVer output EJB version: 指定輸出EJB版本。缺省版本是2.0。
在部署EJB之前，必須將其打包到一個JAR文件或EAR文件中。
EJB JAR文件
EJB JAR文件的結構由EJB類和接口以及包含部署描述符的 META-INF目錄組成。創建一個目錄source/ejb20/basic/containerManaged和一個目錄source/ejb20/basic/containerManaged/META-INF。將Account.java、AccountBean.java、AccountHome.java 和ProcessingErrorException.java從/weblogic81/samples/server/examples/src/examples/ejb20/basic/containerManaged目錄復制到source/ejb20/basic/containerManaged目錄。將ejb-jar.xml、weblogic-ejb-jar.xml和weblogic-cmp-rdbms-jar.xml從/weblogic81/samples/server/examples/src/examples/ejb20/basic/containerManaged目錄復制到source/ejb20/basic/containerManaged/META-INT目錄。
通過Apache Ant使用編譯好的EJB Java類文件和部署描述符創建一個JAR文件，Apache Ant 是一種基于Java的聯編（build）工具。Apache Ant工具需要一個聯編文件。創建一個帶有目標的build.xml文件（參見清單1），以便編譯EJB源文件并利用編譯好的類文件生成一個JAR 文件。
將build.xml文件復制到/source目錄。運行build.xml中的ejb-jar目標。EJB JAR文件生成在source/dist目錄中。EJB JAR可以使用BEA WebLogic appc編譯器來編譯。用appc編譯器來編譯并不是必需的，但這是BEA WebLogic推薦的。
appc
appc編譯器利用EJB JAR文件生成容器類，并驗證部署描述符。在部署EJB JAR文件之前用 appc編譯EJB JAR類的好處是，這樣可以識別出在部署EJB JAR時可能發生的錯誤。要運行 appc編譯器，應保證weblogic.jar被包括在Classpath中。appc可以通過以下命令來調用：
java weblogic.appc [options] <jar file or directory>
appc有一些選項：
- -output<file>:指定輸出目錄。
- -keepgenerated: 保留生成的.java文件。
- -compiler<java>: 將Java編譯器設置成可用。
部署EJB
要部署一個實體EJBJAR文件，必須有一個帶有Java命名和目錄接口（Java Naming and Directory Interface，JNDI）名稱的數據源。在我以前的文章（WLDJ, Vol. 3, issue 1）中我已解釋了如何創建連接池（Connection Pool）。用JNDI名 "examples-dataSource-demoPool" 創建一個Tx Datasource。這個JNDI 名應該與weblogic-cmp-rdbms-jar.xml部署描述符文件的 <data-source-name>元素中指定的名稱相一致。
為了部署實體EJB JAR文件，在管理控制臺（administration console）中選擇Deployments>EJB Modules節點。單擊Deploy a new EJB Module鏈接（見圖1）。
這時會顯示出Deploy an EJB Module窗體（見圖2）。在Deploy an EJB Module 窗體中選擇 upload your files(s) 鏈接。接著將會顯示一個Upload and Install an Application or Module 窗體。選擇一個要上載的EJB JAR文件，并單擊Upload按鈕。
這時會顯示出Deploy an EJB Module窗體。選擇myserver鏈接。接著可以看到myserver目錄中的子目錄列表。單擊upload directory鏈接。在upload目錄中選擇要部署的EJB JAR，并單擊Target Module按鈕（見圖3）。這時會顯示一個Select Targets for this EJB module窗體（見圖4）。
在Select targets for this EJB module窗體中選擇一個或多個目標服務器，并單擊Continue按鈕。在接著顯示出的窗體中，在Name字段中指定用于要部署的EJB模塊的名稱（見圖5）。
單擊Deploy按鈕以部署EJB JAR文件。這樣一來，EJB JAR將被部署到服務器上，并且有一個EJB節點被添加到EJB Modules節點中（見圖6）。
EJB應用程序還可以部署到BEA WebLogic Server上，方法是將EJB JAR文件復制到該應用程序要部署到的那個域上的applications目錄中。
BEA WebLogic為在 WebLogic服務器上部署EJB提供了一些建議。
- 應該將EJB作為企業歸檔應用程序（EAR應用程序）中的一個EJB JAR來部署，以利于應用程序的移植和修改。
- 引用了其他EJB的EJB應該部署在相同的應用程序中；weblogic-ejb-jar.xml中的enable-call-by-reference元素應該設置成True，以獲得更好的性能。
- 部署在WebLogic服務器群集上的EJB應該其次地（homogeneously）部署到群集內每一臺受管的服務器上。如果一個EJB只需部署到群集內的一臺服務器上，那么在部署之前應使用appc編譯器先對 EJB進行編譯。
結束語
EJB應用程序的開發包括創建EJB類、編譯EJB類和利用編譯好的EJB類創建一個JAR文件，以及將EJBJAR部署到BEA WebLogic Server。通過遵循關于設計、生成和部署EJB JAR到BEA WebLogic Server上的一些建議，EJB應用程序的性能得到了提高。
參考資料
l Programming WebLogic Enterprise JavaBeans: http://edocs.bea.com/wls/docs8.1/ejb/index.html
關于作者
Deepak Vohra 是一名 Web 開發人員，同時也是一名 NuBean 顧問。
Ajay Vohra 是Compuware 公司的一名高級軟件工程師。
Listing 1: build.xml file
<project name="example-entity-ejb" default="all" basedir=".">
<property name="source" value="."/>
<property name="ejb" value="ejb20/basic/containrManaged"/>
<property name="build" value="
{source}/build"/>
<property name="j2sdkee" value="c:/j2sdkee1.3.1"/>
<property name="dist" value="{source}/dist"/>
<target name="init">
<!-- Create the time stamp -->
<tstamp/>
<mkdir dir="{build}"/>
<mkdir dir="{build}/META-INF"/>
<mkdir dir="{dist}"/>
</target>
<target name="ejb">
<javac srcdir="{source}" classpath="{j2sdkee}/lib/j2ee.jar"
destdir="{build}" includes="{ejb}/*.java"/>
<copy todir="{build}/META-INF">
<fileset dir="META-INF" includes="*.xml" />
</copy>
</target>
<target name="ejb-jar" depends="ejb">
<jar jarfile="{dist}/entityejb.jar" includes="META-INF/*.xml,
{ejb}/*.class" basedir="{build}"/>
</target>
</project>