jier的博客

從request獲取各種路徑總結(jié)

request.getRealPath("url");//虛擬目錄映射為實(shí)際目錄
request.getRealPath("./");//網(wǎng)頁(yè)所在的目錄
request.getRealPath("../");//網(wǎng)頁(yè)所在目錄的上一層目錄

request.getContextPath();//應(yīng)用的web目錄的名稱
   如http://localhost:7001/bookStore/  
    /bookStore/      =>  [contextPath]  (request.getContextPath())

獲取Web項(xiàng)目的全路徑
String strDirPath = request.getSession().getServletContext().getRealPath("/");

posted @ 2007-10-12 10:30 夏雪 閱讀(2756) | 評(píng)論 (2) | 編輯 收藏

XDoclet

XDoclet起步

XDoclet是一個(gè)代碼生成工具，它可以把你從Java開(kāi)發(fā)過(guò)程中繁重的重復(fù)勞動(dòng)中解脫出來(lái)。XDoclet可以讓你的應(yīng)用系統(tǒng)開(kāi)發(fā)的更加快速，而你只要付比原先更少的努力。你可以把你手頭上的冗長(zhǎng)而又必需的代碼交給它幫你完成，你可以逃脫“deployment descriptor地獄”，你還可以使你的應(yīng)用系統(tǒng)更加易于管理。而你所要做的，只不過(guò)是在你的注釋里，多加一些類javadoc屬性。然后，你會(huì)驚訝于XDoclet為了做到的一切。
討論XDoclet，有一點(diǎn)比較容易產(chǎn)生混淆，那就是XDoclet不但是一系統(tǒng)的代碼生成應(yīng)用程序，而且它本身還是一個(gè)代碼生成框架。雖然每個(gè)應(yīng)用系統(tǒng)的細(xì)節(jié)千變?nèi)f化（比如EJB代碼生成和Struts代碼生成是不一樣的，而JMX代碼生成又是另一番景象），但這些代碼生成的核心概念和用法卻是類似的。
在這一章里，我們將會(huì)看到滲透到所有XDoclet代碼生成程序當(dāng)中的XDoclet框架基礎(chǔ)概念。但在之前，我們先從一個(gè)例子入手。

2.1 XDoclet in action

每一個(gè)程序員都會(huì)認(rèn)識(shí)到，他們的程序永遠(yuǎn)也不會(huì)完成。總會(huì)有另一些的功能需要添加，另一些的BUG需要修正，或者需要不斷的進(jìn)行重構(gòu)。所以，在代碼里添加注釋，提醒自己（或者其他的程序員）有哪些任務(wù)需要完成已成為一個(gè)共識(shí)。
如何來(lái)跟蹤這些任務(wù)是否完成了呢？理想情況下，你會(huì)收集整理出來(lái)一個(gè)TODO任務(wù)列表。在這方面，XDoclet提供了一個(gè)強(qiáng)大的TODO生成器，來(lái)幫助你完成這個(gè)任務(wù)。這是一個(gè)把XDoclet引入項(xiàng)目的好機(jī)會(huì)。
2.1.1 一個(gè)公共的任務(wù)
假設(shè)你正在開(kāi)發(fā)一個(gè)使用了勺子的類。
public class Matrix {
　　// TODO ? 需要處理當(dāng)沒(méi)有勺子的情況
　　public void reload() {
　　　　// ...
　　　　Spoon spoon = getSpoon();
　　　　// ...
　　}
}
理想情況下，你在下一次閱讀這段代碼的時(shí)候，你會(huì)處理這個(gè)“空勺子”(null spoon)的問(wèn)題。但如果你過(guò)了很久才回來(lái)看這段代碼，你還會(huì)記得在這個(gè)類里還有一些工作要做嗎？當(dāng)然，你可以在你的源碼里全局搜索TODO，甚至你的集成開(kāi)發(fā)環(huán)境有一個(gè)內(nèi)建的TODO列表支持。但如果你想把任務(wù)所在的類和方法也標(biāo)注出來(lái)的話，XDoclet可以是另一種選擇。XDoclet可以為你的項(xiàng)目生成一個(gè)TODO報(bào)表。

2.1.2 添加X(jué)Doclet標(biāo)簽
為了把你的TODO項(xiàng)目轉(zhuǎn)換成另一種更加正式的格式，你需要對(duì)代碼進(jìn)行一些細(xì)微的改動(dòng)。如下所示：
public class Matrix {
　　/** @todo 需要處理當(dāng)沒(méi)有勺子的情況 */
　　public void reload() {
　　　　// ...
　　}
}
這里加入了一個(gè)XDoclet需要的類javadoc標(biāo)簽。XDoclet會(huì)使用這些標(biāo)簽標(biāo)記的信息，以及在這種情況下標(biāo)簽所處的類和方法，來(lái)生成TODO報(bào)表。

