Microsoft Word - Spring Web Flow 1应用程序升级指南-1.doc

Size: px

Start display at page:

Download "Microsoft Word - Spring Web Flow 1应用程序升级指南-1.doc"

休任
5 years ago
Views:

1 1.2 流定义语言 1 升级到 Spring Web Flow 介绍本章说明如何将 Spring Web Flow 1(SWF 1) 应用程序升级到 Spring Web Flow 2(SWF 2) 1.2 流定义语言 Spring Web Flow 1 和 2 的流定义语言的核心概念没有变不过, 部分元素和属性名有一些改变这么做是为了让该语言更简洁更有表现力 1.5 节中有完整的变更映射的目录流定义升级工具 Spring Web Flow 2 中提供了一个自动化的工具, 能协助将 1.x 的流转换为 2.x 的风格如果需要, 该工具能将所有旧的标签名称转换成相应的新名称虽然该工具尽力去做转换, 但并不能将版本 1 中所有的概念都一对一地映射到版本 2 对于不能转换的部分, 该工具会在结果流中标记上 WARNING 的注释该转换工具需要 spring-webflow.jar spring-core.jar 以及一个 XSLT 1.0 引擎, 推荐使用 Saxon 可以通过如下的命令行运行此工具必要的库文件需包含在 classpath 中要转换的源流文件只能是单个流转换的结果流将被发送到标准输出上 java org.springframework.webflow.upgrade.webflowupgrader flow-to-upgrade.xml

