集成JSF与BEEHIVE PAGE FLOW之一
JSF对通过关联组件和事件来构建页面而说是非常棒的，但是，与所有现有的技术一样，它需要一个控制器来分离出页面间的导航决策，并提供到业务层的链接。它拥有一个基本的导航处理程序，可以用功能完备的处理程序来替换它。Page Flow为创建可重用的封装页面流提供了基础，并可以与视图层并行工作。它是一个功能完备的导航处理程序，将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。
后台Bean
Page Flow框架可以管理与JSF页面相关的后台bean（backing bean）。该类是放置与页面相关的事件处理程序和状态的方便场所。可以把它看作是集中放置与页面交互时所运行的所有代码的单一场所。当点击一个JSF页面时，Page Flow会判断是否有具有同样名称和包的类，例如，page /example/page1.faces的example.page1类。如果存在这样的类，并且它用@Jpf.FacesBacking进行注释并扩展了FacesBackingBean，它就会创建该类的一个实例。当离开JSF页面而转到一个动作或者其它任何页面时，后台bean会被销毁。后台bean与JSF页面共存亡。
绑定到后台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.FacesBacking
public 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是放置页面所有的处理程序和组件引用的好地方。
从后台bean引发页面流动作
在上面的“基本集成”部分，我们直接从JSF组件引发页面流动作。通常情况下，只需这样即可；当单击一个按钮或者链接时，会运行一个动作并跳转到另一个页面上。如果想在调用控制器之前运行一些与页面相关的代码，或者如果希望页面可以在几个动作之间进行动态选择的话，可以在命令处理程序（JSF页面所运行的一个Java方法）中引发一个动作。下面是一个命令处理程序的例子，可以把它放到后台bean page2.java中（或者其它任何可公开访问的bean中）：
public String chooseNextPage()
{
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中页面流的最基本用处是引发（调用）来自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。
后台Bean
Page Flow框架可以管理与JSF页面相关的后台bean（backing bean）。该类是放置与页面相关的事件处理程序和状态的方便场所。可以把它看作是集中放置与页面交互时所运行的所有代码的单一场所。当点击一个JSF页面时，Page Flow会判断是否有具有同样名称和包的类，例如，page /example/page1.faces的example.page1类。如果存在这样的类，并且它用@Jpf.FacesBacking进行注释并扩展了FacesBackingBean，它就会创建该类的一个实例。当离开JSF页面而转到一个动作或者其它任何页面时，后台bean会被销毁。后台bean与JSF页面共存亡。
绑定到后台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.FacesBacking
public 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是放置页面所有的处理程序和组件引用的好地方。
从后台bean引发页面流动作
在上面的“基本集成”部分，我们直接从JSF组件引发页面流动作。通常情况下，只需这样即可；当单击一个按钮或者链接时，会运行一个动作并跳转到另一个页面上。如果想在调用控制器之前运行一些与页面相关的代码，或者如果希望页面可以在几个动作之间进行动态选择的话，可以在命令处理程序（JSF页面所运行的一个Java方法）中引发一个动作。下面是一个命令处理程序的例子，可以把它放到后台bean page2.java中（或者其它任何可公开访问的bean中）：
public String chooseNextPage()
{
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动作处理的能力.