2.1.3 與Ant集成
要生成TODO報(bào)表，你需要確保在你的機(jī)器上正確安裝了XDoclet。
在Ant任務(wù)里，最少要包含一個(gè)目標(biāo)（例如init目標(biāo)）定義<documentdoclet>任務(wù)，這是一個(gè)Ant自定義任務(wù)，例如：
　　<taskdef name=”documentdoclet”
　　　　classname=”xdoclet.modules.doc.DocumentDocletTask”
　　　　classname=”xdoclet.lib.path” />
這個(gè)<documentdoclet>任務(wù)是XDoclet核心代碼生成應(yīng)用程序中的一個(gè)。
現(xiàn)在，你可以在Ant構(gòu)建文件中加入一個(gè)todo目標(biāo)調(diào)用這個(gè)任務(wù)來(lái)生成TODO報(bào)表，如：
　　<target name=”todo” depends=”init”>
　　　　<documentdoclet destdir=”todo”>
　　　　　　<fileset dir=”${dir.src}”>
　　　　　　　　<include name=”**/*.java” />
　　　　　　</fileset>
　　　　　　<info/>
　　　　</documentdoclet>
　　</target>
<info>子任務(wù)會(huì)遍歷你的源文件，查找todo標(biāo)簽，并在todo子目錄下生成HTML格式的TODO報(bào)表。

2.1.4 創(chuàng)建一個(gè)更加職業(yè)化的TODO報(bào)表
XDoclet生成的TODO報(bào)表可以有一個(gè)更加職業(yè)化的外表。報(bào)表會(huì)列出一個(gè)概覽，顯示在哪個(gè)包哪個(gè)類里有todo項(xiàng)（以及todo項(xiàng)的個(gè)數(shù)）。Todo項(xiàng)可以跟在方法、類和域上，從報(bào)表上可以清楚的區(qū)別它們。類級(jí)別的todo項(xiàng)會(huì)標(biāo)注class，方法級(jí)別的todo項(xiàng)會(huì)在方法簽名上標(biāo)注M。構(gòu)造函數(shù)和域相關(guān)的todo項(xiàng)也會(huì)進(jìn)行相似的標(biāo)注。
這個(gè)任務(wù)看起來(lái)很簡(jiǎn)單，但考慮到你所需要做的只是在注釋上添加一些格式化的@todo標(biāo)簽，相對(duì)于那種只有人才可以理解的無(wú)格式的松散的注釋，這種標(biāo)簽是機(jī)器可讀的，也更容易編程處理。生成的輸出也更容易閱讀并且更加的商業(yè)化。

2.2 任務(wù)和子任務(wù)
生成todo報(bào)表，只是XDoclet可以完成的事情當(dāng)中的冰山一角。當(dāng)初，XDoclet因?yàn)榭梢宰詣?dòng)生成EJB繁雜的接口和布署描述文件而聲名鵲起。然而，現(xiàn)在的XDoclet已經(jīng)發(fā)展成了一個(gè)全功能的、面向?qū)傩缘拇a生成框架。J2EE代碼生成只是XDoclet的一個(gè)應(yīng)用方面，它可以完成的任務(wù)已經(jīng)遠(yuǎn)遠(yuǎn)超越了J2EE和項(xiàng)目文檔的生成。

2.2.1 XDoclet 任務(wù)
到現(xiàn)在為止，我們一直在討論使用XDoclet生成代碼，但事實(shí)上，更確切的說(shuō)法應(yīng)該是，我們使用XDoclet的一個(gè)特定的任務(wù)來(lái)生成代碼，比如<ejbdoclet>。每一個(gè)XDoclet任務(wù)關(guān)注于一個(gè)特定的領(lǐng)域，并提供這個(gè)領(lǐng)域的豐富的代碼生成工具。
[定義：任務(wù)（Tasks）是XDoclet里可用的代碼生成應(yīng)用程序的高層概念。]
在XDoclet里，目前已有如下所示的七個(gè)核心任務(wù)。
<ejbdoclet>：面向EJB領(lǐng)域，生成EJB、工具類和布署描述符。
<webdoclet>：面向Web開(kāi)發(fā)，生成serlvet、自定義標(biāo)簽庫(kù)和web框架文件。
<hibernatedoclet>：Hibernate持續(xù)，配置文件、Mbeans
<jdodoclet>：JDO，元數(shù)據(jù)，vender configuration
<jmxdoclet>：JMX，MBean接口，mlets，配置文件。
<doclet>：使用用戶自定義模板來(lái)生成代碼。
<documentdoclet>：生成項(xiàng)目文件（例如todo列報(bào)表）
這其中，<ejbdoclet>最常用，并且很多項(xiàng)目也僅僅使用XDoclet來(lái)進(jìn)行EJB代碼生成。<webdoclet>是其次一個(gè)常用的代碼生成任務(wù)。當(dāng)然，在一個(gè)項(xiàng)目中同時(shí)使用幾個(gè)XDoclet任務(wù)是可能的（并且也是推薦的），但在這些任務(wù)之間是完全獨(dú)立的，它們彼此之間并不能進(jìn)行直接的交流。

2.2.2 XDoclet子任務(wù)
XDoclet的任務(wù)是領(lǐng)域相關(guān)的，而在某個(gè)特定領(lǐng)域的XDoclet任務(wù)，又由許許多多緊密耦合在一起的子任務(wù)組成的，這些子任務(wù)每個(gè)都僅僅執(zhí)行一個(gè)非常特定和簡(jiǎn)單的代碼生成任務(wù)。
[定義：子任務(wù)（subtasks）是由任務(wù)提供的單目標(biāo)的代碼生成過(guò)程]
任務(wù)提供子任務(wù)執(zhí)行時(shí)的上下文，并且把這些相關(guān)的子任務(wù)組織管理了起來(lái)。任務(wù)會(huì)依賴這些子任務(wù)來(lái)生成代碼。在一個(gè)任務(wù)當(dāng)中調(diào)用多個(gè)子任務(wù)來(lái)協(xié)同完成各種各樣比較大型的代碼生成任務(wù)是非常常見(jiàn)的。比如，在開(kāi)發(fā)EJB時(shí)，你可能想要為每一個(gè)bean生成一個(gè)home接口，一個(gè)remote接口以及ejb-jar.xml布署描述符文件。這就是在<ejbdoclet>任務(wù)的上下文環(huán)境中的三個(gè)獨(dú)立的代碼生成子任務(wù)。
子任務(wù)可以隨意的組合排列，以滿足項(xiàng)目代碼生成的需要。某個(gè)XDoclet任務(wù)包含的子任務(wù)經(jīng)常會(huì)共享功能和在源文件中使用相同的XDoclet標(biāo)簽。這意味著當(dāng)你開(kāi)始一個(gè)任務(wù)的時(shí)候，你可以很容易的集成進(jìn)一個(gè)相關(guān)的子任務(wù)，而不需要很大的改動(dòng)。

子任務(wù)交互
讓我們以<ejbdoclet>任務(wù)為例，看一下相關(guān)的子任務(wù)之間是如何進(jìn)行關(guān)聯(lián)的。假設(shè)你正在開(kāi)發(fā)一個(gè)CMP（容器管理持久化）實(shí)體Bean。你想要使用一些<ejbdoclet>的子任務(wù)：
•<deploymentdescriptor>：生成ejb-jar.xml布署描述符文件。
•<localhomeinterface>：生成local home接口。
•<localinterface>：生成local接口。
在執(zhí)行如上子任務(wù)的時(shí)候，你需要標(biāo)記出你的實(shí)體Bean的CMP域。當(dāng)你發(fā)布你的bean的時(shí)候，你還需要在開(kāi)發(fā)商相關(guān)的布署描述符中提供某個(gè)特定的關(guān)系數(shù)據(jù)庫(kù)中的特定表和列與你的CMP實(shí)體Bean的映射關(guān)系。XDoclet可以讓你在原先已存在的CMP XDoclet屬性基礎(chǔ)上再加上一些關(guān)系映射屬性，然后，你就可以在任務(wù)中加入一個(gè)開(kāi)發(fā)商相關(guān)的子任務(wù)（例如<jboss>或者<weblogic>）來(lái)生成布署描述符文件。XDoclet提供了幾乎所有的應(yīng)用服務(wù)器的支持，你只需要一些初始化的小改動(dòng)，就可以進(jìn)行這些應(yīng)用服務(wù)器相關(guān)的代碼生成了。
但那只是冰山一角。你還可以使用<entitycmp>子任務(wù)為為你的bean生成一個(gè)實(shí)體bean接口的實(shí)現(xiàn)子類。如果你使用<valueobject>子任務(wù)來(lái)為了你的bean生成值對(duì)象，<entityemp>子任務(wù)還會(huì)為你的值對(duì)象生成方法的實(shí)現(xiàn)代碼。
覺(jué)得不可思議了吧。可惜XDoclet沒(méi)有提供<cupofcoffee>子任務(wù)，要不然我們可以喝杯咖啡，休息一下啦。
這里不是想向你介紹<ejbdoclet>所有的子任務(wù)或者<ejbdoclet>可以完成的所有代碼生成功能，而僅僅是想向你展示一下任務(wù)的子任務(wù)之間是如何工作在一起的。一旦你開(kāi)始并熟悉了一個(gè)XDoclet 子任務(wù)，熟悉另一個(gè)子任務(wù)會(huì)變得非常簡(jiǎn)單- 那種每個(gè)子任務(wù)都是孤立的相比，使用這種可以相互協(xié)作的子任務(wù)，開(kāi)發(fā)成本會(huì)顯著的降低，效果也更加的立竿見(jiàn)影。 

2.3 使用Ant執(zhí)行任務(wù)
XDoclet“嫁”給了Ant。XDoclet任務(wù)就是Ant的自定義任務(wù)，除此以外，沒(méi)有其他運(yùn)行XDoclet任務(wù)的方法。所幸的是，Ant已經(jīng)成為了Java構(gòu)建工具事實(shí)上的標(biāo)準(zhǔn)，所以這不算什么限制。事實(shí)上，反過(guò)來(lái)，XDoclet與Ant的這種“親密”關(guān)系使得XDoclet可以參與到任何Ant構(gòu)建過(guò)程當(dāng)中去。
2.3.1 聲明任務(wù)
XDoclet并沒(méi)有和Ant一起發(fā)布，所以如果你想要使用XDoclet的話，就需要單獨(dú)的下載和安裝。在使用任何一個(gè)XDoclet的任務(wù)之前，你首先需要在使用Ant的<taskdef>任務(wù)來(lái)聲明它。例如：
<taskdef name=”ejbdoclet”
　　classname=”xdoclet.modules.ejb.EjbDocletTask”
　　classpathref=”xdoclet.lib.path”/>
如果你熟悉Ant的話，你就會(huì)知道這段代碼是告訴Ant加載<ejbdoclet>的任務(wù)定義。當(dāng)然，你也可以以你喜歡的任何方式來(lái)命名這個(gè)自定義任務(wù)，但最好還是遵守標(biāo)準(zhǔn)的命名規(guī)律以免發(fā)生混淆。classname和classpathref屬性告訴Ant到哪里去找實(shí)現(xiàn)這個(gè)自定義任務(wù)的XDoclet類。如果你想使用其他的XDoclet任務(wù)，就必須要類似這樣首先聲明這個(gè)任務(wù)。
一般共通的做法是，把所有需要使用的XDoclet任務(wù)都放在Ant的一個(gè)目標(biāo)里聲明，這樣在其他的目標(biāo)里如果需要使用這些任務(wù)，只要depends這個(gè)任務(wù)就可以了。你可能已經(jīng)在Ant的構(gòu)建文件里包含了init目標(biāo)，這就是放置XDoclet任務(wù)聲明的好地方（當(dāng)然如果你沒(méi)有，你也可以建一個(gè)）。下面的例子就是在一個(gè)init目標(biāo)里加入了<ejbdoclet>和<webdoclet>的聲明：
<target name=”init”>
　　<taskdef name=”documentdoclet”
　　　　classname=”xdoclet.modules.doc.DocumentDocletTask”
　　　　classpathref=”xdoclet.lib.path” />
　　　　<taskdef name=”ejbdoclet”
　　　　　　classname=”xdoclet.modules.ejb.EjbDocletTask”
　　　　　　classpathref=”xdoclet.lib.path” />
　　　　<taskdef name=”webdoclet”
　　　　　　classname=”xdoclet.modules.web.WebDocletTask”
　　　　　　classpathref=”xdoclet.lib.path” />
</target>
現(xiàn)在，任務(wù)聲明好了，XDoclet“整裝待發(fā)”。

2.3.2 使用任務(wù)
你可以在任何目標(biāo)里使用聲明好的任務(wù)。在任務(wù)的上下文環(huán)境里，可以調(diào)動(dòng)相關(guān)的子任務(wù)。讓我們看一個(gè)例子，這個(gè)例子調(diào)用了<ejbdoclet>任務(wù)。不要擔(dān)心看不懂語(yǔ)法的細(xì)節(jié)，現(xiàn)在你只需要關(guān)心一些基礎(chǔ)概念就可以了。
<target name=”generateEjb” depends=”init”>
　　<ejbdoclet destdir=”${gen.src.dir}”>
　　　　<fileset dir=”${src.dir}”>
　　　　　　<include name=”**/*Bean.java”/>
　　　　</fileset>
　　<deploymentdescriptor destdir=”${ejb.deployment.dir}”/>
　　<homeinterface/>
　　<remoteinterface/>
　　<localinterface/>
　　　<localhomeinterface/>
　　</ejbdoclet>
</target>
把任務(wù)想像成一個(gè)子程序運(yùn)行時(shí)需要的一個(gè)配置環(huán)境（記住，子任務(wù)才是真正進(jìn)行代碼生成工作的）。當(dāng)調(diào)用一個(gè)子任務(wù)時(shí)，子任務(wù)從任務(wù)繼承上下文環(huán)境，當(dāng)然，你也可以根據(jù)需要隨意的覆蓋這些值。在上面的例子里，因?yàn)?lt;deploymentdescriptor>子任務(wù)生成的布署描述符文件和其他生成各種接口的子任務(wù)生成的Java源文件需要放在不同的位置，所以覆蓋了destdir的屬性值。布署描述符文件需要放在一個(gè)在打包EJB JAR文件的時(shí)候可以容易包含進(jìn)來(lái)的地方，而生成的Java代碼則需要放置在一個(gè)可以調(diào)用Java編譯器進(jìn)行編譯的地方。需要這些子任務(wù)之間是緊密關(guān)聯(lián)的，但只要你需要，你可以有足夠的自主權(quán)控制任務(wù)的生成環(huán)境。
<fileset>屬性同樣被應(yīng)用到所有的子任務(wù)。這是一個(gè)Ant的復(fù)雜類型（相對(duì)于文本和數(shù)值的簡(jiǎn)單類型），所以以子元素的方式在任務(wù)中聲明。不要把它和子任務(wù)混為一談。當(dāng)然，如果你想在某個(gè)子任務(wù)中另外指定一個(gè)不同的輸入文件集，你也可以在這個(gè)子任務(wù)中放置一個(gè)<fileset>子元素來(lái)覆蓋它。
子任務(wù)的可配置選項(xiàng)遠(yuǎn)遠(yuǎn)不止這些。我們會(huì)在下一章繼續(xù)介紹所有的任務(wù)和子任務(wù)，以及常用的配置選項(xiàng)。

