Sealyu

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

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

什么是Seam？

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

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)的業務服務和數據庫持久化的輕型框架。JSF是一個基于MVC(Model-View-Controller)的Web應用框架。大多數 的Web應用都將包含有業務邏輯的EJB3組件和Web應用前端顯示的JSF組件。EJB3和JSF雖然互補，但是他們是根據各自的理念設計的獨立的框 架。例如，EJB3使用注解（annotation）來配置服務，而JSF使用的是XML文件。更進一步講，EJB3和JSF組件在框架層面上是互不敏感 的。要整合EJB3和JSF，開發者必須手動地構造facade對象（如：JSF支持bean），將業務組件與Web頁面和樣板代碼（又稱 plumbing代碼）聯結起來，以便能跨框架調用方法。將這些技術粘合起來是Seam的職責之一。

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

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

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

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

1 + 1 > 2

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

2. 一個為ORM設計的Web框架

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

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

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

3.專為有狀態Web應用而設計

Seam是專為有狀態Web應用而設計的。Web應用是天生的多用戶應用，電子商務應用天生也是有狀態的和有事務的。但是，大多數已有Web應用框 架是面向無狀態應用的。開發者必須操作HTTP會話（session）對象來管理用戶狀態，與核心業務邏輯無關的代碼不僅會混亂你的應用，而且帶來了一系 列的性能問題。

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

進一步說，在Seam中，數據庫緩存和事務能自動與應用的狀態相連。Seam在內存中自動保存數據庫更新，等到對話結束后提交到數據庫。內存中的緩存能大大減輕復雜狀態應用中數據庫的負載。

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

4. 支持Web 2.0

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

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

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

5.依賴雙向映射的Pojo服務

Seam是一個“輕量級”框架，因為它使用POJO（plain old Java objects）作為服務組件。在應用中，POJO沒有使用接口或抽象類來"鉤住"組件。當然，問題是如何使POJO交互來組成這個應用？它們如何與容器 服務（例如，數據庫持久化服務）交互？

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

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

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

6.非常規的配置

[譯者注：指以隱式映射為主題，以顯式映射為例外的配置方式]

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

7.避免濫用XML

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

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

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

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

8.為測試而設計

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

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

9. 卓越的工具支持

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

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

10. 讓我們開始編碼吧

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

Seam Hello World

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

繼續在Seam中使用JavaEE模式

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

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

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

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

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

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

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

源代碼目錄

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

1. 創建一個數據模型

Helloworld應用中的數據模型僅僅是一個有name和id屬性的person 類。注解@Entity告訴容器映射該類到一個關系數據庫表，每個屬性對應表中一個字段，每個person實例相當于表中的一條記錄。因為Seam采用非常規的配置方式，容器為表名和字段中僅僅使用類名和屬性名。屬性id上的@Id和@GeneratedValue注解暗示id字段是主鍵，它的值是應用服務器為每個保存到數據庫的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）中，開發者能指直接使用“person”來引用被管理的Person bean。

2. 將數據模型映射到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頁面顯示了數據庫中所有已經向Seam說“hello”的用戶。用戶名單列表存儲在一個名為“fans”的Seam組件中，它是一個List 對象。JSFdataTable通過遍歷列表，每一行顯示一個Person對象。Fan標記是fans列表的迭代子。

<h:dataTable value="#{fans}" var="fan">

<h:column>

<h:outputText value="#{fan.name}"/>

</h:column>

</h:dataTable>

圖2.1顯示了Hello World網頁

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

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

什么是雙向映射

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

因為person屬性已經通過注入持有了表單數據，sayHello()方法僅僅是通過JPA EntityManager將它保存到數據庫中，JPA EntityManager也是通過@PersistenceContext注入的。當方法返回之后，它便更新了fans和person對象并且把這兩個對象拋出。方法sayHello()一般會返回null，預示著在調用之后，更新的數據模型將在當前的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;

}

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

@Local

public interface Manager {

public String sayHello ();

}

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

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

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

4.1 Seam POJO組件

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

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

