用JSF与BEEHIVE PAGE FLOW开发WEB应用 （1）

　　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集成，入口在标签之下，标签之上：

org.apache.beehive.netui.pageflow.faces.PageFlowApplicationFactory
　　添加了这些就为页面流提供了一个机会，使其可以提供自己的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; }} 字串8
　　在这个页面流中有两个动作：跳转到page1.faces的begin动作和跳转到page2.faces的goPage2动作。将goPage2作为一个方法动作（而不是简单动作）的原因是稍后将会对其进行扩充。

　　在构造页面的时候，应当以.jsp为扩展名创建page1和page2；JSF servlet处理每个.faces请求，并最终跳转到相关的JSP。所以，跳转到page1.faces最终将显示page1.jsp，如下：


　　从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。

　　后台Bean
　　Page Flow框架可以管理与JSF页面相关的后台bean（backing bean）。该类是放置与页面相关的事件处理程序和状态的方便场所。可以把它看作是集中放置与页面交互时所运行的所有代码的单一场所。当点击一个JSF页面时，Page Flow会判断是否有具有同样名称和包的类，例如，page /example/page1.faces的example.page1类。如果存在这样的类，并且它用@Jpf.FacesBacking进行注释并扩展了FacesBackingBean，它就会创建该类的一个实例。当离开JSF页面而转到一个动作或者其它任何页面时，后台bean会被销毁。后台bean与JSF页面共存亡。 字串3

　　绑定到后台bean中的属性
　　下面是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绑定上下文来绑定到这个属性：

　　

　　上面的例子显示了someProperty（最终在后台bean上调用getSomeProperty()）的值。类似地，设置这个值：

　　

　　注意，在这个例子中，后台bean中没有出现事件处理程序或组件引用。这就缩短了代码；后台bean是放置页面所有的处理程序和组件引用的好地方。 字串9