2.4 用屬性標(biāo)注你的代碼
可重用的代碼生成系統(tǒng)需要輸入來(lái)生成感興趣的輸出。一個(gè)解析器生成器也需要一個(gè)語(yǔ)言描述來(lái)解析生成解析器。一個(gè)商務(wù)對(duì)象代碼生成器需要領(lǐng)域模型來(lái)知道要生成哪些商務(wù)對(duì)象。XDoclet則需要Java源文件做為輸出來(lái)生成相關(guān)的類或者布署/配置文件。
然而，源文件可能并沒(méi)有提供代碼生成所需要的所有信息。考慮一個(gè)基于servlet的應(yīng)用，當(dāng)你想生成web.xml文件的時(shí)候，servlet源文件僅可以提供類名和適當(dāng)?shù)膕ervlet接口方法。其他的信息比如URI pattern映射、servlet需要的初始化參數(shù)等信息并沒(méi)有涵蓋。顯而易見(jiàn)，如果class并沒(méi)有提供這些信息給你，你就需要自己手動(dòng)在web.xml文件時(shí)填寫(xiě)這些信息。
XDoclet當(dāng)然也不會(huì)知道這些信息。幸運(yùn)的是，解決方法很簡(jiǎn)單。如果所需信息在源文件時(shí)沒(méi)有提供，那就提供它，做法就是在源文件里加入一些XDoclet屬性。XDoclet解析源文件，提取這些屬性，并把它們傳遞給模板，模板使用這些信息生成代碼。

2.4.1 剖析屬性
XDoclet屬性其實(shí)就是javadoc的擴(kuò)展。它們?cè)谕獗砩虾褪褂蒙隙加衘avadoc屬性一樣，可以放置在javadoc文檔注釋里。文檔注釋以/**開(kāi)始，*/結(jié)尾。下面是一個(gè)簡(jiǎn)單的例子：
/**
* 這是一段javadoc注釋。
* 注釋可以被分解成多行，每一行都以星號(hào)開(kāi)始。
*/
在注釋里的所有文本都被視為javadoc注釋，并且都能夠被XDoclet訪問(wèn)到。注釋塊一般都與Java源文件中的某個(gè)實(shí)體有關(guān)，并緊跟在這個(gè)實(shí)體的前面。沒(méi)有緊跟實(shí)體的注釋塊將不會(huì)被處理。類（或者接口）可以有注釋塊，方法和域也可以有自己的注釋塊，比如：
/**
* 類注釋塊
*/
public class SomeClass {
　　/** 域注釋塊 */
　　private int id;
　　/**
* 構(gòu)造函數(shù)注釋塊
*/
　　public SomeClass() {
　　　　// ...
　　}
　　/**
　　 * 方法注釋塊
　　 */
　　public int getId() {
　　　　return id;
　　}
}
注釋塊分成兩部分：描述部分和標(biāo)簽部分。當(dāng)遇到第一個(gè)javadoc標(biāo)簽時(shí)，標(biāo)簽部分開(kāi)始。Javadoc標(biāo)簽也分成兩部分：標(biāo)簽名和標(biāo)簽描述。標(biāo)簽描述是可選的，并且可以多行。例如：
/**
* 這是描述部分
* @tag1 標(biāo)簽部分從這里開(kāi)始
* @tag2
* @tag3 前面一個(gè)標(biāo)簽沒(méi)有標(biāo)簽描述。
* 這個(gè)標(biāo)簽有多行標(biāo)簽描述。
*/
XDoclet使用參數(shù)化標(biāo)簽擴(kuò)展了javadoc標(biāo)簽。在XDoclet里，你可以在javadoc標(biāo)簽的標(biāo)簽描述部分加入name=”value”參數(shù)。這個(gè)微小的改動(dòng)大大增強(qiáng)了javadoc標(biāo)簽的表達(dá)能力，使得javadoc標(biāo)簽可以用來(lái)描述復(fù)雜的元數(shù)據(jù)。下面的代碼顯示了使用XDoclet屬性描述實(shí)體Bean方法：
/**
* @ejb.interface-method
* @ejb.relation
* name=”blog-entries”
* role-name=”blog-has-entries”
* @ejb.value-object
* compose=”com.xdocletbook.blog.value.EntryValue”
* compose-name=”Entry”
* members=”com.xdocletbook.blog.interfaces.EntryLocal”
* members-name=”Entries”
* relation=”external”
* type=”java.util.Set”
*/
public abstract Set getEntries();
參數(shù)化標(biāo)簽允許組合邏輯上相關(guān)聯(lián)的屬性。你可以加入描述這個(gè)類的元信息，使得這個(gè)類的信息足夠生成代碼。另外，程序員借由閱讀這樣的元信息，可以很快的理解這個(gè)類是如何使用的。（如果這個(gè)例子上的元信息你看不懂，不要擔(dān)心，在第4章里，我們會(huì)學(xué)到EJB相關(guān)的標(biāo)簽以及它們的涵意。）
另外，請(qǐng)注意上面的例子中，所有的標(biāo)簽名都以ejb開(kāi)頭。XDoclet使用namespace.tagname的方式給標(biāo)簽提供了一個(gè)命名空間。這樣做除了可以跟javadoc區(qū)別開(kāi)來(lái)以外，還可以把任務(wù)相關(guān)的標(biāo)簽組織起來(lái)，以免任務(wù)之間的標(biāo)簽產(chǎn)生混淆。 

