Spring Web Flow —— 配置 - 001

1. 本文基于Spring Web Flow 2.4.5，其它版本配置方式可能略有不同，请参考相应版本的官方文档

Maven依赖

maven库查询推荐地址：http://mvnrepository.com/

<dependency>
    <groupId>org.springframework.webflow</groupId>
    <artifactId>spring-webflow</artifactId>
    <version>2.4.5.RELEASE</version>
</dependency>

Web Flow嵌入到Spring MVC工作流简介

请求被DispatcherServlet拦截 -> 分发flow进行处理，返回view -> viewResolver解析 -> 返回请求

---

配置项预览

• FlowRegistry：必须，注册流程，指明流程配置文件所在位置；指定流程id(用于请求访问标识)；指定流程属性；此外还可以传入FlowBuilderServices进行更多个性化配置
• FlowBuilderServices：必须，用于设定流程配置文件中EL表达式的解析器、form属性绑定时的转换器、view-state的view解析器等，很重要
• FlowExecutor：必须，用于执行流程，可指定执行监听器(可选，常用于流程安全和持久化)
• FlowHandlerAdapter：必须，用于适配Spring MVC，配置时传入FlowExecutor
• FlowHandlerMapping：必须，用于将请求映射到对应的flow，配置时传入FlowRegistry

---

配置I - 注册流程 - FlowRegistry

FlowRegistry用于注册流程实例，指定流程位置和流程id，并可自定义流程创建相关内容

注册flow的各种方式

• 直接指定流程位置
  默认情况下，web-flow的id为其文件名减去后缀名，如下配置的id为booking。指定了基地址或使用了通配符时除外。

<webflow:flow-location path="/WEB-INF/flows/booking/booking.xml" />
// 注册了一个路径为/WEB-INF/flows/booking/booking.xml的流程，其余为默认配置。

• 自定义id

<webflow:flow-location path="/WEB-INF/flows/booking/booking.xml" id="bookHotel" />

• 定义流程属性
  如下定义了一个带有属性caption，其值为”Books a hotel”的流程。属性的使用方法暂时不了解

<webflow:flow-location path="/WEB-INF/flows/booking/booking.xml">
    <webflow:flow-definition-attributes>
        <webflow:attribute name="caption" value="Books a hotel" />
    </webflow:flow-definition-attributes>
</webflow:flow-location>

• 使用通配定义流程位置
  使用该方法并没有正确实验出id，这点作为参考

<webflow:flow-location-pattern value="/WEB-INF/flows/**/*-flow.xml" />

• 使用基地址
  使用基地址的flow的id为其path属性减去文件名，如下配置的id为/hotels/booking；如果path中没有路径信息，只有文件名，则id为文件名减去后缀。

<webflow:flow-registry id="flowRegistry" base-path="/WEB-INF">
    <webflow:flow-location path="/hotels/booking/booking.xml" />
</webflow:flow-registry>

flow id属性总结

1. id的作用
   id用于请求定位到某个确切的flow，如当请求路径为http://localhost:8090/Floyd/search-flow，其中Floyd是项目名，如果有id为search-flow的flow存在，则会访问该flow
2. id的定义
   
   • 没有基地址或通配符时，flow的id为文件名减去后缀，如<webflow:flow-location path="/WEB-INF/flows/booking/booking.xml" />这里的id为booking
   • 有基地址时，id为path的值减去文件名，如基地址为/WEB-INF， path=/flows/booking/booking.xml时，id被确定为flows/booking
   • 有通配符时，该情况比较特殊，按照官方说明并没有验证通过，这里略过。
     当显式指定了id属性时，则使用指定的id。推荐自定义id

FlowRegistry继承

FlowRegistry是可以继承的，可以定义一个公用的注册器，在多个子注册器中继承该注册器

<!-- my-system-config.xml -->
<webflow:flow-registry id="flowRegistry" parent="sharedFlowRegistry">
    <webflow:flow-location path="/WEB-INF/flows/booking/booking.xml" />
</webflow:flow-registry>

<!-- shared-config.xml -->
<webflow:flow-registry id="sharedFlowRegistry"