深入淺出JBoss Seam

作者 Michael Yuan譯者 包亮 發(fā)布于 2007年11月2日 上午1時3分

社區(qū)

Java

主題

Web框架

本文節(jié)選了Michael Yuan和Thomas Heute所著的即將出版JBoss Seam: Power and Flexibility Beyond Java EE 5.0第一章和第二章，內(nèi)容有所刪減。

什么是Seam？

JBoss Seam是“Java EE 5.0的一個輕量級的框架”。這是什么意思？難道Java EE(Enterprise Edition) 5.0本身不是一套“框架嗎”？為什么在官方規(guī)范之外，還需要另外一個框架？好吧，我們就將seam看作是本應(yīng)該被包括在Java EE 5.0中的一個“遺漏的框架”吧。它在Java EE 5.0框架的上層，為所有的在企業(yè)Web應(yīng)用中的組件提供了一個統(tǒng)一的、易于理解的編程模型。它同樣使基于狀態(tài)的應(yīng)用和業(yè)務(wù)流程驅(qū)動的應(yīng)用的開發(fā)易如反掌。換句話說，Seam致力于開發(fā)者生產(chǎn)力和應(yīng)用擴展性。

1. 整合和強化Java EE框架

Java EE5.0的核心框架是EJB(Enterprise JavaBeans)3.0和JSF(JavaServer Faces)1.2。EJB 3.0(以下簡稱EJB3)是基于一個POJO(Plain Old Java Objects)的業(yè)務(wù)服務(wù)和數(shù)據(jù)庫持久化的輕型框架。JSF是一個基于MVC(Model-View-Controller)的Web應(yīng)用框架。大多數(shù)的Web應(yīng)用都將包含有業(yè)務(wù)邏輯的EJB3組件和Web應(yīng)用前端顯示的JSF組件。EJB3和JSF雖然互補，但是他們是根據(jù)各自的理念設(shè)計的獨立的框架。例如，EJB3使用注解（annotation）來配置服務(wù)，而JSF使用的是XML文件。更進一步講，EJB3和JSF組件在框架層面上是互不敏感的。要整合EJB3和JSF，開發(fā)者必須手動地構(gòu)造facade對象（如：JSF支持bean），將業(yè)務(wù)組件與Web頁面和樣板代碼（又稱plumbing代碼）聯(lián)結(jié)起來，以便能跨框架調(diào)用方法。將這些技術(shù)粘合起來是Seam的職責(zé)之一。

Seam打破了EJB3和JSF之間的人工層，它為整合EJB3和JSF提供了一個一致的，基于注解的途徑。只需要個別簡單的注解，Seam中的EJB3業(yè)務(wù)組件就能直接被用來支持JSF Web表單或者處理Web UI事件。Seam允許開發(fā)者將“同一種東西”——有注解的POJOs——應(yīng)用與所有的應(yīng)用組件。與其他Web框架開發(fā)的應(yīng)用相比，Seam應(yīng)用概念簡潔，同樣的功能卻需要較少的代碼（在JAVA和XML中）。如果沒有耐心，或者想要快速預(yù)覽，一個Seam到底有多簡單，你可以現(xiàn)看看本文描述的hello world一例。

在JSP來說困難的任務(wù)，Seam可以輕易的完成。例如，JSF頭疼的一個問題就是過分依賴HTTP POST。這使得將一個添加到書簽中的JSF網(wǎng)頁，通過HTTP GET訪問相當(dāng)困難。但是有了Seam，生成一個REST網(wǎng)頁是非常容易的。Seam提供了一系列JSF組件標(biāo)簽和注解，增加了“web友好”和JSF應(yīng)用的網(wǎng)頁效率。

同時，Seam拓展了EJB3到POJO的組件模式, 從web層到業(yè)務(wù)層都有了狀態(tài)上下文。進一步說，Seam整合了一系列主要的其他開放源代碼框架，例如jBPM、JBoss Rules(又名Drools)、JBoss Portal、JBoss Microcontainer等等。Seam不僅能將它們“有機結(jié)合”起來，而且可以像整合JSF和EJB3一樣強化原有的框架。

Seam位于Java EE 5.0底層，但它的應(yīng)用并不局限與Java EE 5.0服務(wù)器。一個Seam應(yīng)用可以部署在J2EE 1.4應(yīng)用服務(wù)器和Tomcat服務(wù)器上。這意味著現(xiàn)在能在Seam應(yīng)用中得到產(chǎn)品化支持。

1 + 1 > 2

或許有這樣一種誤解，認(rèn)為Seam僅僅是將各種不同框架串起來的另外一個集成框架。Seam提供了它自身管理的狀態(tài)上下文，允許框架通過注解和EL（表達式語言）表達式與其他框架進行深度整合。整合的程序來自于Seam開發(fā)者對第三方框架的認(rèn)知。

2. 一個為ORM設(shè)計的Web框架

對象關(guān)系映射(ORM)解決方案在當(dāng)今企業(yè)應(yīng)用中廣為使用。但是，大多數(shù)當(dāng)前的業(yè)務(wù)和web框架并不是為ORM設(shè)計的，它們并不在整個Web交互生命周期——從請求來臨到響應(yīng)完成——管理持久上下文。這就導(dǎo)致了包括可怕的LazyInitializationException在內(nèi)的各種ORM異常，帶來了如“數(shù)據(jù)傳輸對象（DTO）”等丑陋的伎倆（ugly hacks）。

Gavin King發(fā)明了Seam，同時他也發(fā)明了在世界上廣為使用的ORM解決方案Hibernate。為了繼承和發(fā)揚ORM的最佳實踐，Seam進行了重新設(shè)計。有了Seam，就不必再寫DTO，你所做的就是延遲加載。因為擴展后的持久上下文就如同一個自然的高速緩存，可以減少和數(shù)據(jù)庫的交互，ORM的性能就會被極大地改進。

