要構建beehive/jsf應用程序，首先要啟動page flow，然后添加對jsf的支持。起點是從基本的支持netui（beehive中包含page flow的組件）的項目開始。根據指導構建基本的支持netui的web應用程序。在本文中，我們暫且稱之為“jsf-beehive”，可以在 http://localhost:8080/jsf-beehive 上獲得。
接下來，安裝并配置jsf。page flow可以使用任何與javaserver faces 1.1兼容的實現，并針對兩種主流實現進行了測試：apache myfaces和jsf reference implementation。根據下面的指導在新的web應用程序中安裝jsf：myfaces v1.0.9及更高版本，jsf reference implementation v1.1_01，或者其他實現。之后，可以使用web-inf/faces-config.xml中的一個簡單入口啟動page flow集成，入口在<application>標簽之下，<navigation-rule>標簽之上：
<factory> <application-factory> org.apache.beehive.netui.pageflow.faces.pageflowapplicationfactory </application-factory></factory>
添加了這些就為頁面流提供了一個機會，使其可以提供自己的jsf框架對象版本來定制其行為。通常來說，只有在使用頁面流功能的時候，jsf行為才會被修改；jsf的基本行為不會改變。
jsf中頁面流的最基本用處是引發（調用）來自jsf頁面的動作。jsf頁面可以處理頁面內事件，而頁面流動作則是從一個頁面導航到另一頁面的方法。首先，在web應用程序中創建一個名為“example”的目錄，在其中創建一個頁面流控制器類：
package example;import org.apache.beehive.netui.pageflow.forward;import org.apache.beehive.netui.pageflow.pageflowcontroller;import org.apache.beehive.netui.pageflow.annotations.jpf;@jpf.controller( simpleactions={ @jpf.simpleaction(name="begin", path="page1.faces") })public class examplecontroller extends pageflowcontroller{ @jpf.action( forwards={ @jpf.forward(name="success", path="page2.faces") } ) public forward gopage2() { forward fwd = new forward("success"); return fwd; }}在這個頁面流中有兩個動作：跳轉到page1.faces的begin動作和跳轉到page2.faces的gopage2動作。將gopage2作為一個方法動作（而不是簡單動作）的原因是稍后將會對其進行擴充。
在構造頁面的時候，應當以.jsp為擴展名創建page1和page2；jsf servlet處理每個.faces請求，并最終跳轉到相關的jsp。所以，跳轉到page1.faces最終將顯示page1.jsp，如下：
<%@ taglib prefix="f" uri="http://java.sun.com/jsf/core" %><%@ taglib prefix="h" uri="http://java.sun.com/jsf/html" %> <html> <body> <f:view> <h:form> <h:panelgrid> <h:outputtext value="page 1 of page flow #{pageflow.uri}"/> <h:commandlink action="gopage2" value="go to page 2"/> </h:panelgrid> </h:form> </f:view> </body></html>從jsf頁面引發一個動作很簡單：使用命令組件的action屬性中的動作名字就可以了。在上面的例子中，commandlink指向gopage2動作。使用頁面流集成，這意味著gopage2動作會在example.examplecontroller中運行。
就是這樣。要試驗的話，構建應用程序，點擊 http://localhost:8080/jsf-beehive/example/examplecontroller.jpf ，這將通過begin動作跳轉到page1.faces。單擊鏈接“go to page 2”，會引發gopage2動作并跳轉到page2.faces。
page flow框架可以管理與jsf頁面相關的后臺bean（backing bean）。該類是放置與頁面相關的事件處理程序和狀態的方便場所。可以把它看作是集中放置與頁面交互時所運行的所有代碼的單一場所。當點擊一個jsf頁面時，page flow會判斷是否有具有同樣名稱和包的類，例如，page /example/page1.faces的example.page1類。如果存在這樣的類，并且它用@jpf.facesbacking進行注釋并擴展了facesbackingbean，它就會創建該類的一個實例。當離開jsf頁面而轉到一個動作或者其它任何頁面時，后臺bean會被銷毀。后臺bean與jsf頁面共存亡。
下面是page1.faces的一個非常簡單的后臺bean，以及屬性someproperty。文件名是page1.java：
package example;import org.apache.beehive.netui.pageflow.facesbackingbean;import org.apache.beehive.netui.pageflow.annotations.jpf;@jpf.facesbackingpublic class page1 extends facesbackingbean{ private string _someproperty = "this is a property value from" + getclass().getname() + "."; public string getsomeproperty() { return _someproperty; } public void setsomeproperty(string someproperty) { _someproperty = someproperty; }}在jsf頁面(page1.jsp)中，可以利用backing綁定上下文來綁定到這個屬性：
<h:outputtext value="#{backing.someproperty}"/>
上面的例子顯示了someproperty（最終在后臺bean上調用getsomeproperty()）的值。類似地，設置這個值：
<h:inputtext value="#{backing.someproperty}"/>
注意，在這個例子中，后臺bean中沒有出現事件處理程序或組件引用。這就縮短了代碼；后臺bean是放置頁面所有的處理程序和組件引用的好地方。
在上面的“基本集成”部分，我們直接從jsf組件引發頁面流動作。通常情況下，只需這樣即可；當單擊一個按鈕或者鏈接時，會運行一個動作并跳轉到另一個頁面上。如果想在調用控制器之前運行一些與頁面相關的代碼，或者如果希望頁面可以在幾個動作之間進行動態選擇的話，可以在命令處理程序（jsf頁面所運行的一個java方法）中引發一個動作。下面是一個命令處理程序的例子，可以把它放到后臺bean page2.java中（或者其它任何可公開訪問的bean中）：
public stringchoosenextpage(){ return "gopage3";}這是一個非常簡單的命令處理程序，它選擇了gopage3動作。可以用標準的jsf方式從一個jsf命令組件綁定到這個命令處理程序：
<h:commandbutton action="#{backing.choosenextpage}" value="submit"/>當單擊鏈接時，會運行choosenextpage命令處理程序，它會選擇引發gopage3動作。還可以對命令處理程序方法使用一個特殊的頁面流注釋——@jpf.commandhandler：
@jpf.commandhandler( raiseactions={ @jpf.raiseaction(action="gopage3") })public string choosenextpage(){ return "gopage3";}該注釋使支持beehive的工具可以知道命令處理程序引發了后臺bean中的哪個動作，并允許擴展jsf動作處理的能力（參見下面“從jsf頁面向頁面流發送數據”部分）。
在某些情況下，您或許想直接從后臺bean訪問當前頁面流或一個活動的共享流。為此，只需創建一個適當類型的字段，并使用@jpf.pageflowfield或@jpf.sharedflowfield對其進行適當注釋：
@jpf.commandhandler( raiseactions={ @jpf.raiseaction(action="gopage3") })public string choosenextpage(){ return "gopage3";}這些字段將在創建后臺bean的時候被初始化。無需手動對其進行初始化。下面的例子使用了自動初始化的examplecontroller字段。在這個例子中，“show hints”單選鈕的事件處理程序在頁面流中設置了一個普通優先級。
@jpf.pageflowfieldprivate examplecontroller mycontroller;@jpf.sharedflowfield(name="sharedflow2") // "sharedflow2" is a // name defined in the // page flow controllerprivate examplesharedflow mysharedflow;
在很多情況下，頁面不需要直接與頁面流或者共享流進行交互；使用其它方法從頁面流向jsf頁面傳遞數據就足夠了，反之亦然。下面我將給出一些例子。
您不能從頁面流控制器訪問后臺bean！至少，這不容易做到，這是有意為之的。后臺bean與jsf頁面緊密相關，當您離開頁面的時候，后臺bean會被銷毀。正如頁面流控制器不應了解頁面細節一樣，它也不應了解后臺bean。當然了，可以從后臺bean向控制器傳遞數據（稍后將會介紹），甚至可以傳遞后臺bean實例本身，但是在大多數情況下，后臺bean的內容是不應當泄露給控制器的。
通常，當后臺bean發生某些事情的時候，比如當它被創建或銷毀時，我們希望能運行代碼。在page flow框架的生命周期中，它會對后臺bean調用一些方法：
不管要在哪個時期運行代碼，只需重寫適當的方法：
protected void oncreate(){ /*some create-time logic */}當重寫這些方法時，不需要調用空的super版本。
現在我們該看看如何在jsf頁面和頁面流之間傳遞數據了。
通常，您會想要利用頁面流的數據來初始化一個頁面。為此，可以向page2.faces的forward添加“action outputs”：
@jpf.action( forwards={ @jpf.forward( name="success", path="page2.faces", actionoutputs={ @jpf.actionoutput(name="message", type=string.class,required=true) } ) })public forward gopage2(){ forward fwd = new forward("success"); fwd.addactionoutput("message", "got the message."); return fwd;}做完這些之后，可以直接從jsf頁面或者后臺bean將該值作為頁面輸入來訪問。（如果您不喜歡鍵入冗長的注釋，可以省去斜體的。它們主要用于再次檢查添加的對象類型是否正確，確定不缺失類型。）
可以在頁面中利用jsf表示語言中的頁面流pageinput綁定上下文綁定到這個值：
<h:outputtext value="#{pageinput.message}"/>注意，可以利用pageflow和sharedflow綁定上下文綁定到頁面流控制器自身或者任何可用的共享流的屬性：
<h:outputtext value="#{pageflow.someproperty}"/><h:outputtext value="#{sharedflow.mysharedflow.someproperty}"/>最后，要想從后臺bean訪問頁面輸入，只需在bean類代碼中的任意地方調用getpageinput：
string message = (string) getpageinput("message");還可以隨著頁面流所引發的動作發送數據。很多動作將要求表單bean作為輸入；通常，表單bean用于從頁面獲取數據送到控制器。首先，讓我們構建一個動作來接收表單bean并跳轉到頁面：
@jpf.action( forwards={ @jpf.forward(name="success", path="page3.faces") })public forward gopage3(namebean namebean){ _username = namebean.getfirstname() + ' ' + namebean.getlastname(); return new forward("success");}該動作包含一個namebean，它是一個將getters/setters作為其firstname和lastname屬性的表單bean類。它設置一個成員變量保存完整名字，之后跳轉到page3.faces。我們知道，可以直接從jsf頁面或者它的后臺bean引發一個動作。在這兩種情況下，都可以向動作發送表單bean。下面讓我們依次看看每種情況。
要從后臺bean中的命令處理程序發送表單bean，需要使用一個特定的注釋。下面給出了page2.java中的情況：
private examplecontroller.namebean _namebean;protected void oncreate(){ _namebean = new examplecontroller.namebean();}public examplecontroller.namebean getname(){ return _namebean;}@jpf.commandhandler( raiseactions={ @jpf.raiseaction(action="gopage3", outputformbean="_namebean") })public string choosenextpage(){ return "gopage3";}在這個例子中，jsf頁面可以用它選擇的任何方式填充_namebean的值（例如，通過將h:inputtext值綁定到#{backing.name.firstname}和#{backing.name.lastname}）。之后它使用@jpf.raiseaction上的outputformbean屬性來標記_namebean應當被傳遞到動作gopage3。
從jsf頁面直接發送表單bean很容易，只要您可以通過數據綁定表達式得到bean值。這是通過在commandbutton組件內部添加名為submitformbean的h:attribute組件來實現的：
<h:commandbutton action="#{backing.choosenextpage}" value="submit directly from page"> <f:attribute name="submitformbean" value="backing.name" /></h:commandbutton>在這里，為了使表單bean發送到動作gopage3，按鈕綁定到后臺bean的“name”屬性(getname)。
本文展示了如何將jsf在構建頁面方面的豐富特性與beehive page flow在控制頁面間導航方面的強大功能相結合。二者的集成非常容易，但是卻會對應用造成深遠的影響：它將jsf頁面與應用級邏輯相分離，并把頁面帶入page flow所提供的功能領域中。jsf頁面得到了清楚的任務：作為單個（如果有足夠能力的話）視圖元素參與到應用程序的流中。文中沒有展示jsf頁面中具有事件處理功能且控制器中具有復雜的導航邏輯的完備應用程序。但是隨著應用程序的復雜程度提高，它就會更加需要責任的劃分以及頁面流添加給jsf的高級流功能。您可以花幾分鐘嘗試一下——很快您就將意識到這樣做所帶來的好處。
新聞熱點
疑難解答