@Name("manager")

public class ManagerAction {



@In (create=true)

private EntityManager em;



... ...

} 

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

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

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

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

4.2 易于測試

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

4.3 基于Getter和Setter的雙向映射

在Hello World一例中，我們已經展示了通過成員變量對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方法的雙向映射真正的價值在于能其加入定制邏輯來操縱雙向映射的過程。例如，你可以驗證被注入的對象或者快速地從數據庫重新得到被拋出的對象。

4.4避免過度的雙向映射

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

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

@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是多用的。通常用數據訪問業務組件封裝數據是一項好的實踐，特別是針對有狀態業務組件。

4.5 JSF中的頁面導航

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

<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訪問數據庫

JPA（Java Persistence API）EntityManager管理著關系數據庫表與實體bean 之間的映射。EntityManager 在運行時由應用服務器創建。你能使用注解@PersistenceContext，注入一個EntityManager的實例。

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

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

5. 配置和打包

下面，我們將轉移話題，討論配置文件和應用程序打包。實際上，你可以通過Seam Gen命令行工具，生成幾乎所有的配置文檔和構造腳本文件。或者你也可以簡單的重用在示例中的源文件。所以，如果你想首先學習Seam編程技術，但又擔心 接下來的配置和部署，這個是很正常的。你可以完全放心地跳過本節，需要的時候可以再次閱讀。

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

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

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

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

我們將用下面幾頁來詳細講解示例應用的配置文檔和打包后的目錄結構。如果你沒有耐心看下去，而且很滿意這個應用模板，你可以跳過以下內容。不管怎 樣，不再羅嗦, 我們一起來了解hello world示例是如何進行配置和打包的。為了構建一個JBoss AS的部署Seam 應用，我們必須將以上所有java 類和配置文檔打包為企業應用程序歸檔(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文件，并為該應用指定了根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文檔為該應用指定了類加載器，每個EAR應用的類加載器應該有一個唯一的名稱。這里我們使用應用程序名作為類加載器的名稱，以避免重復。

<jboss-app>

<loader-repository>

helloworld:archive=helloworld.ear

</loader-repository>

</jboss-app>

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

5.1. WAR文件

app.war是按照Web應用程序歸檔規范打包的JAR文件，它包含頁面和標準的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應用必需的。JSF用它來配置JSF servlet控制器，Seam用它來攔截所有的web請求。該配置文檔的相當標準。

<web-app version="2.4"

xmlns="http://java.sun.com/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標準的配置文檔，Seam用它來將其攔截器添加到JSF生命周期中。

<faces-config>



<lifecycle>

<phase-listener>

org.jboss.seam.jsf.SeamPhaseListener

</phase-listener>

</lifecycle>



</faces-config>

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

components.xml文檔包含Seam特有的配置選項，除jndi-pattern屬性以外，其他都不依賴于應用。該屬性必須包括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相關的配置文檔。

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類，并且相應地處理注解。

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

<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配置了后臺數據源。本例中，我們只是使用了被嵌入到JBoss AS中默認的HSQL數據庫(也就是java:/DefaultDS數據源)。

<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應用所需的所有配置和打包。我們將在以后討論到本書的更高級的主題時，涵蓋更多的配置選項和類庫。再次強調一下，Seam應用入門最簡單的方法就是，不要擔心這些配置文件，只需要從已有的應用模板做起。

6. 為何這么簡單？

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

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

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

請看Gavin King的兩個訪談錄來查看以往關于Seam的話題。

• JBoss Seam 1.1 Indepth: An Interview with Gavin King
• JBoss Seam 1.0: rethinking web application architecture

關于作者

Dr. Michael Yuan是JBoss Seam: Simplicity and Power Beyond Java EE 5.0一書的作者。該書探討了下一代web應用框架。他同時也是Nokia Smartphone Hacks一書和其他三本技術讀物的作者。Michael潛心研究輕量級企業web應用，終端對終端的移動應用開發。你可以通過他的博客聯系他。

查看英文原文：Introduction to JBoss Seam