2 2 升级到 Spring Web Flow 2 1. 流定义升级工具的一些警告信息不再支持参数 parameter-type 不建议使用 Bean 动作, 推荐基于使用 EL 的求值表达式 EL 表达式能够直接接受方法参数, 所以参数标签不再需要这种变化的负面作用是调用动作之前, 方法参数必须是正确的类型不再支持 inline-flow 不再支持内联流内联流中的内容必须移至新的顶层流中内联流中的内容已经为你转换好不再支持映射 target-collection 输出映射不能再添加项到集合中只支持赋值不再支持 Bean 属性 var 不再需要 Bean 属性 var 所有的 Spring Bean 都可以通过 EL 解析不再支持 var 作用域元素 var 将所有的变量放到流作用域中以前对话作用域是允许的 2.EL 表达式在流定义语言中使用了很多 EL 表达式大部分看上去像普通文本的属性实际上都作为 EL 被解释标准的 EL 分隔符 (${} 或者 #{}) 不再需要了, 而且如果包含了它们通常会产生异常升级工具会在必要的地方删除 EL 分隔符 1.3 Spring Web Flow 配置在 Spring Web Flow 1 中, 配置 Web 流有两个选择, 一是使用标准的 Spring Bean 的 XML,

3 1.3 Spring Web Flow 配置 3 另一个是使用 webflow-config-1.0 Schema Schema 配置选项隐藏较长的内部类名并开启上下文自动完成功能, 从而简化配置过程在 Spring Web Flow 2 中,Schema 配置选项是唯一可用的配置方式 Spring Web Flow Bean 配置 Spring Web Flow 1 中使用的 FactoryBean Bean XML 配置方法在 Spring Web Flow 2 中不能使用, 而用 Schema 配置方法替代它尤其是应该更新定义 FlowExecutorFactoryBean 和 XmlFlowRegistryFactoryBean 的 Bean 详细信息请继续阅读下节内容 Spring Web Flow Schema 配置 Spring Web Flow 1 和 2 中的 webflow-config 配置 Schema 也有一点点的改变升级应用程序最简单的方法是将 Schema 的版本修改为 2.0, 然后修改所有出现的错误 ( 在 Schema 感知的 XML 编辑器中, 相应的错误会自动显示出来 ) 最常见的变化是在元素的开始部分追加由 Schema 定义的 flow- <beans xmlns=" xmlns:xsi=" xmlns:webflow=" xsi:schemalocation=" flow-executor 流执行者是核心的 Web Flow 配置元素该元素替代了原先的 FlowExecutor- FactoryBean Bean 定义 <webflow:flow-executor ="flowexecutor" /> 2.flow-execution-listeners 流执行监听器也定义在流执行者中监听器通过标准 Bean 定义来定义并通过引用添加给

4 4 升级到 Spring Web Flow 2 流执行者 <webflow:flow-executor ="flowexecutor" flow-registry="flowregistry"> <webflow:flow-execution-listeners> <webflow:listener ref="securityflowexecutionlistener"/> </webflow:flow-execution-listeners> </webflow:flow-executor> <bean ="securityflowexecutionlistener" class="org.springframework.webflow.security.securityflowexecutionlistener" /> 3.flow-registry flow-registry 包含一组 flow-location Web Flow 使用到的每一个流定义都必须添加到注册表中该元素替代了原先的 XmlFlowRegistryFactoryBean Bean 定义 <webflow:flow-registry ="flowregistry"> <webflow:flow-location path="/web-inf/hotels/booking/booking.xml" /> </webflow:flow-registry> 流控制器流控制器的包名已经改变, 原先是 org.springframework.webflow.executor.mvc. FlowController, 现在的 Servlet MVC 请求是 org.springframework.webflow.mvc. servlet.flowcontroller Portlet 流控制器 org.springframework.webflow.executor. mvc.portletflowcontroller 被流处理器适配器 org.springframework.webflow. mvc.portlet.flowhandleradapter 替代 Bean 定义中的这些内容需要更新流 URL 处理器 Spring Web Flow 2 中默认的 URL 处理器改变了流标识符取自 URL 中而不是显示地传递过去 Spring Web Flow 2 中提供了一个 WebFlow1FlowUrlHandler, 用于确保既存的视图和 URL 结构的兼容性 <bean ="/pos.htm" class="org.springframework.webflow.mvc.servlet.flowcontroller"> <property ="flowexecutor" ref="flowexecutor" />

5 1.3 Spring Web Flow 配置 5 <property ="flowurlhandler"> <bean class="org.springframework.webflow.context.servlet.webflow1flowurlhandler" /> </property> </bean> 视图解析 Spring Web Flow 2 默认既选择视图又呈现视图之前, 视图选择是由 Spring Web Flow 1 完成的, 而视图的呈现则是由外部的视图解析器来完成的版本 1 中的流要想在 Spring Web Flow 2 中正常工作, 需要覆盖默认的视图解析器最常见的用例是使用 Apache Tiles 用于视图解析下面的配置将使用 Tiles 视图解析器来取代默认的视图解析器本例中的 tilesviewresolver 可以替换为任意一个视图解析器 <webflow:flow-registry ="flowregistry" flow-builder-services="flowbuilderservices"> <web:flow-location path="..." />... </webflow:flow-registry> <webflow:flow-builder-services ="flowbuilderservices" view-factory-creator="viewfactorycreator"/> <bean ="viewfactorycreator" class="org.springframework.webflow.mvc.builder.mvcviewfactorycreator"> <property ="viewresolvers" ref="tilesviewresolver" /> </bean> <bean ="tilesviewresolver" class="org.springframework.web.servlet.view.urlbasedviewresolver"> <property ="viewclass" ="org.springframework.web.servlet.view.tiles.tilesjstlview" /> </bean> <bean class="org.springframework.web.servlet.view.tiles.tilesconfigurer"> <property ="definitions" ="/WEB-INF/tiles-def.xml" /> </bean>

6 6 升级到 Spring Web Flow Spring Web Flow 2 中的新概念自动模型绑定 Spring Web Flow 1 需要基于 Spring MVC 的流以手工调用 FormAction 方法, 即 setupform 和 bindandvalate 来处理表单视图 Spring Web Flow 2 使用 view-state 的 model 属性自动完成模型的设置和绑定 OGNL 对比 EL 在 Spring Web Flow 1 的流定义中只能使用 OGNL 表达式在 Web Flow 2 中, 又增加了对 Unified EL 的支持当 United EL 可用时, 将使用它, 当 United EL 不可用时, 将继续使用 OGNL 闪存作用域 Spring Web Flow 1 中的闪存作用域位于当前的请求及下一个请求中概念上这和 Spring Web Flow 2 中的视图作用域类似, 但语义上并不相同在 Spring Web Flow 2 中, 视图呈现完毕后, 闪存作用域就会被清空这么做是为了使 Web Flow 中的 flashscope 语义和其他 Web 框架保持一致 Spring Faces 在 Spring Web Flow 2 中, 它与 JavaServer Faces 的集成显著地增强了外部重定向在 Spring Web Flow 1 中, 总是认为外部重定向与上下文相关在 Spring Web Flow 2 中, 如果重定向的 URL 是以斜线开头的话, 它将被视为 Servlet 相关而不是上下文相关而没有斜线的 URL 仍然视为上下文相关的 1.5 Spring Web Flow 1 和 2 流定义语言的对应关系 Spring Web Flow 1 发布后, 流定义语言就发生了改变表 1-1 列出了 Spring Web Flow 1

7 1.5 Spring Web Flow 1 和 2 流定义语言的对应关系 7 中流定义语言的元素, 以及它和 Spring Web Flow 2 中相应元素的对应关系虽然多数变更都是语义上的, 但也有一些结构上的变化表 1-1 对应关系 SWF 1 SWF 2 备注 action * 使用 <evaluate /> bean * method * action-state action-state argument * 使用 <evaluate expression="func(arg1, arg2,...)"/> expression parameter-type attribute attribute type type attribute-mapper * 输入和输出元素可以直接位于流中或者子流中 bean * 现在 subflow-state 上的属性 subflowattribute-mapper bean-action * 使用 <evaluate /> bean * method * decision-state decision-state end-actions on-end end-state end-state view view * commit entry-actions on-entry evaluate-action evaluate expression expression 使用 <evaluate...> <attribute = "" ="..." /> </evaluate> * result * result-type evaluation-result * 使用 <evaluate result="..." /> scope * exception-handler exception-handler bean bean exit-actions on-exit flow flow * start-state * abstract

8 8 升级到 Spring Web Flow 2 SWF 1 SWF 2 备注 global-transitions global-transitions if if test test then then else else import bean-import resource resource inline-flow * 转化为新的顶层流 * input-attribute input scope * 前缀名, 作用域为 <input = "flowscope.foo" /> * type * input-mapper * 输入可直接位于流或者子流中 mapping input 或者 output ( 续 ) source 或者 flow 元素中为,subflow-state 元素中为 target 或者 flow 元素中为,subflow-state 元素中为 target-collection * 不再支持 from * 自动检测 to type method-argument * 使用 <evaluate expression="func (arg1, arg2,...)"/> method-result * 使用 <evaluate result="..." /> scope * output-attribute output scope * 前缀名, 作用域为 <output ="flowscope.foo" /> * type * output-mapper * 输出可以直接位于流和子流中 render-actions on-render set set attribute scope * 前缀名, 作用域为 <set ="flowscope.foo" /> 使用 <set...> <attribute ="" ="..." /> </set> * type start-actions on-start start-state * 现在为 <flow start-state="...">, 或者默认为流中第一个状态 ref * subflow-state subflow-state

9 1.5 Spring Web Flow 1 和 2 流定义语言的对应关系 9 SWF 1 SWF 2 备注 flow subflow * subflow-attribute-mapper transition transition on on on-exception on-exception to to * bind var var class class scope * 一直是流作用域 bean * 所有的 Spring bean 都可以用 EL 解析 view-state view-state view view * redirect * popup * model * history * persistence-context * render * fragments * secured * attributes * match ( 续 ) 版权声明 : 本文翻译自 Spring Web Flow Reference Gue, 网址为 spring-webflow/docs/2.0.x/reference/html/index.html, 供读者免费阅读和下载, 不能用于任何商业目的

本章学习目标小风 Java 实战系列教程 SpringMVC 简介 SpringMVC 的入门案例 SpringMVC 流程分析配置注解映射器和适配器注解的使用使用不同方式的跳转页面 1. SpringMVC 简介 Spring web mvc

本章学习目标小风 Java 实战系列教程 SpringMVC 简介 SpringMVC 的入门案例 SpringMVC 流程分析配置注解映射器和适配器注解的使用使用不同方式的跳转页面 1. SpringMVC 简介 Spring web mvc 本章学习目标 SpringMVC 简介 SpringMVC 的入门案例 SpringMVC 流程分析配置注解映射器和适配器配置视图解析器 @RequestMapping 注解的使用使用不同方式的跳转页面 1. SpringMVC 简介 Spring web mvc 和 Struts2 都属于表现层的框架, 它是 Spring 框架的一部分, 我们可以从 Spring 的整体结构中看得出来 :