Jboss seam
Jboss seam
JBoss Seam是“Java EE 5.0的一個輕量級的框架，在Java EE 5.0框架的上層，為所有的在企業Web應用中的組件提供了一個統一的、易於理解的編程模型。它同樣使基於狀態的應用和業務流程驅動的應用的開發易如反掌。換句話說，Seam致力於開發者生產力和應用擴展性。
JBoss Seam是“Java EE 5.0的一個輕量級的框架”。這是什麼意思？難道Java EE(Enterprise Edition) 5.0本身不是一套“框架嗎”？為什麼在官方規範之外，還需要另外一個框架？好吧，我們就將seam看作是本應該被包括在Java EE 5.0中的一個“遺漏的框架”吧。它在Java EE 5.0框架的上層，為所有的在企業Web應用中的組件提供了一個統一的、易於理解的編程模型。它同樣使基於狀態的應用和業務流程驅動的應用的開發易如反掌。換句話說，Seam致力於開發者生產力和應用擴展性。
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開發者對第三方框架的認知。
對象關係映射(ORM)解決方案在當今企業應用中廣為使用。但是，大多數當前的業務和web框架並不是為ORM設計的，它們並不在整個Web交互生命周期——從請求來臨到響應完成——管理持久上下文。這就導致了包括可怕的 LazyInitializationException在內的各種ORM異常，帶來了如“數據傳輸對象（DTO）”等醜陋的伎倆（ugly hacks）。
Gavin King發明了Seam，同時他也發明了在世界上廣為使用的ORM解決方案Hibernate。為了繼承和發揚ORM的最佳實踐，Seam進行了重新設計。有了Seam，就不必再寫DTO，你所做的就是延遲載入。因為擴展后的持久上下文就如同一個自然的高速緩存，可以減少和資料庫的交互，ORM的性能就會被極大地改進。
進一步講，因為Seam整合了ORM層、業務層和表示層，開發者就能夠在表示層直接展示ORM對象，也能把資料庫驗證註解用於輸入表單，以及重新定向ORM例外到定製的錯誤頁面。
Seam是專為有狀態Web應用而設計的。Web應用是天生的多用戶應用，電子商務應用天生也是有狀態的和有事務的。但是，大多數已有Web應用框架是面向無狀態應用的。開發者必須操作HTTP會話（session）對象來管理用戶狀態，與核心業務邏輯無關的代碼不僅會混亂你的應用，而且帶來了一系列的性能問題。
在Seam中，所有的基礎應用組件天生地有狀態。它們使用起來要比HTTP session容易，因為它們的狀態由Seam公開管理。沒有必要在Seam應用中編寫引起麻煩的狀態管理代碼——只需在其組件上註解其做用域、生命周期方法以及其他狀態屬性，Seam就會掌管其他[譯者註：指這些組件的生命周期]。Seam狀態組件要比HTTP會話（session）能更好的管理用戶狀態。例如，你能有多個“會話”進行，每個“會話”由在一個HTTP會話（session）中一系列的Web請求和業務方法調用組成。
進一步說，在Seam中，資料庫緩存和事務能自動與應用的狀態相連。Seam在內存中自動保存資料庫更新，等到對話結束后提交到資料庫。內存中的緩存能大大減輕複雜狀態應用中資料庫的負載。
除了以上這些，Seam支持整合開源JBoss jBPM業務程序引擎，大大提升了Web應用中的狀態管理。你現在能為一個機構中不同工作人員（諸如客戶、經理、技術支持人員等等）的指定工作流程，利用工作流程來驅動應用，而不是依賴用戶界面事件處理和資料庫。
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框架。
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術語中，我們稱這個為“依賴雙向映射”。
[譯者註：指以隱式映射為主題，以顯式映射為例外的配置方式] 使Seam易用的主要設計原則是“非常規的配置”。其思想是為這些組件提供一系列默認行為，開發者只需要在預期行為非默認的時候，顯示地配置組件。例如, 當Seam將組件A作為屬性注入到組件B時，默認地，組件A剛會以組件B被注入的屬性的名稱命名。Seam里還有很類似的細節。總的結果是Seam中配置元數據要比其他Java框架簡單的多。因此，大多數的Seam應用能通過一系列簡單的Java註解進行充分配置。開發者從減化的複雜度中受益匪淺，最後，與其他Java框架相比，用更少的代碼實現同樣的功能。
或許你已經注意到，Java註解在表述和處理Seam配置元數據時扮演著重要的角色。通過這樣的設計使框架更易於操作。
在J2EE發展早期，XML曾經被看作配置管理的“聖杯”。框架設計者將所有的配置信息，包括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文檔中並不需要重複鍵入已存在於代碼中的信息。
Seam為了易於測試而重新設計。因為所有的Seam組件都是註解過的POJO，它們易於進行單元測試。開發者僅僅通過利用常規的Java new關鍵詞來構造實例，然後在測試框架（例如JUnit 或者TestNG）中運行任何方法。如果需要測試多個Seam組件的交互，開發者則逐個實例化這些組件，然後手動建立它們的相互關係（也就是顯示地使用setter 方法，而不是依靠Seam依賴注入功能）。
集成測試整個Seam應用比較複雜，因為開發者必須在Seam容器中運行應用。Seam用嵌入的輕量級容器來幫助該類測試。在測試框架中，開發者能按步驟地載入Seam容器，然後運行測試。
對於一個聚焦於開發者生產力的應用框架，開發工具的支持至關重要。Seam發布了一個基於命令行的生成器，稱作 SeamGen。SeamGen類似於Ruby-On-Rails中的生成器，它支持諸如從一個資料庫生成完整CRUD應用的功能，聰明的開發者會通過諸如“編輯/保存/在瀏覽器重新載入”的步驟、有測試支持的特性，來改進web應用。
但更重要的是，SeamGen生成項目不依賴於主流的Java集成開發環境，如Eclipse和NetBeans。有了SeamGen，開發者可以隨時入門。
總而言之，Seam為JavaEE應用削減了開發費用，同時，增加了Java EE 5.0不具有的強大的新功能。在下節（節選自本書第二章），我們將給您展示一些實際代碼例子來闡述Seam如何工作的。你能通過網站2下載到本書中所有的例子的源代碼。
JBoss Seam是EJB3和JSF中間的粘合劑，這是Jboss Seam最基本的和最廣泛的應用。通過被Seam管理的組件，Seam允許這兩個框架之間無縫(不是有意雙關的)的集成。它為整個web應用拓展了基於註解的EJB3 POJO編程模型。在層與層之間，沒有了必需的手動JNDI查找，沒有了冗長的JSF支持bean的聲明，沒有了過多facade方法，沒有了艱辛的對象傳遞，快哉！
在傳統的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版本以上 (見4)。進入HelloWorld目錄，運行命令ant，則會生成build/jars/helloworld.ear文件，可以直接拷貝該文件到Jboss AS實例的server/default/deploy目錄下。現在，啟動JBoss AS並且打開網址http://localhost:8080/helloworld/。
為了運行本書中的例子，我們建議您使用JEMS GUI安裝程序安裝一個與Seam兼容的JBoss AS。您可以從下（見1）載JEMS安裝程序。如果您需要更多安裝JBoss AS和應用部署幫助，請參見附錄A，“安裝和部署JBoss AS”
歡迎使用示例作為模板，快速開始你自己Seam項目（參見附錄B “使用應用示例作為模板”）。或者，你能使用命令行工具Seam Gen (參見第四章“快速應用開發工具”)自動生成項目模板，包括所有的配置文件。本章中，我將花少量的時間來闡釋源代碼項目中的目錄結構。相反，我們將集中討論代碼和配置，這也是開發者建立一個Seam 應用必需的。如此，我們就能將知識應用到任何一個項目結構，而不需要受模板的限制。
一個Seam應用由java類和XML或文本配置文件組成。本書的項目例子中，java源代碼文件在src目錄中，網頁在view 目錄中，所有的配置文件都在resources目錄中。更多信息請看附件B,使用應用示例作為模板。
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) { = id; }
public String getName() { return name; }
public void setName(String name) {= name;}
}Person類中最重要的註解是@Name，它為這個將要註冊於Seam中的Person bean指定了名稱。在其他Seam組件中（例如，頁面和會話bean）中，開發者能指直接使用“ person”來引用被管理的 Person bean。
在JSF頁面中，我們使用Person bean來支持表單輸入文本域。 #{}符號指代名為“ person”的Seam組件的name屬性，名為“ person”的Seam組件是 Person實體bean的一個實例。
Please enter your name:
action="#{manager.sayHello}"/>
通過以下的實體表單，JSF頁面顯示了資料庫中所有已經向Seam說“hello”的用戶。用戶名單列表存儲在一個名為“ fans”的Seam組件中，它是一個 List 對象。JSF dataTable通過遍歷列表，每一行顯示一個 Person對象。 Fan標記是 fans列表的迭代子。
圖2.1顯示了Hello World網頁
當用戶點擊“Say Hello”按鈕提交表單，Seam用輸入數據構造了該person組件。然後它調用了名為“ manager”的Seam 組件的sayhello()的方法(像這樣， #{manager.sayHello}是表單提交按鈕的UI事件處理器)，這就在資料庫中保存了 person對象並且刷新了 fans列表。名為 manager的組件是一個EJB3的會話bean, 我們將在下節討論該話題。
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 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項目，那麼現在就可以跳過本章的剩餘部分。
現在我們已經大致了解了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 fans;
@In
public void setPerson (Person person) {
this.person = person;
}
@Out
public Person getPerson () {
return person;
}
@Out
public List 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 fans;
public List getFans () {return fans;}
... ...
}接下來，我們在頁面上引用的屬性如下：
Please enter your name:
action="#{manager.sayHello}"/>
... ...
最後，具有了依賴管理的Seam是多用的。通常用數據訪問業務組件封裝數據是一項好的實踐，特別是針對有狀態業務組件。
4.5 JSF中的頁面導航本例中，只有一個頁面。每次點擊按鈕后，JSF頁面會重新顯示更新過的數據模型。顯然，大多數web應用多於一個頁面。在JSF中，一個用戶界面事件處理器能通過返回導航規則名稱，決定下一步該顯示哪個頁面。例如，開發者可以在 navigation.xml中定義以下導航規則。
之後，如果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指令。
下面，我們將轉移話題，討論配置文件和應用程序打包。實際上，你可以通過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。
jboss-app.xml文檔為該應用指定了類載入器，每個EAR應用的類載入器應該有一個唯一的名稱。這裡我們使用應用程序名作為類載入器的名稱，以避免重複。
helloworld:archive=helloworld.ear
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請求。該配置文檔的相當標準。
xmlns="3"
xmlns:xsi="..."
xsi:schemaLocation="...">
org.jboss.seam.servlet.SeamListener
org.apache.myfaces.webapp.StartupServletContextListener
javax.faces.STATE_SAVING_METHOD
javax.faces.webapp.FacesServlet
faces-config.xml文檔是JSF標準的配置文檔，Seam用它來將其攔截器添加到JSF生命周期中。
org.jboss.seam.jsf.SeamPhaseListener
navigation.xml文檔為多頁面應用包含JSF頁面導航規則。因為hello world示例只有一個簡單的頁面，因此該文檔是空的。
components.xml文檔包含Seam特有的配置選項，除 jndi-pattern屬性以外，其他都不依賴於應用。該屬性必須包括EAR文檔的名稱，以便Seam通過其的JNDI全名訪問EJB3 bean。
jndi-pattern="helloworld/#/local"
debug="false"/>
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應用中重用該文檔。
org.jboss.seam.ejb.SeamInterceptor
persistence.xml文檔為EJB3 實體bean配置了後台數據源。本例中，我們只是使用了被嵌入到JBoss AS中默認的HSQL資料庫(也就是 java:/DefaultDS數據源)。
org.hibernate.ejb.HibernatePersistence
value="org.hibernate.dialect.HSQLDialect"/>
value="create-drop"/>
這樣，以上就是一個簡單Seam應用所需的所有配置和打包。我們將在以後討論到本書的更高級的主題時，涵蓋更多的配置選項和類庫。再次強調一下，Seam應用入門最簡單的方法就是，不要擔心這些配置文件，只需要從已有的應用模板做起。
這就是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
目錄