Spring Web Flow

Spring Web Flow是一个Web框架，它适用于元素按规定流程运行的程序。Spring Web Flow是Spring MVC的扩展，它支持开发基于流程的应用程序。它将流程的定义与实现流程行为的类和视图分离开来。

Spring Web Flow是构建于Spring MVC基础之上的，这意味着所有的流程请求都需要先经过Spring MVC的DispatcherServlet。

目前还不支持在Java中配置Spring Web Flow，所以只能在xml中进行配置。

在上下文定义XML文件中添加命名空间声明

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:flow="http://www.springframework.org/schema/webflow-config"
       xsi:schemaLocation="http://www.springframework.org/schema/webflow-config
                              http://www.springframework.org/schema/webflow-config/spring-webflow-config-2.3.xsd
                              http://www.springframework.org/schema/beans
                              http://www.springframework.org/schema/beans/spring-beans.xsd ">
</beans>

流程控制器(flow executor)驱动流程的执行。当用户进入一个流程时，流程执行器会为用户创建并启动一个流程执行实例。当流程暂停的时候，流程执行器会在用户执行操作后恢复流程。流程执行器负责创建和执行流程，流程注册表负责加载流程定义。

创建流程执行器

<flow:flow-executor id="flowExecutor">

流程注册表(flow registry)的工作是加载流程定义并让流程执行器能够使用它们。可以在<flow:folw-registry>配置流程注册表

<!-- 流程注册表会在/WEB-INF/flows目录下查找流程定义  -->

<flow:flow-registry id="flowRegistry" base-path="/WEB-INF/flows">

　　<!-- flow-location-pattern元素: 所有的流程都是通过其ID来进行引用的,流程的ID是相对于base-path的路径或双星号所代表的路径 -->

　　<flow:flow-location-pattern value="*-flow.xml /">

　　<!-- flow-location直接指明了流程定义文件 -->

　　<flow:flow-location id="pizza" path="/WEB-INF/flows/springpizza.xml" />

</flow:flow-registry>

处理流程请求

　　需要一个FlowHandlerMapping来帮助DispatcherServlet将请求发送给Spring Web Flow。

<bean class="org.springframework.webflow.mvc.servlet.FlowHandlerMapping">

　　<property name="flowRegistry" ref="flowRegistry" />

</bean>

FlowHandlerMapping装配了流程注册表的引用，这样他就能知道如何将请求的URL匹配到流程上。然而，FlowHanlderMapping的工作仅仅是将流程请求定向到Spring Web Flow上，相应请求的是FlowHandlerAdapter。FlowHanlderAdapter等同于Spring MVC控制器，他会响应发送的流程请求并对其进行处理。FlowHanlderAdapter可以转配成一个Spring bean

<bean class="org.springframework.webflow.mvc.servlet.FlowHandlerAdapter">

　　<property name="flowExecutor" ref="flowExecutor" />

</bean>

处理适配器是DispatcherServlet和Spring Web Flow之间的桥梁。它会处理流程请求并管理基于这些请求的流程。

在Spring Web Flow中，流程是由三个主要元素定义的：状态、转移和流程数据。状态(State)是流程中时间发生的地点。流程中的状态是业务逻辑执行、做出决策或将页面展现给用户的地方。在流程中，通过转移的方式从一个状态到另一个状态。流程数据就是流程当前的状况。

Spring Web Flow定义了五种不同类型的状态。

行为(Action)　　　　行为状态是流程逻辑发生的地方

决策(Decision)　　   决策状态将流程分成两个方向，它会基于流程数据的评估结果确定流程方向

结束(End)　　　　　 结束状态是流程的最后一站。一旦进入End状态，流程就会终止

子流程(Subflow)　　子流程状态会在当前正在运行的流程上下文中启动一个新的流程

视图(View)　　　　  视图状态会暂停流程并邀请用户参与流程

视图状态

　　用于为用户展现信息并使用户在流程中发挥作用。实际的视图实现可以是Spring支持的任意视图类型。使用<view-state>标签来定义视图状态。

　　<view-state id="welcome" /> --- id有两个含义，一是指定这个视图的状态，而是说明要展现的逻辑视图名为welcome

　　<view-state id="takePayment" view="takePayment" model="flowScope.paymentDetais" /> --- 将视图中的表单绑定流程作用于内的paymentDetails对象

行为状态