進一步講，因為Seam整合了ORM層、業(yè)務(wù)層和表示層，開發(fā)者就能夠在表示層直接展示ORM對象，也能把數(shù)據(jù)庫驗證注解用于輸入表單，以及重新定向ORM例外到定制的錯誤頁面。

3.專為有狀態(tài)Web應(yīng)用而設(shè)計

Seam是專為有狀態(tài)Web應(yīng)用而設(shè)計的。Web應(yīng)用是天生的多用戶應(yīng)用，電子商務(wù)應(yīng)用天生也是有狀態(tài)的和有事務(wù)的。但是，大多數(shù)已有Web應(yīng)用框架是面向無狀態(tài)應(yīng)用的。開發(fā)者必須操作HTTP會話（session）對象來管理用戶狀態(tài)，與核心業(yè)務(wù)邏輯無關(guān)的代碼不僅會混亂你的應(yīng)用，而且?guī)砹艘幌盗械男阅軉栴}。

在Seam中，所有的基礎(chǔ)應(yīng)用組件天生地有狀態(tài)。它們使用起來要比HTTP session容易，因為它們的狀態(tài)由Seam公開管理。沒有必要在Seam應(yīng)用中編寫引起麻煩的狀態(tài)管理代碼——只需在其組件上注解其做用域、生命周期方法以及其他狀態(tài)屬性，Seam就會掌管其他[譯者注：指這些組件的生命周期]。Seam狀態(tài)組件要比HTTP會話（session）能更好的管理用戶狀態(tài)。例如，你能有多個“會話”進行，每個“會話”由在一個HTTP會話（session）中一系列的Web請求和業(yè)務(wù)方法調(diào)用組成。

進一步說，在Seam中，數(shù)據(jù)庫緩存和事務(wù)能自動與應(yīng)用的狀態(tài)相連。Seam在內(nèi)存中自動保存數(shù)據(jù)庫更新，等到對話結(jié)束后提交到數(shù)據(jù)庫。內(nèi)存中的緩存能大大減輕復(fù)雜狀態(tài)應(yīng)用中數(shù)據(jù)庫的負(fù)載。

除了以上這些，Seam支持整合開源JBoss jBPM業(yè)務(wù)程序引擎，大大提升了Web應(yīng)用中的狀態(tài)管理。你現(xiàn)在能為一個機構(gòu)中不同工作人員（諸如客戶、經(jīng)理、技術(shù)支持人員等等）的指定工作流程，利用工作流程來驅(qū)動應(yīng)用，而不是依賴用戶界面事件處理和數(shù)據(jù)庫。

4. 支持Web 2.0

Seam為Web2.0應(yīng)用進行了充分的優(yōu)化。它給AJAX（異步JavaScript和XML，增加網(wǎng)頁交互的一種技術(shù)）提供了多種支持——從內(nèi)置“零Javascript”的AJAX組件到有AJAX支持的JSF組件，再到定制的JavaScript庫，Seam為瀏覽器端的Javascript對象提供了直接訪問Seam服務(wù)器組件的途徑。Seam提供了一個先進的并發(fā)模型，有效的管理來自同一用戶的多個AJAX請求。

對于AJAX應(yīng)用，不斷增長的數(shù)據(jù)庫負(fù)載是一個巨大的挑戰(zhàn)。與一個非AJAX應(yīng)用相比，一個AJAX應(yīng)用要向服務(wù)器發(fā)送的更頻繁的請求。一但數(shù)據(jù)庫必須響應(yīng)這些AJAX請求，那么數(shù)據(jù)庫就不堪重荷。Seam中的狀態(tài)持久上下文正如一個內(nèi)存中的緩存，它能在會話始末保存信息，最終幫助減少數(shù)據(jù)庫交互。

Web2.0應(yīng)用往往為其數(shù)據(jù)使用復(fù)雜關(guān)系模型（例如，一個網(wǎng)絡(luò)交際站點所做的就是處理和顯示“用戶”之間的關(guān)系），對于這些站點，延遲加載對于ORM層至關(guān)重要。否則，一個簡單的查詢就能級聯(lián)地加載整個數(shù)據(jù)庫。正如我們前面所討論過的，Seam是現(xiàn)今唯一一個正確支持Web應(yīng)用延時加載的Web框架。

5.依賴雙向映射的Pojo服務(wù)

Seam是一個“輕量級”框架，因為它使用POJO（plain old Java objects）作為服務(wù)組件。在應(yīng)用中，POJO沒有使用接口或抽象類來"鉤住"組件。當(dāng)然，問題是如何使POJO交互來組成這個應(yīng)用？它們?nèi)绾闻c容器服務(wù)（例如，數(shù)據(jù)庫持久化服務(wù)）交互？

Seam通過使用一個流行的、被稱作依賴注入(DI)的設(shè)計模式聯(lián)結(jié)所有POJO組件。在這個模式下，Seam框架管理著所有組件的生命周期。當(dāng)一個組件需要使用另外一個時，它通過注解（annotation）向Seam聲明此依賴。Seam依據(jù)應(yīng)用當(dāng)前狀態(tài)得到這個依賴組件，并將它注入到所需求的組件中。

通過拓展依賴注入概念，一個Seam組件A不但可以構(gòu)造另外一個組件B，而且把此組件B“拋還”給Seam以備其他組件（例如組件C）以后使用。

這類雙向依賴管理甚至都廣泛的應(yīng)用于簡單的Seam web應(yīng)用中（例如第二章的hello world一例）。在Seam術(shù)語中，我們稱這個為“依賴雙向映射”。

6.非常規(guī)的配置

