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