2.5 代碼生成模式
XDoclet是一種基于模板的代碼生成引擎。從高層視圖上來(lái)看，輸出文件其實(shí)就是由解析執(zhí)行各式各樣的模板生成出來(lái)的。如果你理解了模板以及它所執(zhí)行的上下文環(huán)境，就可以確切的認(rèn)識(shí)到，XDoclet可以生成什么，不可以生成什么。如果你正在評(píng)估XDoclet平臺(tái)，理解這些概念是非常重要的。要不然，你可能會(huì)錯(cuò)過(guò)XDoclet的許多強(qiáng)大的功能，也可能會(huì)被XDoclet的一些限制感到迷惑。
XDoclet運(yùn)行在在Ant構(gòu)建文件環(huán)境中，它提供了Ant自定義任務(wù)和子任務(wù)來(lái)與XDoclet引擎交互。任務(wù)是子任務(wù)的容器，子任務(wù)負(fù)責(zé)執(zhí)行代碼生成。子任務(wù)調(diào)用模板。模板提供了你將生成代碼的餅干模子。XDoclet解析輸入的源文件，提取出源文件中的XDoclet屬性元數(shù)據(jù)，再把這些數(shù)據(jù)提供給模板，驅(qū)動(dòng)模板執(zhí)行。除此之外，模板還可以提供合并點(diǎn)(merge points)，允許用戶插入一些模板片斷(合并文件merge files)來(lái)根據(jù)需要定制代碼生成。
2.5.1 模板基礎(chǔ)
XDoclet使用代碼模板來(lái)生成代碼。模板(template)是你想生成文件的原型。模板里使用一些XML標(biāo)簽來(lái)指導(dǎo)模板引擎如何根據(jù)輸入類以及它們的元數(shù)據(jù)來(lái)調(diào)整代碼的生成。
[定義：模板(template)是生成代碼或描述文件的抽象模視圖。當(dāng)模板被解析的時(shí)候，指定的細(xì)節(jié)信息會(huì)被填入。]
模板一般情況下會(huì)有一個(gè)執(zhí)行環(huán)境。模板可能應(yīng)用在一個(gè)類環(huán)境(轉(zhuǎn)換生成transform generation)，也有可能應(yīng)用在一個(gè)全局環(huán)境(聚集生成aggregate generation)。轉(zhuǎn)換生成和聚集生成是XDoclet的兩種類型的任務(wù)模式，理解它們之間的區(qū)別對(duì)于理解XDoclet是非常重要的。
當(dāng)你使用XDoclet生成布置描述符文件時(shí)，你使用的是聚集生成。布置描述符文件并不僅僅只與一個(gè)類相關(guān)，相反，它需要從多個(gè)類里聚集信息到一個(gè)輸入文件。在這種生成模式里，解析一次模板只會(huì)生成一個(gè)輸出文件，不管有多少個(gè)輸入文件。
在轉(zhuǎn)換生成模式里，模板遇到每一個(gè)源文件就會(huì)解析一次，根據(jù)該文件類的上下文環(huán)境生成輸出。這種生成模式會(huì)為每一個(gè)輸入文件生成一個(gè)輸出文件。
轉(zhuǎn)換生成模式的一個(gè)很好的例子是生成EJB的local和remote接口。顯然，接口是和Bean類一一相關(guān)的。從每一個(gè)類里提取信息(類以及它的方法、域、接口以及XDoclet屬性等信息)轉(zhuǎn)換出接口。除此以外，不需要其他的信息。
從實(shí)現(xiàn)里提取出接口似乎有點(diǎn)反向。如果你手寫(xiě)程序的話，一般來(lái)說(shuō)會(huì)先定義一個(gè)接口，然后再寫(xiě)一個(gè)類來(lái)關(guān)現(xiàn)它。但XDoclet做不到，XDoclet不可能幫你實(shí)現(xiàn)一個(gè)已有接口，因?yàn)樗豢赡軒湍闵赡愕臉I(yè)務(wù)邏輯。當(dāng)然，如果業(yè)務(wù)邏輯可以從接口本身得到(比如JavaBean的get/set訪問(wèn)器)或者使用XDoclet屬性聲明好，那么生成業(yè)務(wù)邏輯代碼來(lái)實(shí)現(xiàn)一個(gè)接口也不是不可能。但一般情況下，這樣做不太現(xiàn)實(shí)。相比而言，提供一個(gè)實(shí)現(xiàn)，并描述接口與這個(gè)實(shí)現(xiàn)之間的關(guān)聯(lián)就容易多了。
聚集生成和轉(zhuǎn)換生成主要區(qū)別在它們的環(huán)境信息上。即使一個(gè)代碼生成任務(wù)中生成一個(gè)Java文件，一般也不常用聚集生成，因?yàn)樯梢粋€(gè)Java類還需要一些重要信息如類所處的包以及你想生成的類名，在這種環(huán)境下是無(wú)法提供的。如果一定要使用聚集生成的話，那就需要在另一個(gè)單獨(dú)的地方提供好配置信息了。
2.5.2 模板標(biāo)簽
在還沒(méi)見(jiàn)到模板長(zhǎng)啥樣子之前，我們已經(jīng)比較深入的認(rèn)識(shí)它了。那模板文件究竟長(zhǎng)啥樣子呢？它有點(diǎn)像JSP文件。它們都包含文件和XML標(biāo)簽，生成輸出文件時(shí)XML標(biāo)簽會(huì)被解析，然后生成文本并顯示在XML標(biāo)簽所處的位置上。除了以XDt為命名空間打頭的XML標(biāo)簽會(huì)被XDoclet引擎解析以外，其余的XML標(biāo)簽XDoclet會(huì)忽略不管。下面的代碼片斷顯示了XDoclet模板的“經(jīng)典造型”：
　　public class
　　　　<XDtClass:classOf><XDtEjbFacade:remoteFacadeClass/></XDtClass:classOf>
　　　　Extends Observabe {
　　　　static <XDtClass:classOf><XDtEjbFacade:remoteFacadeClass/></XDtClass:classOf>
　　　　　　_instance = null;
　　　　public static <XDtClass:classOf><XDtEjbFacade:remoteFacadeClass/></XDtClassOf>
　　　　　　getInstance() {
　　　　　　if (_instance == null) {
　　　　　　　　_instance =
new <XDtClass:classOf><XDtEjbFacade:remoteFacadeClass/>
　　　　　　　　　　</XDtClass:classOf>();
　　　　　　｝
　　　　　　return _instance;
}
}
研究一下這個(gè)模板，你會(huì)發(fā)現(xiàn)，它生成的是一個(gè)類定義。這個(gè)類里定義了一個(gè)靜態(tài)變量instance，并且使用一個(gè)靜態(tài)方法來(lái)控制這個(gè)靜態(tài)文件的訪問(wèn)。借助Java語(yǔ)法，你可以很容易的推斷出那些XDoclet模板標(biāo)簽的目錄是生成類名，雖然對(duì)于這個(gè)標(biāo)簽如何工作你還并不是很了解。
即使你從沒(méi)打算過(guò)要自己寫(xiě)模板，但理解模板是如何被解析運(yùn)行的還是很有必要的。遲早你會(huì)調(diào)用到一個(gè)運(yùn)行失敗的XDoclet任務(wù)，沒(méi)有產(chǎn)生你所期望的輸出，那么最快捷的找出原因的方法就是直接檢查模板文件，看看是哪里出了問(wèn)題。
讓我們看一下生成靜態(tài)域定義的片斷：
static <XDtClass:classOf><XDtEjbFacade:remoteFacadeClass/></XDtClass:classOf>
　　　　_instance = null;
在XDoclet的眼里，這段模板代碼很簡(jiǎn)單，那就是：
　　static <tag/> _instance = null;
XDoclet解析執(zhí)行標(biāo)簽，如果有輸出的話，把輸入置回到文本里去。有些標(biāo)簽會(huì)執(zhí)行一些運(yùn)算，把輸出放回到一個(gè)流里。這樣的標(biāo)簽稱之為內(nèi)容標(biāo)簽(content tags)，因?yàn)樗鼈儺a(chǎn)生內(nèi)容。
另一種類型的標(biāo)簽稱之為BODY標(biāo)簽。BODY標(biāo)簽在開(kāi)始和結(jié)束標(biāo)簽之間存在文本。而B(niǎo)ODY標(biāo)簽強(qiáng)大就強(qiáng)大在這些文本自己也可以是一斷可以由外圍標(biāo)簽解析的模板片斷。比如在上面的例子里，XDtClass:classOf標(biāo)簽，它們的內(nèi)容就是模板片斷：
　　<XDtEjbFacade:remoteFacadeClass/>
classOf標(biāo)簽解析這段模板，提取出全限制的內(nèi)容，然后剃除前面的包面，只輸出類名。BODY標(biāo)簽并不總是會(huì)解析它的內(nèi)容，在做這件事之前，它們會(huì)事先檢查一些外部判斷條件(比如檢查檢查你正在生成的是一個(gè)接口還是一個(gè)類)。這里標(biāo)標(biāo)簽稱之為條件標(biāo)簽(conditional tags)。還有一些BODY標(biāo)簽提供類似迭代的功能，它的內(nèi)容會(huì)被解析多次。比如一個(gè)標(biāo)簽針對(duì)類里的每一個(gè)方法解析一次內(nèi)容。
XDoclet標(biāo)簽提供了許多高層次的代碼生成功能，但是有時(shí)候，它們可能顯得不夠靈活，或者表達(dá)能力滿足不了你的需要。這時(shí)候，相對(duì)于另外開(kāi)發(fā)一套通用功能的模板引擎相比，你可以選擇擴(kuò)展XDoclet模板引擎。你可以使用更具表述能力、功能更加強(qiáng)大的Java平臺(tái)開(kāi)發(fā)你自己的一套標(biāo)簽。 