使Seam易用的主要設(shè)計原則是“非常規(guī)的配置”。其思想是為這些組件提供一系列默認(rèn)行為，開發(fā)者只需要在預(yù)期行為非默認(rèn)的時候，顯示地配置組件。例如, 當(dāng)Seam將組件A作為屬性注入到組件B時，默認(rèn)地，組件A剛會以組件B被注入的屬性的名稱命名。Seam里還有很類似的細(xì)節(jié)。總的結(jié)果是Seam中配置元數(shù)據(jù)要比其他Java框架簡單的多。因此，大多數(shù)的Seam應(yīng)用能通過一系列簡單的Java注解進行充分配置。開發(fā)者從減化的復(fù)雜度中受益匪淺，最后，與其他Java框架相比，用更少的代碼實現(xiàn)同樣的功能。

7.避免濫用XML

或許你已經(jīng)注意到，Java注解在表述和處理Seam配置元數(shù)據(jù)時扮演著重要的角色。通過這樣的設(shè)計使框架更易于操作。

在J2EE發(fā)展早期，XML曾經(jīng)被看作配置管理的“圣杯”?？蚣茉O(shè)計者將所有的配置信息，包括Java類和方法名稱都統(tǒng)統(tǒng)丟進XML文檔，而不考慮對開發(fā)者所帶來的后果。反省后，發(fā)現(xiàn)這是個嚴(yán)重的錯誤。XML配置文檔太過重復(fù)。開發(fā)者必須重復(fù)代碼中已有的信息，從而將配置和代碼聯(lián)結(jié)起來。這些重復(fù)使應(yīng)用易于出錯（例如，一個拼寫錯誤的類名可能在運行時顯示為一個難于調(diào)試錯誤）。缺少合理的默認(rèn)配置進一步使這一問題復(fù)雜化。事實上，在一些框架中，相當(dāng)數(shù)量的樣板代碼偽裝為XML，可能相當(dāng)于或者超過實際應(yīng)用中JAVA代碼的數(shù)量。對于J2EE開發(fā)者，XML的濫用通常被稱為“XML地獄”。

Java社區(qū)認(rèn)識到了XML的濫用問題，并且已經(jīng)非常成功地用Java代碼中的注解取代了XML。EJB3是Java官方標(biāo)準(zhǔn)化機構(gòu)促進Java企業(yè)組件中注解使用的一項成果。EJB3完全可選擇的使用XML文檔，它向正確方向邁出了積極的一步。Seam加入了EJB3的注解，為整個web應(yīng)用拓展了基于注解的編程模型。

當(dāng)然，XML對于配置數(shù)據(jù)并非完全不利。Seam設(shè)計者認(rèn)識到XML適用于指定頁面流程或者定義業(yè)務(wù)流程的web應(yīng)用。XML文檔使開發(fā)者集中地管理整個web應(yīng)用的工作流程成為可能，同時也反對將配置信息分散于java源文件中。工作流程很少能與源代碼耦合，因此XML文檔中并不需要重復(fù)鍵入已存在于代碼中的信息。

8.為測試而設(shè)計

Seam為了易于測試而重新設(shè)計。因為所有的Seam組件都是注解過的POJO，它們易于進行單元測試。開發(fā)者僅僅通過利用常規(guī)的Java new關(guān)鍵詞來構(gòu)造實例，然后在測試框架（例如JUnit 或者TestNG）中運行任何方法。如果需要測試多個Seam組件的交互，開發(fā)者則逐個實例化這些組件，然后手動建立它們的相互關(guān)系（也就是顯示地使用setter 方法，而不是依靠Seam依賴注入功能）。

集成測試整個Seam應(yīng)用比較復(fù)雜，因為開發(fā)者必須在Seam容器中運行應(yīng)用。Seam用嵌入的輕量級容器來幫助該類測試。在測試框架中，開發(fā)者能按步驟地加載Seam容器，然后運行測試。

9. 卓越的工具支持

對于一個聚焦于開發(fā)者生產(chǎn)力的應(yīng)用框架，開發(fā)工具的支持至關(guān)重要。Seam發(fā)布了一個基于命令行的生成器，稱作 SeamGen。SeamGen類似于Ruby-On-Rails中的生成器，它支持諸如從一個數(shù)據(jù)庫生成完整CRUD應(yīng)用的功能，聰明的開發(fā)者會通過諸如“編輯/保存/在瀏覽器重新載入”的步驟、有測試支持的特性，來改進web應(yīng)用。

但更重要的是，SeamGen生成項目不依賴于主流的Java集成開發(fā)環(huán)境，如Eclipse和NetBeans。有了SeamGen，開發(fā)者可以隨時入門。

10. 讓我們開始編碼吧

總而言之，Seam為JavaEE應(yīng)用削減了開發(fā)費用，同時，增加了Java EE 5.0不具有的強大的新功能。在下節(jié)（節(jié)選自本書第二章），我們將給您展示一些實際代碼例子來闡述Seam如何工作的。你能通過網(wǎng)站http://www./seam/下載到本書中所有的例子的源代碼。

Seam Hello World

JBoss Seam是EJB3和JSF中間的粘合劑，這是Jboss Seam最基本的和最廣泛的應(yīng)用。通過被Seam管理的組件，Seam允許這兩個框架之間無縫(不是有意雙關(guān)的)的集成。它為整個web應(yīng)用拓展了基于注解的EJB3 POJO編程模型。在層與層之間，沒有了必需的手動JNDI查找，沒有了冗長的JSF支持bean的聲明，沒有了過多facade方法，沒有了艱辛的對象傳遞，快哉！

繼續(xù)在Seam中使用JavaEE模式

