要构建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中运行。
新闻热点
疑难解答