2.6 使用合并定制
代碼生成系統(tǒng)之所以使用的不多，主要原因就在于它們往往只能生成一些死板的、不夠靈活的代碼。大多數(shù)代碼生成系統(tǒng)不允許你改動(dòng)它們生成的代碼；如果，如果這個(gè)系統(tǒng)不夠靈活，你所能做到的最好的擴(kuò)展就是應(yīng)用繼承擴(kuò)展生成的代碼，或者使用一些共通的設(shè)計(jì)模式(比如Proxy和Adaptor)來(lái)滿足你的需要。無(wú)論如此，這都不是產(chǎn)生你想生成的代碼的好辦法。代碼生成器最好能做到所生成即所得WYGIWYG(what you generate is what you get)，來(lái)取代你需要花費(fèi)大量的時(shí)間來(lái)粉飾生成出來(lái)的并不滿足要求的代碼。所以，對(duì)于代碼生成器來(lái)說(shuō)，支持靈活的定制，是生成能夠完全滿足要求的代碼的前提條件。
XDoclet通過(guò)合并點(diǎn)(merge points)支持定制??合并點(diǎn)是在模板文件定義里允許運(yùn)行時(shí)插入定制代碼的地方。有時(shí)候，合并點(diǎn)甚至可以影響到全局代碼的生成，不但允許你添加一些定制內(nèi)容，還可以從根本上改變將要生成出來(lái)的東西。
[定義：合并點(diǎn)(Merge points)是模板預(yù)先定義的允許你在代碼生成的運(yùn)行時(shí)加入定制內(nèi)容的擴(kuò)展點(diǎn)]
讓我們研究一段從XDoclet源代碼里摘取出來(lái)的模板代碼。在為實(shí)體Bean生成主鍵的模板末尾，定義了這樣一個(gè)合并點(diǎn)：
　　<XDtMerge:merge file=”entitypk-custom.xdt”></XDtMerge:merge>
如果你在你的merge目錄下創(chuàng)建了一個(gè)名為entitypk-custom.xdt文件，那么這個(gè)模板文件的內(nèi)容將會(huì)在這個(gè)合并點(diǎn)被包含進(jìn)來(lái)。你的定制可以執(zhí)行高層模板可以執(zhí)行的所有強(qiáng)大功能，可以進(jìn)行所有模板可以進(jìn)行的運(yùn)算(包括定義自定義標(biāo)簽，定義它們自己的合并點(diǎn))。
上面的這種合并點(diǎn)，為所有的類環(huán)境使用了同一個(gè)文件。當(dāng)然，也可以為每一個(gè)類環(huán)境使用不同的合并文件。如果你不想定制全部的類文件，或者你不想為了某些改動(dòng)而重寫(xiě)模板的時(shí)候，這會(huì)很有用。不管動(dòng)機(jī)是什么，逐類的合并點(diǎn)很容易識(shí)別出來(lái)：他們會(huì)在名字里包含一個(gè)XDoclet的逐類標(biāo)記{0}。這里有一個(gè)生成ejb-jar.xml文件里的安全角色引用的例子：
　　<XDtMerge:merge file=”ejb-sec-rolerefs-{0}.xml”>
　　　　<XDtClass:forAllClassTags tagName=”ejb:security-role-ref”>
　　　　　　<security-role-ref>
　　　　　　　　<role-name>
<XDtClass:classTagValue
tagName=”ejb:security-roleref”
paramName=”role-name”/>
　　　　　　　　</role-name>
　　　　　　　　<role-link>
　　　　　　　　　　<XDtClass:classTagValue
　　　　　　　　　　　　tagName=”ejb:security-roleref”
　　　　　　　　　　　　paramName=”role-link”/>
　　　　　　　　</role-link>
　　　　　　</security-role-ref>
　　　　</XDtClass:forAllClassTags>
　　</XDtMerge:merge>
這段模板會(huì)遍歷工程里的所有Bean。對(duì)于每一個(gè)Bean，XDoclet先從Bean的文件名里提取出Bean名，然后替換{0}，再根據(jù)替換后的文件名去尋找合并文件。例如，如果你有一個(gè)名為BlogFacadeBean的Bean，XDoclet會(huì)嘗試尋找一個(gè)名為ejb-src-rolerefs-BlogFacade.xml的合并文件。
如果找不到這個(gè)合并文件，則這個(gè)<merge>標(biāo)簽的內(nèi)容模板會(huì)被解析。這意味著合并點(diǎn)不僅可以提供定制內(nèi)容，還可以在一個(gè)模板文件里定義一個(gè)替換點(diǎn)，當(dāng)定制內(nèi)容不存在的時(shí)候使用替換點(diǎn)里的內(nèi)容。不是所有的XDoclet任務(wù)都提供了有替換內(nèi)容的合并點(diǎn)，一般來(lái)說(shuō)，它們更傾向于只提供一個(gè)簡(jiǎn)單的合并點(diǎn)，僅僅當(dāng)合并文件存在的時(shí)候解析并導(dǎo)入合并文件的內(nèi)容。這取決于任務(wù)的開(kāi)發(fā)者覺(jué)得哪種合并點(diǎn)更符合他的要求。
還有一點(diǎn)沒(méi)有介紹到的是XDoclet如何定位合并文件，每一個(gè)XDoclet任務(wù)或者子任務(wù)都會(huì)提供一個(gè)mergeDir屬性，這個(gè)屬性用于設(shè)置你存放合并文件的目錄。 

posted @ 2007-09-30 15:59 夏雪 閱讀(1018) | 評(píng)論 (0) | 編輯 收藏

EJB技術(shù)