　　视图状态会涉及到流程应用程序的用户，而行为状体则是应用程序自身在执行任务。行为状态一般会出发Spring所管理bean的一些方法并根据方法调用的执行结果转移到另一个状态。使用<action-state>元素来声明行为状态。

<action-state id="saveOrder">

　　<!--- evaluation给出了行为状态要做的事情，expression属性指定了进入这个状态时要评估的表达式，express是SpEL表达式，它会根据ID为pizzaFlowActions的bean并调用saveOrder()方法->

　　<evaluation expression="pizzaFlowActions.saveOrder(order)" />

　　<transition to="thankYou" />

</action-state>

决策状态

　　决策状态能够在流程执行时产生两个分支。决策状态将评估一个Boolean类型的表达式，然后再两个状态转移中选择一个。<decision-state>元素表示决策状态

<decision-state id="checkDiliveryArea">

　　<if test="pizzaFlowActions.checkDeliveryArea(custiomer.zipCode)"  then="addCustomer" else="deliveryWarning" />
</decision-state>

子流程图

　　子流程图允许在一个正在执行的流程中调用另一个流程。<subflow-state>元素表示子流程图。

<subflow-state id="order" subflow="pizza/order">

　　<!-- input元素用于传递订单对象作为子流程的输入，如果子流程结束的<end-state>状态ID为orderCreated，流程将会转移到名为payment的状态 -->

　　<input name="order" value="order" />

　　<transition on="orderCreated" to="payment" />

</subflow-state>

结束状态

　　<end-state>元素指定了流程的结束。

　　<end-state id="customerReady" />

　　当到达<end-state>状态时，可能会发生如下事情：　　

　　　　如果结束的流程是一个子流程，那调用他的流程将会从<subflow-state>处继续执行。<end-state>的ID将会用作时间出发从<subflow-state>开始的转移

　　　　如果<end-state>设置了view属性，指定的视图将会被渲染，视图可以是相对于流程路径的视图模板，如果添加了"externalRedirect:"前缀的话，将会重定向到流程外部的页面，若添加"flowRedirect:"将重定向到另一个流程中

　　　　如果结束的流程不是子流程，也没有指定view属性，那这个流程只是会结束而已。浏览器最后将会加载流程的基本URL地址，当前已没有的活动流程，所以会开始一个新的流程

转移

　　转移连接了流程中的状态。转移使用<transition>元素来进行定义，它会作为各种状态元素的子元素。

　　<!-- to指定了流程的下一个状态  -->

　　<transition to="customerReady" />

　　<!--  on属性来指定出发转移的事件  -->

　　<transition on="phoneEntered" to="lookupCustomer"  />

　　<!-- on-exception属性指定当发生异常时转移事件 -->

　　<transition on-exception="com.springinaction.piazz.service.CustomerNotFoundException" to="registerForm" />

全局转移

　　可以将<transition>元素作为<global-transitions>的子元素，把它们定义为全局转移

　　<global-transitions>

　　　　<transition on="cancel" to="endState" />

　　</global-transitions>

流程数据

　　声明变量

　　　　流程数据保存在变量中，而变量可以在流程的各个地方进行引用。<var>元素是创建变量的最简单形式

　　　　<var name="customer" class="com.springinaction.pizza.domain.Customer"／＞

　　　　作为行为状态的一部分或者作为视图状态的入口，可以使用<evluate>元素来创建变量。将变量设置为表达式计算的结果

　　　　<evaluate result="viewScope.toppingsList" expression="T{com.springinaction.pizza.domain.Topping}.asList()" />

　　　　<set name="flowScope.pizza" value="new com.springinaction.pizza.domain.Pizza()"  />

定义流程数据的作用域

　　流程中携带的数据会拥有不同的生命作用域和可见性，这取决于保存数据的变量本身的作用域。Spring Web Flow定义了物种不同的作用域

　　Conversation　　最高层级的流程开始时创建的，在最高层级的流程结束时销毁。被最高层级的流程和其所有的子流程所共享　　

　　Flow　　当流程开始时创建，在流程结束时销毁。只有在创建它的流程中是可见的

　　Request　　当一个请求进入流程时创建，在流程返回时销毁

　　Flash　　当流程开始时创建，在流程结束时销毁。在视图状态渲染后，他也会被清除

　　View　　当进入视图状态时创建，当这个状态退出时销毁。只在视图状态内是可见的

<var>元素声明变量时，变量始终是流程作用域的。当使用<set><evaluate>时，作用域通过name或result的前缀指定。

　　<set name="flowScope.theAnswer" value="42" />