在傳統(tǒng)的java EE應(yīng)用中，一些設(shè)計模式，例如JNDI查找、XML聲明組件、值對象、facade是被強制使用的。Seam用基于注解的POJO消除了這些人為的需求。但是，當(dāng)Seam應(yīng)用中真正需要它們的時候，仍然可以自由地使用這些模式。

編寫一個Seam web應(yīng)用概念上很簡單。你只需要編碼出下列組件：

• 實體對象代表數(shù)據(jù)模型。實體對象可能是JPA或者Hibernate中的POJO對象。它們自動地映射到關(guān)系數(shù)據(jù)庫表。
• SF web頁面展示了用戶界面。頁面通過表單捕獲用戶的輸入，并且顯示結(jié)果。表單域與其數(shù)據(jù)顯示數(shù)據(jù)庫表，這些表被映射到實體bean或者實體bean的集合上。
• EJB3 會話bean或者注解過的Seam POJO可以作為JSF Web頁面的UI事件處理器。它們處理封裝在實體bean中的用戶輸入，為下一步（或者頁面）生成顯示的數(shù)據(jù)對象。

所有以上組件均由Seam自行管理，它們在運行時被自動注入到正確的頁面或者對象。例如，當(dāng)用戶單擊按鈕提交一個JSF表單，Seam就會自動解析表單域并構(gòu)造一個實體bean。然后，Seam將實體bean傳入同樣被Seam構(gòu)造的事件處理器會話bean中來處理。開發(fā)者不需要在代碼中管理組件的生命周期和組件之間的相互關(guān)系。依賴處理過程中，沒有樣板代碼和XML文件。

