集成JSF与BEEHIVE PAGE FLOW

　　JSF对通过关联组件和事件来构建页面而说是非常棒的，但是，与所有现有的技术一样，它需要一个控制器来分离出页面间的导航决策，并提供到业务层的链接。它拥有一个基本的导航处理程序，可以用功能完备的处理程序来替换它。Page Flow为创建可重用的封装页面流提供了基础，并可以与视图层并行工作。它是一个功能完备的导航处理程序，将JSF页面作为最优先的处理对象。本文将讨论如何集成这两种技术来利用二者的优点。

　　构建Beehive/JSF应用程序

　　要构建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中运行。