一、EJB技術(shù)簡(jiǎn)介 EJB的全稱是Enterprise java bean。是JAVA中的商業(yè)應(yīng)用組件技術(shù)。EJB結(jié)構(gòu)中的角色 EJB 組件結(jié)構(gòu)是基于組件的分布式計(jì)算結(jié)構(gòu)，是分布式應(yīng)用系統(tǒng)中的組件。 一個(gè)完整的基于EJB的分布式計(jì)算結(jié)構(gòu)由六個(gè)角色組成，這六個(gè)角色可以由不同的開(kāi)發(fā)商提供，每個(gè)角色所作的工作必須遵循Sun公司提供的EJB規(guī)范，以保證彼此之間的兼容性。這六個(gè)角色分別是EJB組件開(kāi)發(fā)者(Enterprise Bean Provider) 、應(yīng)用組合者(Application Assembler)、部署者(Deployer)、EJB 服務(wù)器提供者(EJB Server Provider)、EJB 容器提供者(EJB Container Provider)、系統(tǒng)管理員(System Administrator)： 二、EJB中各角色的分析 1、EJB組件開(kāi)發(fā)者(Enterprise Bean Provider) EJB組件開(kāi)發(fā)者負(fù)責(zé)開(kāi)發(fā)執(zhí)行商業(yè)邏輯規(guī)則的EJB組件，開(kāi)發(fā)出的EJB組件打包成ejb-jar文件。EJB組件開(kāi)發(fā)者負(fù)責(zé)定義EJB的remote和home接口，編寫(xiě)執(zhí)行商業(yè)邏輯的EJB class,提供部署EJB的部署文件(deployment descriptor)。部署文件包含EJB的名字，EJB用到的資源配置，如JDBC等。EJB組件開(kāi)發(fā)者是典型的商業(yè)應(yīng)用開(kāi)發(fā)領(lǐng)域?qū)＜摇?br /> EJB組件開(kāi)發(fā)者不需要精通系統(tǒng)級(jí)的編程，因此，不需要知道一些系統(tǒng)級(jí)的處理細(xì)節(jié)，如事務(wù)、同步、安全、分布式計(jì)算等。 2、應(yīng)用組合者(Application Assembler) 應(yīng)用組合者負(fù)責(zé)利用各種EJB組合一個(gè)完整的應(yīng)用系統(tǒng)。應(yīng)用組合者有時(shí)需要提供一些相關(guān)的程序，如在一個(gè)電子商務(wù)系統(tǒng)里，應(yīng)用組合者需要提供JSP(Java Server Page)程序。 應(yīng)用組合者必須掌握所用的EJB的home和remote接口，但不需要知道這些接口的實(shí)現(xiàn)。 3、部署者(Deployer) 部署者負(fù)責(zé)將ejb-jar文件部署到用戶的系統(tǒng)環(huán)境中。系統(tǒng)環(huán)境包含某種EJB Server和EJB Container。部署者必須保證所有由EJB組件開(kāi)發(fā)者在部署文件中聲明的資源可用，例如，部署者必須配置好EJB所需的數(shù)據(jù)庫(kù)資源。 部署過(guò)程分兩步：部署者首先利用EJB Container提供的工具生成一些類和接口，使EJB Container能夠利用這些類和接口在運(yùn)行狀態(tài)管理EJB。 部署者安裝EJB組件和其他在上一步生成的類到EJB Container中。 部署者是某個(gè)EJB運(yùn)行環(huán)境的專家。 某些情況下，部署者在部署時(shí)還需要了解EJB包含的業(yè)務(wù)方法，以便在部署完成后，寫(xiě)一些簡(jiǎn)單的程序測(cè)試。 4、EJB 服務(wù)器提供者(EJB Server Provider) EJB 服務(wù)器提供者是系統(tǒng)領(lǐng)域的專家，精通分布式交易管理，分布式對(duì)象管理及其它系統(tǒng)級(jí)的服務(wù)。EJB 服務(wù)器提供者一般由操作系統(tǒng)開(kāi)發(fā)商、中間件開(kāi)發(fā)商或數(shù)據(jù)庫(kù)開(kāi)發(fā)商提供。 在目前的EJB規(guī)范中，假定EJB 服務(wù)器提供者和EJB 容器提供者來(lái)自同一個(gè)開(kāi)發(fā)商，所以，沒(méi)有定義EJB 服務(wù)器提供者和EJB容器提供者之間的接口標(biāo)準(zhǔn)。 5、EJB 容器提供者(EJB Container Provider) EJB 容器提供者提供以下功能： 提供EJB部署工具為部署好的EJB組件提供運(yùn)行環(huán)境 。EJB容器負(fù)責(zé)為EJB提供交易管理，安全管理等服務(wù)。 EJB 容器提供者必須是系統(tǒng)級(jí)的編程專家，還要具備一些應(yīng)用領(lǐng)域的經(jīng)驗(yàn)。EJB 容器提供者的工作主要集中在開(kāi)發(fā)一個(gè)可伸縮的，具有交易管理功能的集成在EJB 服務(wù)器中的容器。EJB 容器提供者為EJB組件開(kāi)發(fā)者提供了一組標(biāo)準(zhǔn)的、易用的API訪問(wèn)EJB 容器，使EJB組件開(kāi)發(fā)者不需要了解EJB服務(wù)器中的各種技術(shù)細(xì)節(jié)。 EJB容器提供者負(fù)責(zé)提供系統(tǒng)監(jiān)測(cè)工具用來(lái)實(shí)時(shí)監(jiān)測(cè)EJB容器和運(yùn)行在容器中的EJB組件狀態(tài)。 6、系統(tǒng)管理員(System Administrator) 系統(tǒng)管理員負(fù)責(zé)為EJB服務(wù)器和容器提供一個(gè)企業(yè)級(jí)的計(jì)算和網(wǎng)絡(luò)環(huán)境。 系統(tǒng)管理員負(fù)責(zé)利用EJB 服務(wù)器和容器提供的監(jiān)測(cè)管理工具監(jiān)測(cè)EJB組件的運(yùn)行情況。 三、EJB的體系結(jié)構(gòu)： EJB分布式應(yīng)用程序是基于對(duì)象組件模型的，低層的事務(wù)服務(wù)用了API技術(shù)。EJB技術(shù)簡(jiǎn)化了用JAVA語(yǔ)言編寫(xiě)的企業(yè)應(yīng)用系統(tǒng)的開(kāi)發(fā)，配置。EJB技術(shù)定義了一組可重用的組件：Enterprise Beans。你可以利用這些組件，象搭積木一樣的建立你的分布式應(yīng)用程序。當(dāng)你把代碼寫(xiě)好之后，這些組件就被組合到特定的文件中去。每個(gè)文件有一個(gè)或多個(gè)Enterprise Beans，在加上一些配置參數(shù)。最后，這些Enterprise Beans被配置到一個(gè)裝了EJB容器的平臺(tái)上。客戶能夠通過(guò)這些Beans的home接口，定位到某個(gè)beans，并產(chǎn)生這個(gè)beans的一個(gè)實(shí)例。這樣，客戶就能夠調(diào)用Beans的應(yīng)用方法和遠(yuǎn)程接口。 EJB服務(wù)器作為容器和低層平臺(tái)的橋梁管理著EJB容器和函數(shù)。它向EJB容器提供了訪問(wèn)系統(tǒng)服務(wù)的能力。例如：數(shù)據(jù)庫(kù)的管理和事務(wù)的管理，或者對(duì)于其它的Enterprise的應(yīng)用服務(wù)器。所有的EJB 實(shí)例都運(yùn)行在EJB容器中。容器提供了系統(tǒng)級(jí)的服務(wù)，控制了EJB的生命周期。EJB中的有一些易于使用的管理工具如：Security--配置描述器（The Deployment descriptor）定義了客戶能夠訪問(wèn)的不同的應(yīng)用函數(shù)。容器通過(guò)只允許授權(quán)的客戶訪問(wèn)這些函數(shù)來(lái)達(dá)到這個(gè)效果。Remote Connectivity--容器為遠(yuǎn)程鏈接管理著低層的通信issues，而且對(duì)Enterprise Beas的開(kāi)發(fā)者和客戶都隱藏了通信細(xì)節(jié)。EJB的開(kāi)發(fā)者在編寫(xiě)應(yīng)用方法的時(shí)候，就象是在條用本地的平臺(tái)一樣的。客戶也不清楚他們調(diào)用的方法可能是在遠(yuǎn)程被處理的。Life Cycle managment--客戶簡(jiǎn)單的創(chuàng)建一個(gè)Enterprise beans的實(shí)例，并通常取消一個(gè)實(shí)例。而容器管理著Enterprise Beans的實(shí)例，使Enterprise Beans實(shí)現(xiàn)最大的效能和內(nèi)存利用率。容器能夠這樣來(lái)激活和使Enterprise Beans失效，保持眾多客戶共享的實(shí)例池。等等。　　Trasction management-配置描述器定義了Enterprise beans 的事務(wù)處理的需求。容器管理著那些管理分布式事務(wù)處理的復(fù)雜的issues。這些事務(wù)可能要在不同的平臺(tái)之間更新數(shù)據(jù)庫(kù)。容器使這些事務(wù)之間互相獨(dú)立，互不干擾。保證所有的更新數(shù)據(jù)庫(kù)都是成功發(fā)生的，否者，就回滾到事務(wù)處理之前的狀態(tài)。 EJB 組件是基于分布式事務(wù)處理的企業(yè)級(jí)應(yīng)用程序的組件。所有的EJB都有如下的特點(diǎn)：EJB包含了處理企業(yè)數(shù)據(jù)的應(yīng)用邏輯。定義了EJB的客戶界面。這樣的界面不受容器和服務(wù)器的影響。于是，當(dāng)一個(gè)EJB被集合到一個(gè)應(yīng)用程序中去時(shí)，不用更改代碼和重新編譯。EJB能夠被定制 各種系統(tǒng)級(jí)的服務(wù)，例如安全和事務(wù)處理的特性，都不是屬于EJB類的。而是由配置和組裝應(yīng)用程序的工具來(lái)實(shí)現(xiàn)。 有兩種類型的EJB: Session beans 和 entity beans.Session beans是一種作為單用戶執(zhí)行的對(duì)象。作為對(duì)遠(yuǎn)程的任務(wù)請(qǐng)求的相應(yīng)，容器產(chǎn)生一個(gè)Session beans 的實(shí)例。一個(gè)Session beans有一個(gè)用戶.從某種程度上來(lái)說(shuō)，一個(gè)Session bean 對(duì)于服務(wù)器來(lái)說(shuō)就代表了它的那個(gè)用戶.Session beans 也能用于事務(wù)，它能夠更新共享的數(shù)據(jù)，但它不直接描繪這些共享的數(shù)據(jù)。Session beans 的生命周期是相對(duì)較短的。典型的是，只有當(dāng)用戶保持會(huì)話的時(shí)候，Session beans 才是活著的。一旦用戶退出了，Session beans 就不再與用戶相聯(lián)系了。Session beans被看成是瞬時(shí)的，因?yàn)槿绻萜鞅罎⒘耍敲从脩舯仨氈匦陆⒁粋€(gè)新的Session對(duì)象來(lái)繼續(xù)會(huì)話。 Session bean典型的聲明了與用戶的互操作或者會(huì)話。也就是說(shuō)，Session bean了在客戶會(huì)話期間，通過(guò)方法的調(diào)用，掌握用戶的信息。一個(gè)具有狀態(tài)的Session bean稱為有狀態(tài)的Session bean.當(dāng)用戶終止與Session beans互操作的時(shí)候.會(huì)話終止了，而且，bean 也不再擁有狀態(tài)值。Session bean也可能是一個(gè)無(wú)狀態(tài)的 session bean.無(wú)狀態(tài)的Session beans并不掌握它的客戶的信息或者狀態(tài)。用戶能夠調(diào)用beans的方法來(lái)完成一些操作。但是，beans只是在方法調(diào)用的時(shí)候才知道用戶的參數(shù)變量。當(dāng)方法調(diào)用完成以后，beans并不繼續(xù)保持這些參數(shù)變量。這樣，所有的無(wú)狀態(tài)的session beans的實(shí)例都是相同的，除非它正在方法調(diào)用期間。這樣，無(wú)狀態(tài)的Session beans就能夠支持多個(gè)用戶.容器能夠聲明一個(gè)無(wú)狀態(tài)的Session beans.能夠?qū)⑷魏蜸ession beans指定給任何用戶. Entity Beans對(duì)數(shù)據(jù)庫(kù)中的數(shù)據(jù)提供了一種對(duì)象的視圖。例如：一個(gè)Entity bean能夠模擬數(shù)據(jù)庫(kù)表中一行相關(guān)的數(shù)據(jù)。多個(gè)client能夠共享訪問(wèn)同一個(gè)Entity bean.多個(gè)client也能夠同時(shí)的訪問(wèn)同一個(gè)Entity bean.Entity beans通過(guò)事務(wù)的上下文來(lái)訪問(wèn)或更新下層的數(shù)據(jù)。這樣，數(shù)據(jù)的完整性就能夠被保證。Entity Beans能存活相對(duì)教長(zhǎng)的時(shí)間，并且狀態(tài)是持續(xù)的。只要數(shù)據(jù)庫(kù)中的數(shù)據(jù)存在，Entity beans就一直存活。而不是按照應(yīng)用程序或者服務(wù)進(jìn)程來(lái)說(shuō)的。即使EJB容器崩潰了，Entity beans也是存活的。Entity Beans生命周期能夠被容器或者 Beans自己管理。如果由容器控制著保證 Entity beans持續(xù)的issus。如果由Beans自己管理，就必須寫(xiě)Entity beans的代碼，包括訪問(wèn)數(shù)據(jù)庫(kù)的調(diào)用。 Entity Beans是由主鍵（primary key 一種唯一的對(duì)象標(biāo)識(shí)符）標(biāo)識(shí)的。通常，主鍵與標(biāo)識(shí)數(shù)據(jù)庫(kù)中的一塊數(shù)據(jù)，例如一個(gè)表中的一行，的主鍵是相同的。主鍵是client能夠定位特定的數(shù)據(jù)塊。 四、開(kāi)發(fā)EJB 1、類介紹： 開(kāi)發(fā)EJB的主要步驟一般來(lái)說(shuō)，整個(gè)的開(kāi)發(fā)步驟（開(kāi)發(fā)，配置，組裝）包括如下幾個(gè)方面。開(kāi)發(fā)：首先要定義三個(gè)類：Bean類本身，Bean的本地和遠(yuǎn)程接口類。 配置：配置包括產(chǎn)生配置描述器--這是一個(gè)XML文件、聲明了Enterprise Bean的屬性、綁定了bean的class文件（包括stub文件和skeleton文件）。最后將這些配置都放到一個(gè)jar文件中。還需要在配置器中定義環(huán)境屬性。組裝應(yīng)用程序：包括將Enterprise beans安裝到Server服務(wù)器中，測(cè)試各層的連接情況。程序組裝器將若干個(gè)Enterprise Beans與其它的組件結(jié)合起來(lái)。組合成一個(gè)完整的應(yīng)用程序。或者將若干個(gè)Enterprise beans組合成一個(gè)復(fù)雜的Enterprise Bean。管理Enterprise Bean。 我們必須定義和編寫(xiě)一些EJB中的基本類。如Enterprise bean類：這是Enterprise bean內(nèi)部應(yīng)用邏輯的實(shí)現(xiàn)。編寫(xiě)Enterprise bean的遠(yuǎn)程接口類。編寫(xiě)Enterprise bean的本地接口類。說(shuō)明主鍵類，主鍵類只是對(duì)于Entity bean才需要的。在Enterprise bean的配置描述器中指定主鍵的名字。Enterprise beans提供者定義了遠(yuǎn)程接口和本地接口，實(shí)現(xiàn)了EJB類本身。Remote接口中提供了客戶調(diào)用EJB實(shí)現(xiàn)的應(yīng)用邏輯函數(shù)的接口。而home接口提供了產(chǎn)生和定位remote接口實(shí)例的方法。 在Enterprise bean本身類的實(shí)現(xiàn)，本地home接口，遠(yuǎn)程remote接口之間并沒(méi)有正式的聯(lián)系（例如繼承關(guān)系）。但是，在三個(gè)類里聲明的方法卻必須遵守EJB里面定義的規(guī)范。例如： 你在Enterprise bean里面聲明了一個(gè)應(yīng)用程序的方法或者說(shuō)應(yīng)用邏輯。也在beans的remote接口中聲明了這個(gè)方法，那么，這兩個(gè)地方必須要同樣的名字。Bean的實(shí)現(xiàn)里面必須至少有一個(gè)Create()方法：ejbCreate()。但是可以有多個(gè)帶有不同參數(shù)的create()方法。　　在home接口中，也必須有相同的方法定義（參數(shù)的個(gè)數(shù)相同）。EjbCreate()方法返回的一個(gè)容器管理的持久對(duì)象。它們都返回一個(gè)容器管理持久性的主鍵值。但是，在home的相應(yīng)的Create()方法中返回值的類型是remote接口。 注意：實(shí)體bean的實(shí)現(xiàn)的ejbCreate方法有點(diǎn)不同。實(shí)體bean可以不定義ejbCreate方法。如果實(shí)體只是通過(guò)應(yīng)用程序或通過(guò)數(shù)據(jù)庫(kù)管理程序的途徑被加到數(shù)據(jù)庫(kù)中，實(shí)體bean就省略了ejbCreate方法。EjbCreate返回的值是主鍵類型。如果ejbCreate方法是容器管理持久性的實(shí)體bean的方法，它的返回值就是NULL類型。如果實(shí)體bean實(shí)現(xiàn)了Bean管理的持久性，ejbCreate方法就返回值類型就是主鍵類型。容器的任務(wù)是把各接口和Enterprise bean的實(shí)現(xiàn)類結(jié)合起來(lái)。保證在編譯時(shí)和運(yùn)行時(shí)，各接口和實(shí)現(xiàn)類是相對(duì)應(yīng)的。 EJB的實(shí)現(xiàn)類，各接口要從不同的基類中繼承下來(lái)。一個(gè)會(huì)話bean必須實(shí)現(xiàn)基類javax.ejb.SessionBean。而實(shí)體bean必須實(shí)現(xiàn)基類javax.ejb.EntiyBean。這些EJB的基類都是從javax.ejb.EnterpriseBean繼承而來(lái)。而javax.ejb.EnterpriseBean又是從java.io.Serializable繼承而來(lái)。每一個(gè)Enterprise Bean都必須有一個(gè)remote接口。Remote接口定義了應(yīng)用程序規(guī)定客戶可以調(diào)用的邏輯操作。這些是一些可以由客戶調(diào)用的公共的方法，通常由Enterprise beans類來(lái)實(shí)現(xiàn)。注意，Enterprise bean的客戶并不直接訪問(wèn)Bean。而是通過(guò)remote接口來(lái)訪問(wèn)。Enterprise bean類的remote接口擴(kuò)展了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()方法允許你取得一個(gè)相關(guān)的Home接口。對(duì)于 實(shí)體Bean，用getPrimaryKey（）方法獲得實(shí)體Bean的主鍵值。Remove（）可以刪除一個(gè)Enterprise bean。具體的語(yǔ)義在各種不同類型的enterprise beans的生命周期中，由上下文中解釋的。方法getHandle（）返回了一個(gè)Enterprise bean實(shí)例的持久的句柄。IsIndentical()方法允許你去比較Enterprise beans是否相同。 2、方法： 所有的remote接口中的方法必須聲明為公共（public）的，并必須拋出java.rmi.RemotException異常。另外，所有的remote接口中的方法定義的參數(shù)和都必須是在RMI-IIOP中有效的。對(duì)每一個(gè)在remote接口中定義的方法，在Enterprise bean 類里面都要有相應(yīng)的方法。相應(yīng)的方法必須要有同樣的名字，同樣類型和數(shù)量的參數(shù)，同樣的返回值，而且還要拋出同樣的例外。 如下代碼顯示了一個(gè)ATM例子的會(huì)話bean的remote接口Atm，。里面聲明了一個(gè)應(yīng)用方法transfer（）。黑體部分表示EJB規(guī)范中必須要有的內(nèi)容。Remote接口必須擴(kuò)展javax.ejb.EJBObject類。從客戶端調(diào)用的Enterprise bean的每一個(gè)方法都必須在remote接口中聲明。Transfer（）方法拋出了兩個(gè)意外。其中InSufficientFundsException例外是應(yīng)用程序定義的意外。 Public interface Atm extends javax.ejb.EJBObject{ Public void transfer(String Source, String Target, float amount) Throws java.rmi.RemoteException, InSufficientFundsException; } Home接口必須定義一個(gè)或多個(gè)的Create()方法。每一個(gè)這樣的Create()方法都必須命名為Create。并且，它的參數(shù)，不管是類型還是數(shù)量都必須與bean類里面的ejbCreate()方法對(duì)應(yīng)。注意，home接口中的Create()方法和bean類中ejbCreate()方法的返回值類型是不同的。實(shí)體bean的home接口還包含find（）方法。 每一個(gè)Home接口都擴(kuò)展了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; } 這里提供了兩個(gè)remove（）方法來(lái)刪除Enterprise bean的實(shí)例。第一個(gè)remove方法是通過(guò)句柄來(lái)刪除一個(gè)Enterprise bean的實(shí)例。第二個(gè)remove方法通過(guò)主鍵來(lái)刪除一個(gè)Enterprise bean的實(shí)例。 在眾多的Enterprise bean實(shí)例中，句柄唯一的標(biāo)識(shí)一個(gè)實(shí)例。一個(gè)句柄與它引用的Enterprise bean有相同的生命期。考慮一個(gè)實(shí)體對(duì)象，客戶可以通過(guò)一個(gè)句柄來(lái)重新獲得相應(yīng)的Enterprise bean的實(shí)例。一個(gè)句柄能夠?qū)?yīng)一個(gè)Enterprise bean對(duì)象的多個(gè)實(shí)例。例如，即使當(dāng)Enterprise bean對(duì)象所在的主機(jī)崩潰了，或者Enterprise bean對(duì)象在不同的機(jī)器之間移動(dòng)，句柄仍是有效的。這里的句柄是Serialized句柄，與CORBA中的字符串化的CORBA對(duì)象的引用是相似的概念。在EJBHome接口中的第二個(gè)remove操作通過(guò)其主鍵來(lái)決定要?jiǎng)h除的Enterprise bean。主鍵可以是擴(kuò)展了Java Object類的任何類型，但是，必須要實(shí)現(xiàn)Java的Serializable接口。主鍵是標(biāo)識(shí)實(shí)體bean的主要的方法。通常，主鍵是數(shù)據(jù)庫(kù)中的一個(gè)關(guān)鍵字，唯一的定義了由實(shí)體bean代表的數(shù)據(jù)。 方法getEJBMetaData（）返回了Enterprise bean對(duì)象的metadata接口。這個(gè)接口允許客戶獲得Enterprise bean的metadata信息。當(dāng)開(kāi)發(fā)工具來(lái)編譯鏈接應(yīng)用程序的時(shí)候，或者配置工具來(lái)配置的時(shí)候，可能會(huì)用到metadata信息。Javax.ejb.EJBMetadata接口提供了獲得javax.ejb.EJBHome接口，home類，remote接口，還有獲得主鍵的方法。也提供了一個(gè)isSesson()的方法來(lái)確定在放這個(gè)home接口的對(duì)象是會(huì)話bean還是實(shí)體bean。IsStatelessSession()方法指示這個(gè)會(huì)話bean是有狀態(tài)還是無(wú)狀態(tài)的。如下代碼顯示了javax.ejb.EJBMetadata接口的定義部分的代碼。 Public javax.ejb; Public interface EJBMetaData{ EJBHome getEJBHome(); Class getHomeInterfaceClass(); Class getRemoteInterfaceClasss(); Class getPrimaryKeyClass(); Boolean isSession(); Boolean isStatelesssSession(); } 對(duì)每一個(gè)Create（）方法，EJB規(guī)范定義了如下的命名約定。它的返回值是會(huì)話bean的remote接口的類型。方法的名字只能是Create()。對(duì)會(huì)話bean類中的每一個(gè)ejbCreate()方法都必須有一個(gè)Create()與之對(duì)應(yīng)。 對(duì)于每一個(gè)Create()方法的參數(shù)的類型和數(shù)量都必須與會(huì)話bean類中的ejbCreate()方法相對(duì)應(yīng)。方法必須拋出java.rmi.RemoteException例外。 方法必須拋出javax.rmi.CreateExeption例外。 Create（）方法的參數(shù)是用來(lái)初始化新的會(huì)話bean對(duì)象的。 如下代碼顯示了一個(gè)會(huì)話bean對(duì)象的不同的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; } 這里提供了兩個(gè)remove（）方法來(lái)刪除Enterprise bean的實(shí)例。第一個(gè)remove方法是通過(guò)句柄來(lái)刪除一個(gè)Enterprise bean的實(shí)例。第二個(gè)remove方法通過(guò)主鍵來(lái)刪除一個(gè)Enterprise bean的實(shí)例。在眾多的Enterprise bean實(shí)例中，句柄唯一的標(biāo)識(shí)一個(gè)實(shí)例。一個(gè)句柄與它引用的Enterprise bean有相同的生命期。考慮一個(gè)實(shí)體對(duì)象，客戶可以通過(guò)一個(gè)句柄來(lái)重新獲得相應(yīng)的Enterprise bean的實(shí)例。一個(gè)句柄能夠?qū)?yīng)一個(gè)Enterprise bean對(duì)象的多個(gè)實(shí)例。例如，即使當(dāng)Enterprise bean對(duì)象所在的主機(jī)崩潰了，或者Enterprise bean對(duì)象在不同的機(jī)器之間移動(dòng)，句柄仍是有效的。這里的句柄是Serialized句柄，與CORBA中的字符串化的CORBA對(duì)象的引用是相似的概念。 在EJBHome接口中的第二個(gè)remove操作通過(guò)其主鍵來(lái)決定要?jiǎng)h除的Enterprise bean。主鍵可以是擴(kuò)展了Java Object類的任何類型，但是，必須要實(shí)現(xiàn)Java的Serializable接口。主鍵是標(biāo)識(shí)實(shí)體bean的主要的方法。通常，主鍵是數(shù)據(jù)庫(kù)中的一個(gè)關(guān)鍵字，唯一的定義了由實(shí)體bean代表的數(shù)據(jù)。方法getEJBMetaData（）返回了Enterprise bean對(duì)象的metadata接口。這個(gè)接口允許客戶獲得Enterprise bean的metadata信息。當(dāng)開(kāi)發(fā)工具來(lái)編譯鏈接應(yīng)用程序的時(shí)候，或者配置工具來(lái)配置的時(shí)候，可能會(huì)用到metadata信息。Javax.ejb.EJBMetadata接口提供了獲得javax.ejb.EJBHome接口，home類，remote接口，還有獲得主鍵的方法。也提供了一個(gè)isSesson()的方法來(lái)確定在放這個(gè)home接口的對(duì)象是會(huì)話bean還是實(shí)體bean。IsStatelessSession()方法指示這個(gè)會(huì)話bean是有狀態(tài)還是無(wú)狀態(tài)的。如下代碼顯示了javax.ejb.EJBMetadata接口的定義部分的代碼。 Public javax.ejb; Public interface EJBMetaData{ EJBHome getEJBHome(); Class getHomeInterfaceClass(); Class getRemoteInterfaceClasss(); Class getPrimaryKeyClass(); Boolean isSession(); Boolean isStatelesssSession(); } 五、EJB的編程環(huán)境： 1、 使用Jbuilder Jbuilder與EJB Container能夠進(jìn)行無(wú)縫連接。Jbuilder和Inprise的應(yīng)用服務(wù)器包括了所有的開(kāi)發(fā)和配置Enterprise Beans的工具以及所需要的庫(kù)：運(yùn)行和管理Enterprise Bean的容器、命名服務(wù)、 事務(wù)服務(wù)、Java數(shù)據(jù)庫(kù)、開(kāi)發(fā)Enterprise Beans所需要的API、一個(gè)增強(qiáng)的java-to-iiop編譯器，支持值類型和RMI信號(hào)等等。 Jbuilder還提供了一個(gè)快速開(kāi)發(fā)應(yīng)用程序Enterprise Beans的工具和向?qū)АＭㄟ^(guò)簡(jiǎn)單而且直觀的步驟，向?qū)椭憬⒁粋€(gè)Enterprise Bean。自己設(shè)定某些缺省值，產(chǎn)生了bean的模板，在上面，我們可以增加我們自己的應(yīng)用邏輯。Jbuilder也提供了一個(gè)EJB的接口生成向?qū)АＯ驅(qū)г贓nterprise Bean的公共方法基礎(chǔ)上生成了Remote接口和Home接口。Jbuilder還提供一個(gè)配置器的向?qū)椭覀冎鸩降慕ML描述器文件。并將生成的Stubs集中到一個(gè)jar文件中。 2、使用Jbuilder之外的集成環(huán)境： 如果你使用其它的除了別的集成環(huán)境（IDE）。要確定使用了集成環(huán)境IDE所帶的容器工具。也要驗(yàn)證IDE是否支持EJB規(guī)范的相應(yīng)的版本，還要確定它是否正確的支持EJB的API。 要確定JD到所支持的EJB容器的版本。可以通過(guò)檢查Inprise的安裝說(shuō)明來(lái)確定EJB容器所支持的支持JDK的版本。 在配置Enterprise Bean的時(shí)候，你必須使用Inprise的應(yīng)用服務(wù)器所提供的工具。這些工具能夠編輯和修改第三方的代理商提供的Inprise配置描述器。還能夠驗(yàn)證配置描述器，能夠驗(yàn)證bean的源代碼。 六、一個(gè)簡(jiǎn)單的HELLO例子 1、安裝Apusic Application Server Note:以下以Linux為例，來(lái)說(shuō)明Apusic Application Server的安裝過(guò)程。其他平臺(tái)的安裝，可參考Apusic Application Server安裝手冊(cè)。 下載JDK1.2，Apusic Application Server必須運(yùn)行在JDK1.2以上環(huán)境中。可從以下站點(diǎn)下載最新JDK。 http://java.sun.com 下載Apusic Application Server Apusic Application Server 試用版可從以下網(wǎng)址得到： http://www.apusic.com/download/enter.jsp 在下載完成后，你可以得到一個(gè)包裹文件apusic.zip，選定安裝目錄，假設(shè)安裝到/usr下，則用以下命令： 　　　cd /usr jar xvf apusic.zip /usr下會(huì)出現(xiàn)一個(gè)目錄apusic，Apusic Application Server的所有程序都被解壓到/usr/apusic下。 將以下路徑加入到CLASSPATH中 /usr/apusic/lib/apusic.jar $JAVA_HOME/lib/tools.jar 用以下命令運(yùn)行Apusic Application Server java -Xms64m com.apusic.server.Main -root /usr/apusic 2、定義EJB遠(yuǎn)程接口(Remote Interface) 任何一個(gè)EJB都是通過(guò)Remote Interface被調(diào)用，EJB開(kāi)發(fā)者首先要在Remote Interface中定義這個(gè)EJB可以被外界調(diào)用的所有方法。執(zhí)行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 { file://this method just get "Hello World" from HelloBean. public String getHello() throws RemoteException; } 3、定義Home Interface EJB容器通過(guò)EJB的Home Interface來(lái)創(chuàng)建EJB實(shí)例，和Remote Interface一樣，執(zhí)行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、寫(xiě)EJB類 在EJB類中，編程者必須給出在Remote Interface中定義的遠(yuǎn)程方法的具體實(shí)現(xiàn)。EJB類中還包括一些 EJB規(guī)范中定義的必須實(shí)現(xiàn)的方法，這些方法都有比較統(tǒng)一的實(shí)現(xiàn)模版，編程者只需花費(fèi)精力在具體業(yè)務(wù)方法的實(shí)現(xiàn)上。 以下是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、創(chuàng)建ejb-jar.xml文件 ejb-jar.xml文件是EJB的部署描述文件，包含EJB的各種配置信息，如是有狀態(tài)Bean(Stateful Bean) 還是無(wú)狀態(tài)Bean(Stateless Bean)，交易類型等。ejb-jar.xml文件的詳細(xì)信息請(qǐng)參閱EJB規(guī)范。以下是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中運(yùn)行的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＞ 啟動(dòng)服務(wù)器 java -Xms64m com.apusic.server.Main -root /usr/apusic 7、寫(xiě)客戶端調(diào)用程序 您可以從Java Client，JSP，Servlet或別的EJB調(diào)用HelloBean。 調(diào)用EJB有以下幾個(gè)步驟： 通過(guò)JNDI(Java Naming Directory Interface)得到EJB Home Interface 通過(guò)EJB Home Interface 創(chuàng)建EJB對(duì)象，并得到其Remote Interface 通過(guò)Remote Interface調(diào)用EJB方法 以下是一個(gè)從Java Client中調(diào)用HelloBean的例子： 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); } } } 運(yùn)行HelloClient，可得到以下輸出： Hello World http://yingmingpan.bokee.com/tb.b?diaryId=14817948

posted @ 2007-09-30 10:20 夏雪 閱讀(382) | 評(píng)論 (0) | 編輯 收藏