本章中，我們使用hello world一例來明確展示Seam如何粘合一個web應(yīng)用。該例子工作如下：用戶能在web表單中輸入其名字來“問候”Seam。一旦她提交了表單，應(yīng)用則保存她的名字到一個關(guān)系數(shù)據(jù)庫中，并且顯示所有已經(jīng)“問候”過Seam的用戶。該項目示例在該書下載的源代碼中的HelloWorld文件夾中。為了建立它，你必須安裝Apache ANT 1.6版本以上 (http://ant./)。進入HelloWorld目錄，運行命令ant，則會生成build/jars/helloworld.ear文件，可以直接拷貝該文件到Jboss AS實例的server/default/deploy目錄下?，F(xiàn)在，啟動JBoss AS并且打開網(wǎng)址http://localhost:8080/helloworld/。

為了運行本書中的例子，我們建議您使用JEMS GUI安裝程序安裝一個與Seam兼容的JBoss AS。您可以從http://labs./portal/jemsinstaller/downloads下載JEMS安裝程序。如果您需要更多安裝JBoss AS和應(yīng)用部署幫助，請參見附錄A，“安裝和部署JBoss AS”

歡迎使用示例作為模板，快速開始你自己Seam項目（參見附錄B “使用應(yīng)用示例作為模板”）?；蛘撸隳苁褂妹钚泄ぞ逽eam Gen (參見第四章“快速應(yīng)用開發(fā)工具”)自動生成項目模板，包括所有的配置文件。本章中，我將花少量的時間來闡釋源代碼項目中的目錄結(jié)構(gòu)。相反，我們將集中討論代碼和配置，這也是開發(fā)者建立一個Seam 應(yīng)用必需的。如此，我們就能將知識應(yīng)用到任何一個項目結(jié)構(gòu)，而不需要受模板的限制。

源代碼目錄

一個Seam應(yīng)用由java類和XML或文本配置文件組成。本書的項目例子中，java源代碼文件在src目錄中，網(wǎng)頁在view 目錄中，所有的配置文件都在resources目錄中。更多信息請看附件B,使用應(yīng)用示例作為模板。

1. 創(chuàng)建一個數(shù)據(jù)模型

Helloworld應(yīng)用中的數(shù)據(jù)模型僅僅是一個有name和id屬性的person 類。注解@Entity告訴容器映射該類到一個關(guān)系數(shù)據(jù)庫表，每個屬性對應(yīng)表中一個字段，每個person實例相當(dāng)于表中的一條記錄。因為Seam采用非常規(guī)的配置方式，容器為表名和字段中僅僅使用類名和屬性名。屬性id上的@Id和@GeneratedValue注解暗示id字段是主鍵，它的值是應(yīng)用服務(wù)器為每個保存到數(shù)據(jù)庫的peron對象自動生成。

@Entity
@Name("person")
public class Person implements Serializable {

  private long id;
  private String name;

  @Id @GeneratedValue
  public long getId() { return id;}
  public void setId(long id) { this.id = id; }

  public String getName() { return name; }
  public void setName(String name) {this.name = name;}
}

Person類中最重要的注解是@Name，它為這個將要注冊于Seam中的Person bean指定了名稱。在其他Seam組件中（例如，頁面和會話bean）中，開發(fā)者能指直接使用“person”來引用被管理的Person bean。

2. 將數(shù)據(jù)模型映射到web表單

在JSF頁面中，我們使用Person bean來支持表單輸入文本域。#{person.name}符號指代名為“person”的Seam組件的name屬性，名為“person”的Seam組件是Person實體bean的一個實例。

<h:form>
Please enter your name:<br/>
<h:inputText value="#{person.name}" size="15"/><br/>
<h:commandButton type="submit" value="Say Hello"
                 action="#{manager.sayHello}"/>
</h:form>

通過以下的實體表單，JSF頁面顯示了數(shù)據(jù)庫中所有已經(jīng)向Seam說“hello”的用戶。用戶名單列表存儲在一個名為“fans”的Seam組件中，它是一個List 對象。JSFdataTable通過遍歷列表，每一行顯示一個Person對象。Fan標(biāo)記是fans列表的迭代子。

<h:dataTable value="#{fans}" var="fan">
  <h:column>
    <h:outputText value="#{fan.name}"/>
  </h:column>
</h:dataTable>
    

圖2.1顯示了Hello World網(wǎng)頁

當(dāng)用戶點擊“Say Hello”按鈕提交表單，Seam用輸入數(shù)據(jù)構(gòu)造了該person組件。然后它調(diào)用了名為“manager”的Seam 組件的sayhello()的方法(像這樣，#{manager.sayHello}是表單提交按鈕的UI事件處理器)，這就在數(shù)據(jù)庫中保存了person對象并且刷新了fans列表。名為manager的組件是一個EJB3的會話bean, 我們將在下節(jié)討論該話題。

2. 處理web事件

Seam 中的名為manager的組件是會話bean ManagerAction，正如該類中@Name注解指定的。ManagerAction類有person和fans兩個屬性，這兩個屬性被@In和@Out所注解。

@Stateless
@Name("manager")
public class ManagerAction implements Manager {

  @In @Out
  private Person person;

  @Out
  private List <Person> fans; 

注解@In和@Out在Seam編程模型中處于核心。因此，讓我們看看到底它們在這里是做什么的。

注解@In告訴Seam，在此會話bean中，執(zhí)行任何一個方法之前，Seam就會把由JSF表單構(gòu)造的名為person組件賦給該person字段（通過依賴注入）。開發(fā)者能為@In中的注入的組件指定一個任意的名稱，但是如果沒有指定，如這里所示，Seam會將同類型以及同名稱的組件注入到該字段中。注解@Out告訴Seam，在執(zhí)行任何方法后，Seam會將屬性fans值和屬性person的值都賦給被Seam管理的同名的組件。在Seam中，我們將這個操作稱作 “依賴拋出”。以此，在ManagerAction.sayHello()方法中，我們僅僅需要更新屬性fans和屬性person的值，它們會自動顯示在頁面上。

什么是雙向映射

在Seam 文件中，有時你就會看到術(shù)語“雙向映射”。它指的是被Seam管理的組件和Seam管理上下之間的注入和拋出。

因為person屬性已經(jīng)通過注入持有了表單數(shù)據(jù)，sayHello()方法僅僅是通過JPA EntityManager將它保存到數(shù)據(jù)庫中，JPA EntityManager也是通過@PersistenceContext注入的。當(dāng)方法返回之后，它便更新了fans和person對象并且把這兩個對象拋出。方法sayHello()一般會返回null，預(yù)示著在調(diào)用之后，更新的數(shù)據(jù)模型將在當(dāng)前的JSF頁面顯示。

  @PersistenceContext
  private EntityManager em;

  public String sayHello () {
    em.persist (person);
    person = new Person ();
    fans = em.createQuery("select p from Person p")
          .getResultList();

    return null;
  }

除了一些細(xì)節(jié)，我們基本完成了。可能你已經(jīng)注意到，ManagerAction bean類實現(xiàn)了Manager接口。為了符合EJB3會話bean 規(guī)范，我需要一個能列出bean中所有業(yè)務(wù)方法的方法。下面是接口Manager代碼，幸運的是，用任何高級IDE工具都能輕松地自動生成這個接口。

@Local
public interface Manager {
  public String sayHello ();
}

這就是在Hello World例子中需要的所有代碼。后面兩章小節(jié)將涵蓋Seam應(yīng)用的其他方法和配置。如果開發(fā)者為了自己的小型數(shù)據(jù)庫應(yīng)用想立即編碼和定制helloworld項目，那么現(xiàn)在就可以跳過本章的剩余部分。

4. 更易于理解的seam編程模型

現(xiàn)在我們已經(jīng)大致了解了Hello World的應(yīng)用。但是我們還有一些重要的話題繼續(xù)，例如其他折中途徑以及前面代碼沒有涉及到重要特性，我們將在本節(jié)討論這些話題。它們能幫助開發(fā)者對seam更深刻的理解，但是如果你沒有耐心，可以直接跳過本節(jié)，需要的時再來閱讀。

4.1 Seam POJO組件

上例中，我們用一個EJB3會話bean實現(xiàn)了應(yīng)用邏輯，但是我們并不局限于EJB3組件。事實上，Seam中任何一個有@Name注解的POJO都能被轉(zhuǎn)化為一個可管理的組件。

例如，我們能將ManagerAction轉(zhuǎn)化為一個 POJO，而不是一個EJB3 session bean。

@Name("manager")
public class ManagerAction {

  @In (create=true)
  private EntityManager em;

  ... ...
} 

使用POJO取代EJB3 bean有正反兩方面意見，使用POJO編程時很簡單，因為它們不需要EJB3特有的注解和接口（參見上文）。如果你的所有業(yè)務(wù)組件都是Seam POJO, 那么你就能不依賴EJB3應(yīng)用服務(wù)器，運行你的Seam 應(yīng)用（參見23章，沒有EJB3的Seam)。

但是，POJO比EJB3的功能少，因為POJO不能獲得EJB3容器服務(wù)。在不依賴EJB3的Seam 中喪失的EJB3服務(wù)就包括以下幾點：

• @PersistenceContext注入在POJO中不在管用。為了在一個Seam POJO中得到EntityManager，開發(fā)者不得不在Seam配種文件中初始化EntityManager，然后使用Seam注解@In將它注入到POJO中。
• POJOs中將不在支持方法級別事務(wù)聲明（declarative method-level transaction）。相反，你可以配置Seam來劃分事務(wù)，可以從收到web請求開始直到響應(yīng)頁面產(chǎn)生結(jié)束。
• Seam POJO不是消息驅(qū)動組件。
• 不支持注解為@Asynchronous的方法。
• 不支持容器安全管理。
• 沒有事務(wù)或者組件級別的持久上下文。Seam POJO中的所有的持久上下文都是經(jīng)過拓展的（更多細(xì)節(jié)請參見7.1 “默認(rèn)的對話作用域”）。
• 沒有集成容器管理的體系結(jié)構(gòu)（例如，JMX控制臺服務(wù)）。
• Seam POJO方法中沒有Java RMI。
• Seam POJO不能是注解為@WebService組件。
• 沒有JCA集成。

所以當(dāng)在EJB3容器中進行部署時，為什么每個人都想使用POJO組件？答案就是，POJO組件對于純“業(yè)務(wù)邏輯”組件非常有益。POJO為其他組件代理了數(shù)據(jù)訪問、消息傳遞和其他基本功能。例如，我們能使用POJO組件操縱Seam數(shù)據(jù)訪問對象，這對“業(yè)務(wù)邏輯”POJO是非常有用的，因為它們可以在需要的時候，在其他框架中被重用。但是總的來說，它們的應(yīng)用要比EJB3組件少，特別是在中小型應(yīng)用中。所以，本書的大多數(shù)例子我們都使用EJB3組件。

4.2 易于測試

我們已經(jīng)在第一章中提到，Seam為了不依賴容器的方便的測試，進行了重新設(shè)計。在helloworld項目中，我們在測試文件夾中包括了單元測試和集成測試這兩個測試用例。在純Java SE環(huán)境下，Seam 測試體系模擬了數(shù)據(jù)庫、JSF、Seam上下文以及其他應(yīng)用服務(wù)器服務(wù)，只要運行ant test命令就能運行所有的測試。

4.3 基于Getter和Setter的雙向映射

在Hello World一例中，我們已經(jīng)展示了通過成員變量對Seam組件進行的雙向映射，你也能通過Getter和Setter方法對組件進行雙向映射。例如，以下代碼就工作的很好。

private Person person;
private List <Person> fans;

@In
public void setPerson (Person person) {
  this.person = person;
}
@Out
public Person getPerson () {
  return person;
}
@Out
public List <Person> getFans () {
  return fans;
}

雖然以上的getter和setter方法看似輕微，利用getter和setter方法的雙向映射真正的價值在于能其加入定制邏輯來操縱雙向映射的過程。例如，你可以驗證被注入的對象或者快速地從數(shù)據(jù)庫重新得到被拋出的對象。

4.4避免過度的雙向映射

在Hello World一例中 ,通過將數(shù)據(jù)組件作為業(yè)務(wù)組件的屬性，可以輕易的減少或者消除雙向映射。在JSF頁面中，通過這種方式，開發(fā)者只需要引用業(yè)務(wù)組件，而不需要在業(yè)務(wù)組件和數(shù)據(jù)組件之間的雙向映射。例如，開發(fā)者可以修改 ManagerAction類為以下所述。

依賴雙向映射是一個非常實用的設(shè)計模式。但是，正如其他設(shè)計模式，過度使用就會有害。過度的依賴雙向映射讓代碼變得難以閱讀，因為開發(fā)者必須理解每個注入的組件出自何處。過度的依賴雙向映射也能增加性能消耗，因為雙向映射是在運行時進行。

@Stateless
@Name("manager")
public class ManagerAction implements Manager {

  private Person person;
  public Person getPerson () {return person;}
  public void setPerson (Person person) {
    this.person = person;
  }

  private List <Person> fans;
  public List<Person> getFans () {return fans;}

...  ...
}

接下來，我們在頁面上引用的屬性如下：

<h:form>

Please enter your name:<br/>

<h:inputText value="#{manager.person.name}"/>
<br/>
<h:commandButton type="submit" value="Say Hello"
                 action="#{manager.sayHello}"/>
</h:form>

... ...

<h:dataTable value="#{manager.fans}" var="fan">
  <h:column>
    <h:outputText value="#{fan.name}"/>
  </h:column>
</h:dataTable>

最后，具有了依賴管理的Seam是多用的。通常用數(shù)據(jù)訪問業(yè)務(wù)組件封裝數(shù)據(jù)是一項好的實踐，特別是針對有狀態(tài)業(yè)務(wù)組件。

4.5 JSF中的頁面導(dǎo)航

本例中，只有一個頁面。每次點擊按鈕后，JSF頁面會重新顯示更新過的數(shù)據(jù)模型。顯然，大多數(shù)web應(yīng)用多于一個頁面。在JSF中，一個用戶界面事件處理器能通過返回導(dǎo)航規(guī)則名稱，決定下一步該顯示哪個頁面。例如，開發(fā)者可以在navigation.xml中定義以下導(dǎo)航規(guī)則。

<navigation-case>
  <from-outcome>anotherPage</from-outcome>
  <to-view-id>/anotherPage.jsp</to-view-id>
</navigation-case>

之后，如果sayHello()方法返回一個名為“another page”的字符串，JSF下一步就該展示anotherPage.jsp。UI事件處理器決定了接下來要顯示哪個頁面，從而為我們帶來了有步驟的控制。

4.6 通過EntityManager訪問數(shù)據(jù)庫

JPA（Java Persistence API）EntityManager管理著關(guān)系數(shù)據(jù)庫表與實體bean 之間的映射。EntityManager 在運行時由應(yīng)用服務(wù)器創(chuàng)建。你能使用注解@PersistenceContext，注入一個EntityManager的實例。

EntityManager.persist()方法將實體bean存為與之對應(yīng)數(shù)據(jù)表的一條記錄。EntityManager.query()方法運行SQL化的查詢，并以實體bean集合形式從數(shù)據(jù)庫返回數(shù)據(jù)。更多細(xì)節(jié)請參考JPA文件中關(guān)于如何使用EntityManager和查詢語言。在本書中，我們只用最簡單的查詢語句。

默認(rèn)地，EntityManager將數(shù)據(jù)存于嵌入的HSQL數(shù)據(jù)庫中。如果在本機上運行Jboss AS，可以通過以下步驟，為HSQL數(shù)據(jù)庫開啟一個GUI控制臺：訪問http://localhost:8080/jmx-console/，點擊database=localDB,service=Hypersonic MBean服務(wù)，之后，點擊在startDatabaseManager方法下方的“invoke”按鈕。你就可以從控制臺執(zhí)行任意SQL指令。

5. 配置和打包

下面，我們將轉(zhuǎn)移話題，討論配置文件和應(yīng)用程序打包。實際上，你可以通過Seam Gen命令行工具，生成幾乎所有的配置文檔和構(gòu)造腳本文件?；蛘吣阋部梢院唵蔚闹赜迷谑纠械脑次募Ｋ?，如果你想首先學(xué)習(xí)Seam編程技術(shù)，但又擔(dān)心接下來的配置和部署，這個是很正常的。你可以完全放心地跳過本節(jié)，需要的時候可以再次閱讀。

本節(jié)中，我們集中探討Seam EJB3組件配置，JBoss AS外的Seam POJO配置和部署當(dāng)然是可行的。

大多數(shù)Seam配置文件都是XML文檔。但是等等！我們剛才不是承諾Seam能讓我們擺脫J2EE和Spring中的XML地獄嗎？為什么它又有了XML文檔呢? 是的，XML文檔確實有很多用處。XML文檔非常適合部署階段的配置（例如web應(yīng)用的根URL和后臺數(shù)據(jù)庫的定位）。因為它允許我們在部署階段改變配置而不需要改變和重新編譯源代碼。它也適合粘合應(yīng)用服務(wù)器中的不同子系統(tǒng)（例如，配置如何讓JSF組件與Seam EJB3組件交互）。XML文檔也非常適合表示層相關(guān)內(nèi)容（例如網(wǎng)頁和頁面導(dǎo)航流程）。

我們反對在XML文檔中重復(fù)已經(jīng)存在于Java源代碼中的信息。開發(fā)者很快就會發(fā)現(xiàn)，這個簡單的SeamEJB3 應(yīng)用有多個XML配置文檔，每個文檔那個都非常簡短，并且沒有一個包含存在于Java代碼中的信息。換句話說，Seam中沒有“XML代碼”。

進一步講，XML文檔中的大多數(shù)內(nèi)容都是靜態(tài)的。所以開發(fā)者能在自己的Seam應(yīng)用中輕松地重用這些文檔。如何使用示例作為自己的應(yīng)用模板的介紹，請參見附錄B——使用應(yīng)用示例作為模板。

我們將用下面幾頁來詳細(xì)講解示例應(yīng)用的配置文檔和打包后的目錄結(jié)構(gòu)。如果你沒有耐心看下去，而且很滿意這個應(yīng)用模板，你可以跳過以下內(nèi)容。不管怎樣，不再羅嗦, 我們一起來了解hello world示例是如何進行配置和打包的。為了構(gòu)建一個JBoss AS的部署Seam 應(yīng)用，我們必須將以上所有java 類和配置文檔打包為企業(yè)應(yīng)用程序歸檔(EAR)。該例中，EAR文件是helloworld.ear。它包含了三個JAR文件那個和兩個XML配置文檔。

helloworld.ear
|+ app.war        //包含Web頁面等
|+ app.jar        //包含Seam組件
|+ jboss-seam.jar // Seam庫
|+ META-INF
   |+ application.xml
   |+ jboss-app.xml  

源代碼目錄

在此項目的源代碼中，resources/WEB-INF目錄包含屬于app.war/WEB-INF目錄的配置文檔。resources/META-INF目錄包含屬于app.jar/META-INF和helloworld.ear/META-INF的文檔。Resources根目錄包含屬于根目錄app.jar的文檔。

application.xml文檔列出了在EAR中的JAR文件，并為該應(yīng)用指定了根URL。

<application>
  <display-name>Seam Hello World</display-name>

  <module>
    <web>
      <web-uri>app.war</web-uri>
      <context-root>/helloworld</context-root>
    </web>
  </module>

  <module>
    <ejb>app.jar</ejb>
  </module>

  <module>
    <java>jboss-seam.jar</java>
  </module>

</application>

jboss-app.xml文檔為該應(yīng)用指定了類加載器，每個EAR應(yīng)用的類加載器應(yīng)該有一個唯一的名稱。這里我們使用應(yīng)用程序名作為類加載器的名稱，以避免重復(fù)。

<jboss-app>
  <loader-repository>
    helloworld:archive=helloworld.ear
  </loader-repository>
</jboss-app>

jboss-seam.jar是Seam發(fā)布Seam類庫。app.war和app.jar文檔由我們來建構(gòu)。所以，下面我們要研究app.war和app.jar。

5.1. WAR文件

app.war是按照Web應(yīng)用程序歸檔規(guī)范打包的JAR文件，它包含頁面和標(biāo)準(zhǔn)的JSF/Seam配置文檔。你還可以將JSF特有的類庫文件放入WEB-INF/lib目錄 (例如jboss-seam-ui.jar)。

app.war
|+ hello.jsp
|+ index.html
|+ WEB-INF
   |+ web.xml
   |+ faces-config.xml
   |+ components.xml
   |+ navigation.xml

web.xml文檔是所有java EE web應(yīng)用必需的。JSF用它來配置JSF servlet控制器，Seam用它來攔截所有的web請求。該配置文檔的相當(dāng)標(biāo)準(zhǔn)。

<web-app version="2.4"
    xmlns="http://java./xml/ns/j2ee"
    xmlns:xsi="..."
    xsi:schemaLocation="...">

  <!-- Seam -->
  <listener>
    <listener-class>
      org.jboss.seam.servlet.SeamListener
    </listener-class>
  </listener>

  <!-- MyFaces -->
  <listener>
    <listener-class>
org.apache.myfaces.webapp.StartupServletContextListener
    </listener-class>
  </listener>

  <context-param>
    <param-name>
      javax.faces.STATE_SAVING_METHOD
    </param-name>
    <param-value>client</param-value>
  </context-param>

  <servlet>
    <servlet-name>Faces Servlet</servlet-name>
    <servlet-class>
      javax.faces.webapp.FacesServlet
    </servlet-class>
    <load-on-startup>1</load-on-startup>
  </servlet>

  <!-- Faces Servlet Mapping -->
  <servlet-mapping>
    <servlet-name>Faces Servlet</servlet-name>
    <url-pattern>*.seam</url-pattern>
  </servlet-mapping>
  <context-param>
    <param-name>javax.faces.CONFIG_FILES</param-name>
    <param-value>/WEB-INF/navigation.xml</param-value>
  </context-param>
</web-app>

faces-config.xml文檔是JSF標(biāo)準(zhǔn)的配置文檔，Seam用它來將其攔截器添加到JSF生命周期中。

<faces-config>

  <lifecycle>
    <phase-listener>
      org.jboss.seam.jsf.SeamPhaseListener
    </phase-listener>
  </lifecycle>

</faces-config>

navigation.xml文檔為多頁面應(yīng)用包含JSF頁面導(dǎo)航規(guī)則。因為hello world示例只有一個簡單的頁面，因此該文檔是空的。

components.xml文檔包含Seam特有的配置選項，除jndi-pattern屬性以外，其他都不依賴于應(yīng)用。該屬性必須包括EAR文檔的名稱，以便Seam通過其的JNDI全名訪問EJB3 bean。

<components ...>

  <core:init
    jndi-pattern="helloworld/#{ejbName}/local"
    debug="false"/>

  <core:manager conversation-timeout="120000"/>

</components>

5.2. Seam組件JAR包

app.jar文檔包含所有的EJB3bean 類（實體bean和會話bean）以及EJB3相關(guān)的配置文檔。

app.jar
|+ Person.class        // entity bean
|+ Manager.class       // session bean interface
|+ ManagerAction.class // session bean
|+ seam.properties     // empty file but needed
|+ META-INF
   |+ ejb-jar.xml
   |+ persistence.xml

seam.properties文檔這兒是空但必需的，因為Jboss要通過它知道此JAR文件包含Seam EJB3 bean類，并且相應(yīng)地處理注解。

ejb-jar.xml文檔包含額外的配置信息，這些信息能重載或者增補EJB3 bean上的注解。在一個Seam應(yīng)用中，它能將所有的EJB3 類加入Seam攔截器。我們能在所有的Seam應(yīng)用中重用該文檔。

<ejb-jar>
  <assembly-descriptor>
    <interceptor-binding>
      <ejb-name>*</ejb-name>
      <interceptor-class>
        org.jboss.seam.ejb.SeamInterceptor
      </interceptor-class>
    </interceptor-binding>
  </assembly-descriptor>
</ejb-jar>

persistence.xml文檔為EJB3 實體bean配置了后臺數(shù)據(jù)源。本例中，我們只是使用了被嵌入到JBoss AS中默認(rèn)的HSQL數(shù)據(jù)庫(也就是java:/DefaultDS數(shù)據(jù)源)。

<persistence>
  <persistence-unit name="helloworld">
    <provider>
      org.hibernate.ejb.HibernatePersistence
    </provider>
    <jta-data-source>java:/DefaultDS</jta-data-source>
    <properties>
      <property name="hibernate.dialect"
          value="org.hibernate.dialect.HSQLDialect"/>
      <property name="hibernate.hbm2ddl.auto"
          value="create-drop"/>
      <property name="hibernate.show_sql" value="true"/>
    </properties>
  </persistence-unit>
</persistence>

這樣，以上就是一個簡單Seam應(yīng)用所需的所有配置和打包。我們將在以后討論到本書的更高級的主題時，涵蓋更多的配置選項和類庫。再次強調(diào)一下，Seam應(yīng)用入門最簡單的方法就是，不要擔(dān)心這些配置文件，只需要從已有的應(yīng)用模板做起。

6. 為何這么簡單？

這就是hello world 應(yīng)用，三個簡單的Java類，一個JSF頁面，一組靜態(tài)配置文件。我們已經(jīng)有了一個完整的數(shù)據(jù)庫驅(qū)動的web應(yīng)用。整個應(yīng)用只需要的是少于30行的Java代碼，沒有一處“XML代碼”。但是如果開發(fā)者有PHP背景，你可能仍然會問“何以這么簡單？我能在php中使用更少的代碼嗎？”

好吧，答案就是Seam應(yīng)用在理論上要比PHP（或者其他任何一種腳本語言）應(yīng)用簡單的多。Seam 組件模式允許我們，有所控制地，可維護地給應(yīng)用增加更多的功能。我們很快就會發(fā)現(xiàn)，Seam組件使開發(fā)有狀態(tài)的和有事務(wù)的web應(yīng)用變得易如反掌。對象關(guān)系映射框架（例如：實體bean）允許我們將注意力放在抽象數(shù)據(jù)模型上，而不需要處理數(shù)據(jù)庫特有的SQL語句。

本文是基于該書的第一章和第二章。后面的章節(jié)中，我們繼續(xù)討論如何使用Seam組件繼續(xù)開發(fā)復(fù)雜的Seam 應(yīng)用。參見本書目錄來查看本書的所有主題。