Spring Web Flow实例教程
目錄：
1.參考文獻
參考1：http://www.ibm.com/developerworks/cn/education/java/j-spring-webflow/section3.html
參考2：http://lib.iteye.com/blog/299142
示例代碼：http://dl.dbank.com/c0n9qasa5r
2.購物車用例
要了解 Spring Web Flow 是什么東西，最好的辦法莫過于查看示例，一個簡化的購物車的流程如下圖所示：
上圖 所示流程用 Spring Web Flow 2.0 的配置文件表示如下清單 1：
清單 1 用 Spring Web Flow 語義表達購物車流程
……<flow>
<view-state id="viewCart">
<transition on="submit" to="viewOrder"/>
</view-state>
<view-state id="viewOrder">
<transition on="confirm" to="viewConfirmed"/>
</view-state>
<view-state id="viewConfirmed">
<transition on="returnToIndex" to="returnToIndex"/>
</view-state>
<end-state id="returnToIndex"/>
</flow>
配置1中省略了許多技術細節，展示的只是一個業務的流程，主要是為了讓大家對 Spring Web Flow 的語義有個初始的印象。從配置 1 中，應注意到一個很重要的特征—— Spring Web Flow 語義與 Servlet API 無關。更確切地講， Spring Web Flow 語義關注的是業務的流程，并未與 Sun 公司的 Web 規范緊密結合，這種描述是更高層次的抽象，差不多是在建模的角度來描述業務流程。
不過， Spring Web Flow 也并非只有抽象，現在還沒有哪一種工具或語言可以將一個模型直接轉換成相應的應用程序。 Spring Web Flow 更像是抽象建模和技術細節的混血兒，相比于湮沒在繁多的控制器和視圖中的 Web MVC 應用來講， Spring Web Flow 提供了如清單 1 所描述的更高層次的抽象，但同時它也整合了像 Unified EL 這樣的工具來控制技術上的細節。
Spring Web Flow 的基本元素
Flow 可看作是客戶端與服務器的一次對話（ conversation ）。 Flow 的完成要由分多個步驟來實現，在 Spring Web Flow 的語義中，步驟指的就是 state 。Spring Web Flow 提供了五種 state ，分別是 Action State 、 View State 、 Subflow State 、 Decision State 、 End State ，這些 state 可用于定義 flow 執行過程中的各個步驟。除了 End State 外，其他 state 都可以轉換到別的 state ，一般通過在 state 中定義 transition 來實現到其他 state 的轉換，轉換的發生一般由事件（ event ）來觸發。
3.什么情況下可以使用 Spring Web Flow？
前面講了， Spring Web Flow 提供了描述業務流程的抽象能力，但對一種 Web 開發技術而言，僅有這些是不夠的。同時， Spring Web Flow 是不是能夠取代其他 Web MVC 技術？或者在任何情況下都應優先使用 Spring Web Flow ？要回答這些問題，先來看一下 Spring Web Flow 所著力解決的技術問題。
3.1.Web 應用程序的三種范圍
Java Servlet 規范為 Web 應用程序中用到的各種對象規定了三種范圍（ scope ），分別是 request 范圍、 session 范圍和 application 范圍。
現實開發中最令人頭痛的莫過于 session 范圍， Java Servlet 規范指明可在 web.xml 中按如下方式配置 session 的有效時間為100分鐘，如下清單 2所示：
清單 2 web.xml 中 session 的配置
<session-timeout>100</session-timeout>
</session-config>
然而，現實中的 session 范圍更像是“雞肋”，把大量數據放入 session 會導致嚴重的效率問題，在分布式的環境中處理 session 范圍更是一不小心就會出錯，但拋棄 session 又會給開發帶來許多不便。 request 范圍雖說能存放量大的數據，但有效范圍有限。擺在開發者面前的很多用例都要求一種比 request 范圍要長，但又比 session 范圍要短的這么一種有效范圍。
3.2.Spring Web Flow 的解決方案
針對 Java Servlet 規范中的這個缺陷， Spring Web Flow 2.0 中提供了以下兩種范圍：
subflow 定義：被其他 flow 所調用的 flow 即可稱為 subflow。
由于 flow 是由開發人員自己定義的，可根據業務的需求自由改變， flow 范圍和 conversation 范圍的使用也就突破了 Java Servlet 規范中 session 范圍和 request 范圍的局限，真正做到了自由定制。
3.3.并非所有情形都適用 Spring Web Flow
可以看出， Spring Web Flow 所著力解決的問題即是客戶端與服務器的對話（ conversation ）問題，這個范圍比 request 要長，而比 session 要短。為實現 conversation 范圍（即 flow 范圍），需要付出效率上的代價，因此，并非所有 Web 應用都適合使用 Spring Web Flow 。 Seth Ladd 等人所著 Expert Spring MVC and Web Flow 一書，對何時使用Spring Web Flow，列出了如下表格。
表 1 何時使用 Spring Web Flow| 解決方案 | 何時使用 |
| Spring MVC Controller | 某個單獨的、只需較少業務邏輯就可創建的頁面，同時該頁面不是 flow 的一部分 |
| Spring MVC SimpleFormController | 某個只涉及表單提交的頁面，如一個搜索框 |
| Spring MVC AbstractWizardFormController | 由一系列導航頁面組成的業務過程 |
| Spring Web Flow | 任何比較復雜的、有狀態的、需要在多個頁面之間跳轉的業務過程 |
3.4.Spring Web Flow 的其他特點
Web Flow 作為一個單獨的概念被提出來，也可算是 Spring Web Flow 的一大亮點。目前大多數 Web MVC 框架都把重點把在各種 controller 和形形色色的 view 技術上面，對 Web 應用流程本身的關注是不夠的， Web Flow 的提出就提供了一層抽象，設計者就可以從 Web Flow 抽象層面來進行設計、開發。當然，?Web Flow 不能理解為只是 Web 頁面間的跳轉流程，定義 Spring Web Flow 的語義并非只限于頁面之間的跳轉，而可以是 Web 應用中的各種行為。由此，用例的模型建構好以后，就可直接從該模型轉換到相應的 Web Flow，開發人員的設計變得更加直觀、有效。
另外，在 Spring Web Flow 中重用 Web Flow 是比較容易的。在定義 flow 、 state 時可通過繼承某個已有的 flow 或 state ，來避免重復定義。同時，一個 flow 可以調用其它 flow ，就跟一般程序語言中在某個函數內部調用其它函數一樣方便。
4.配置 Spring Web MVC
Spring Web Flow 2.0 就是 Spring Web MVC 的一個擴展，如果粗略一些來講，所謂 flow 就相當于 Spring Web MVC 中一種特殊的 controller ，這種 controller 可通過 XML 文件加以配置，因此在使用 Spring Web Flow 2.0 前須先對 Spring Web MVC進行配置，步驟如下：4.1.聲明 DispatcherServlet 并指定配置文件
為使用 Spring Web MVC ，須在 web.xml 中聲明 DispatcherServlet ，見清單 3?：
清單 3 聲明 DispatcherServlet 和指定配置文件 <servlet><servlet-name>CartServlet</servlet-name>
<servlet-class>
org.springframework.web.servlet.DispatcherServlet
</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>
/WEB-INF/config/web-application-config.xml
</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
4.2.添加 DispatcherServlet 映射
要讓 DispatcherServlet 處理所有以 /spring/ 開頭的請求，見清單4?：
清單 4 web.xml 中的 DispatcherServlet映射 <servlet-mapping><servlet-name>CartServlet</servlet-name>
<url-pattern>/spring/*</url-pattern>
</servlet-mapping>
4.3.創建 web-application-config.xml
開發基于 Spring Web Flow 的應用往往會有大量的配置，這些配置全放在一個文件中是不合適的。本示例參考?Spring Web Flow 2.0 自帶示例（可以找找看），將不同功能的配置文件分開。其中?web-application-config.xml 用于配置與 Web 應用全局相關的內容，?Spring Web MVC 的相關配置放在 webmvc-config.xml 中，教程后面要添加的?Spring Web Flow 的配置則放在 webflow-config.xml 中。在 web-application-config.xml 中用 import 元素導入其他的配置文件。 web-application-config.xml的內容見清單 5：
清單 5 web-application-config.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:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-2.5.xsd">
<!-- 搜索 samples.webflow 包里的 @Component 注解，并將其部署到容器中 -->
<context:component-scan base-package="samples.webflow" />
<!-- 啟用基于注解的配置 -->
<context:annotation-config />
<import resource="webmvc-config.xml"/>
</beans> 注意：xml文件內容最好頂行頂格寫，不然可能會出現一些錯誤。
加入注解功能是出于最后運行 Web Flow 示例的需要（后面使用到的時候會指明），在這里只要知道注解功能已被啟用就可以了。
4.4.創建 webmvc-config.xml
webmvc-config.xml 主要用于配置 Spring Web MVC 。所要做的就是添加一個?viewResolver （視圖解析器），用于將視圖名解析成真實的視圖資源。另外，再配置好URL 請求的 handler （處理器），用于將 URL 請求定向到某個控制器，在本例中，用到的是 UrlFilenameViewController。
清單 6 webmvc-config.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"
xsi:schemaLocation="
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd">
<bean id="viewResolver"
class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="viewClass"
value="org.springframework.web.servlet.view.JstlView"/>
<property name="prefix" value="/WEB-INF/jsp/"/>
<property name="suffix" value=".jsp"/>
</bean>
<bean id="viewMappings"
class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
<property name="defaultHandler">
<!-- UrlFilenameViewController 會將 "/index" 這樣的請求映射成名為 "index" 的視圖 -->
<bean class="org.springframework.web.servlet.mvc.UrlFilenameViewController" />
</property>
</bean>
</beans>
4.5.創建 index.jsp
現在的 index.jsp 只是顯示一行文字。
清單 7 index.jsp
<?xml version="1.0" encoding="utf-8" ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Cart Application</title>
</head>
<body>
<h1>Hello!</h1>
</body>
</html>
4.6.運行應用程序
將應用程序發布到 Tomcat 容器，再通過 http://localhost:8080/CartApp/spring/index.jsp 訪問 index.jsp 頁面（應用程序所在文件夾名是 CartApp ），測試 Spring Web MVC 配置是否正確。如果一切正常，可得到如下頁面：?
4.7.示例代碼
CartApp2示例代碼下載地址：http://www.dbank.com/download/CartApp2.rar?f=c0n9qasa5r&i=2&h=1321056539&v=7a3a7609
?
5.0.配置 Spring Web Flow 2.0 的基礎
配置好 Spring Web MVC 的環境后，接下來就可以往里面加入 Spring Web Flow 2.0 的配置。不過，要搞明白 Spring Web Flow 2.0 的配置，必須先要了解相關的理論知識。5.1.FlowRegistry
FlowRegistry 是存放 flow 的倉庫，每個定義 flow 的 XML 文檔被解析后，都會被分配一個唯一的 id ，并以 FlowDefinition 對象的形式存放在 FlowResigtry 中。 FlowRegistry 配置方式可參看清單 8。
清單 8 FlowRegistry 的配置
<webflow:flow-registry id="flowRegistry"><webflow:flow-location path="/WEB-INF/flows/shopping.xml" id=”shopping”/>
</webflow:flow-registry>
說明：以下的示例清單中的 XML 配置元素默認使用了 webflow 名字空間，這也是 Spring Web Flow 習慣上的名字空間，參看教程后面 webflow-config.xml 文件，可以更多了解 webflow 名字空間。
每個 flow 都必須要有 id 來標識，如果在配置中省略，那么該 flow 默認的 id 將是該定義文件（xml文件）的文件名去掉后綴所得的字符串（例如本例中如果去掉id="shopping"，那么flow的id就是shopping.xml去掉后綴名.xml后的shopping作為id）。
5.2.FlowExecutor
FlowExecutor 是 Spring Web Flow 的一個核心接口，啟動某個 flow ，都要通過這個接口來進行。從配置角度來說，只要保證有個 FlowExecutor 就可以了， Spring Web Flow 的默認行為已經足夠。默認配置參看清單9。清單 9 FlowExecutor 的配置
<webflow:flow-executor id="flowExecutor" />5.3.哪個 flow 被執行了？
FlowRegistry 中注冊的 flow 可能會有多個，但前面介紹過，每個 flow 都會有 id ，沒有配置的，也會有個默認值，?FlowExecutor 就是通過 id 來找出要執行的 flow?。至于這個 id ，則是要由用戶來指定的。在默認配置情況下，如果客戶端發送了如下URL請求：http://localhost:8080/CartApp/spring/shopping。則從 Spring Web Flow 的角度來看，這個 URL 就表示客戶想要執行一個 id 為“ shopping ”的 flow?，于是就會在 FlowRegistry 中查找名為“ shopping ”的 flow，由FlowExecutor負責執行。
5.4Spring Web Flow 如何與 Spring Web MVC 整合在一起？
客戶端發送的請求，先會由 servlet 容器（本教程示例中即為 Tomcat ）接收， servlet 容器會找到相應的應用程序（本教程中即為 CartApp ），再根據 web.xml 的配置找到出符合映射條件的 servlet 來處理。?Spring Web MVC 中處理請求的 servlet 是 DispatcherServlet ，如果請求的路徑滿足 DispatcherServlet 的映射條件，則 DispatcherServlet 會找出 Spring IoC 容器中所有的 HandlerMapping ，根據這些 HandlerMapping 中匹配最好的 handler （一般情況下都是 controller ，即控制器）來處理請求。當 Controller 處理完畢，一般都會返回一個 view （視圖）的名字，DispatcherServlet再根據這個view的名字找到相應的視圖資源返回給客戶端。
搞清楚 Spring Web MVC 處理請求的流程后，基本上就可以明白要整合 Spring Web MVC 與 Spring Web Flow 所需要的配置了。為了讓客戶端的請求變成執行某個 flow 的請求，要解決以下幾個問題：
5.5.FlowHandler 和 FlowController
現在，需要一種接收執行 flow 的請求，然后根據請求來啟動相應 flow的handler （處理器）， Spring Web Flow 2.0 提供了兩種方案可供選擇。第一種方案是自己編寫實現了 FlowHandler 接口的類，讓這個類來實現這個功能。第二種方案是使用一個現成的叫做 FlowController 的控制器。第一種方案靈活性比較大，在許多場合可能也是唯一的選擇，但對每個 flow 都需要編寫相應的 FlowHandler 。本教程的示例采用第二種方案，對 FlowHandler 的介紹可參看 Spring Web Flow 2.0 自帶的文檔。 FlowController 其實是個適配器，一般來講，我們只要明白 FlowController 可根據客戶端請求的結尾部分，找出相應的 flow 來執行。配置 FlowController只需指定FlowExecutor即可，具體配置見清單10：
清單 10 FlowController 的配置 <bean id="flowController" class="org.springframework.webflow.mvc.servlet.FlowController"><property name="flowExecutor" ref="flowExecutor"/>
</bean>
另外還需在 HandlerMapping 中指明 /shopping.do 請求由 flowController 來處理，配置見清單11：
清單 11 在 viewMappings 中添加配置 <bean id="viewMappings"class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
<!-- /shopping.do 請求由 flowController 來處理 -->
<property name="mappings">
<value> /shopping.do=flowController </value>
</property>
<span style="white-space:pre"> </span>......
</bean> 需要指出的是，不管設成 /shopping.do 還是設成 /shopping ，或者 /shopping.htm ，效果都是一樣的， flowController 都會去找 id 為 shopping的flow來執行。
5.6.FlowBuilder Services
清單 8?所示 FlowRegistry 的配置，其中省略了 flow-registry 元素中一項比較重要的屬性， flow-builder-services 。 flow-builder-services 屬性的配置指明了在這個 flow-registry “倉庫”里的 flow 的一些基本特性，例如，是用 Unified EL 還是 OGNL 、 model （模型）對象中的數據在顯示之前是否需要先作轉換，等等。在本示例中，我們需要在 flow-builder-services 屬性中指明 Spring Web Flow 中所用到的 view ，由 Spring Web MVC 的“ View Resolver ”來查找，由 Spring Web MVC 的“ View Class”來解析，最后呈現給客戶。具體配置參看清單12：
清單 12 flow-builder-services 配置 <!--Web Flow 中的視圖通過 MVC 框架的視圖技術來呈現 --><webflow:flow-builder-services id="flowBuilderServices" view-factory-creator="mvcViewFactoryCreator" />
<!-- 指明 MVC 框架的 view resolver ，用于通過 view 名查找資源 -->
<bean id="mvcViewFactoryCreator" class="org.springframework.webflow.mvc.builder.MvcViewFactoryCreator">
<property name="viewResolvers" ref="viewResolver" />
</bean>
5.7.Spring Web Flow 2.0 配置小結
所有這些配置的目的無非是兩個：一是要讓客戶端的請求轉變成 flow 的執行，二是要讓 flow 執行過程中、或執行結束后得到的視圖能返還給客戶端。如果對這里的講解還不是很清楚，可先看下一節實際的配置，再回過頭來看本章內容，以加深理解。6.在購物車示例應用中配置 Spring Web Flow
實現示例應用的購物車流程，可按以下步驟操作：6.1.在 /WEB-INF/lib 目錄下導入相關類庫
將以下幾個 jar 包導入 /WEB-INF/lib 目錄：- org.springframework.webflow-2.0.2.RELEASE.jar
- org.springframework.js-2.0.2.RELEASE.jar
- org.springframework.binding-2.0.2.RELEASE.jar
- jboss-el.jar
6.2.在 webmvc-config.xml 中添加配置
Spring Web MVC 相關的配置前面已經分析過了，完整的配置見清單 13?：
清單 13 webmvc-config.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"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd">
<bean id="viewResolver"
class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="viewClass"
value="org.springframework.web.servlet.view.JstlView">
</property>
<property name="prefix" value="/WEB-INF/jsp/">
</property>
<property name="suffix" value=".jsp">
</property>
</bean>
<bean id="viewMappings"
class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
<!-- /shopping.do 請求由 flowController 來處理 -->
<property name="mappings">
<value> /shopping.do=flowController </value>
</property>
<property name="defaultHandler">
<!-- UrlFilenameViewController 會將 "/index" 這樣的請求映射成名為 "index" 的視圖 -->
<bean class="org.springframework.web.servlet.mvc.UrlFilenameViewController" />
</property>
</bean>
<bean id="flowController" class="org.springframework.webflow.mvc.servlet.FlowController">
<property name="flowExecutor" ref="flowExecutor" />
</bean>
</beans>
6.3.添加配置文件 webflow-config.xml
在 /WEB-INF/config 目錄下添加 webflow-config.xml 文件， schema 名字空間可直接復制清單 14?中的內容。
清單 14webflow-config.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:webflow="http://www.springframework.org/schema/webflow-config"
xsi:schemaLocation=" http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
http://www.springframework.org/schema/webflow-config
http://www.springframework.org/schema/webflow-config/spring-webflow-config-2.0.xsd">
<webflow:flow-executor id="flowExecutor" />
<!-- 所有 flow的定義文件它的位置在這里進行配置， flow-builder-services 用于配置 flow 的特性 -->
<webflow:flow-registry id="flowRegistry" flow-builder-services="flowBuilderServices">
<webflow:flow-location path="/WEB-INF/flows/shopping.xml" id="shopping" />
<webflow:flow-location path="/WEB-INF/flows/addToCart.xml" id="addToCart" />
</webflow:flow-registry>
<!--Web Flow 中的視圖通過 MVC 框架的視圖技術來呈現 -->
<webflow:flow-builder-services id="flowBuilderServices" view-factory-creator="mvcViewFactoryCreator" />
<!-- 指明 MVC 框架的 view resolver ，用于通過 view 名查找資源 -->
<bean id="mvcViewFactoryCreator" class="org.springframework.webflow.mvc.builder.MvcViewFactoryCreator">
<property name="viewResolvers" ref="viewResolver" />
</bean>
</beans>
webflow-config.xml 創建完成以后，不要忘記在 web-application-config.xml 中添加 import 元素，將 webflow-config.xml 文件導入。
清單 15 在 web-application-config.xml 中導入 webflow-config.xml <import resource="webflow-config.xml"/>6.4.添加 flow 定義文件 shopping.xml
在 /WEB-INF/flows 目錄下創建 shopping.xml 文件，描述了圖 2 所示的流程。
清單 16 shopping.xml <?xml version="1.0" encoding="UTF-8"?><flow xmlns="http://www.springframework.org/schema/webflow"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/webflow
http://www.springframework.org/schema/webflow/spring-webflow-2.0.xsd">
<!-- view-state中的view對應jsp文件夾中的jsp頁面，on是觸發事件，to對應state id -->
<view-state id="viewCart" view="viewCart">
<transition on="submit" to="viewOrder">
</transition>
</view-state>
<view-state id="viewOrder" view="viewOrder">
<transition on="confirm" to="orderConfirmed">
</transition>
</view-state>
<view-state id="orderConfirmed" view="orderConfirmed">
<transition on="returnToIndex" to="returnToIndex">
</transition>
</view-state>
<end-state id="returnToIndex" view="externalRedirect:servletRelative:/index.jsp">
</end-state>
</flow>
與清單 1 相比，在 view-state 元素中指定了 view 屬性的名字，這個名字也是 Spring Web MVC 中 viewResolver （在webmvc-config.xml中定義）所查找的 view 的名字。從清單 16 的配置中可以知道，這三個 view-state 元素所對應的視圖資源分別應該是： viewCart.jsp 、 viewOrder.jsp 和 orderConfirmed.jsp 。清單 16 中最后的 end-state 指明了當 flow 執行結束后跳轉到初始的 index.jsp 頁面，在此處的 view 屬性的名字需要解釋一下。?externalRedirect 用在 view 名字中，表示所指向的資源是在 flow 的外部， servletRelative 則表明所指向資源的路徑起始部分與 flow 所在 servlet 相同。 Spring Web Flow 2.0還提供了其他幾個關鍵詞用于重定向，這里就不多介紹了。
在webmvc-config.xml中定義的viewResolver如下所示：
<bean id="viewResolver"class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="viewClass"
value="org.springframework.web.servlet.view.JstlView">
</property>
<property name="prefix" value="/WEB-INF/jsp/">
</property>
<property name="suffix" value=".jsp">
</property>
</bean>
這表示所有view-state中的view屬性同名對應到了/WEB-INF/jsp目錄下的.jsp文件。
6.5.添加三個 jsp 頁面
在 /WEB-INF/jsp 目錄下創建三個 flow 所需的視圖資源。以下清單中只有viewCart.jsp給出完整的代碼，其他兩個只給出 jsp 頁面中 body 元素以內的代碼，其余省略。清單 17 viewCart.jsp
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>View Cart</title>
</head>
<body>
<h1>View Cart</h1>
<a href="${flowExecutionUrl}&_eventId=submit">Submit</a>
</body>
</html> 清單 18 viewOrder.jsp <h1>Order</h1>
<a href="${flowExecutionUrl}&_eventId=confirm">Confirm</a> 清單 19 orderConfirmed.jsp
<h1>Order Confirmed</h1>
<a href="${flowExecutionUrl}&_eventId=returnToIndex">Return to index</a>
這幾個頁面都使用了變量 flowExecutionUrl ，表示 flow 執行到當前狀態時的 URL 。?flowExecutionUrl 的值已經由 Spring Web Flow 2.0 框架的代碼進行賦值，并放入相應的 model 中供 view 訪問。 flowExecutionUrl 的值包含 flow 在執行過程中會為每一狀態生成的唯一的 key ，因此不可用其他手段來獲取。請求參數中 _eventId 的值與清單 16 中 transition 元素的 on 屬性的值是對應的，在接收到_eventId參數后，相應transition會被執行。
6.6.修改 index.jsp 頁面
在 index.jsp 頁面中添加啟動 flow 的鏈接，從 webmvc-config.xml 配置文件中可以看出，要啟動 flow ，只需提供 /shopping.do 鏈接即可。清單 20 index.jsp <h1>Hello!</h1><br/>
<a href="shopping.do">View Cart</a>
6.7.運行應用程序
將應用程序發布到 Tomcat 服務器，訪問 index.jsp ，并啟動 flow ，測試頁面的跳轉。效果如圖 5所示：
圖 4 flow 運行效果————————————————————————————————————————————————————
6.8示例程序源代碼
CartApp3源代碼下載地址：http://www.dbank.com/download/CartApp3.rar?f=c0n9qasa5r&i=1&h=1321062828&v=60993861
7.用 Unified EL 實現業務邏輯
到現在為止，這個購物車應用只是實現了頁面之間的跳轉，接下來我們要實現與業務邏輯相關的功能。由于本教程的重點在于介紹如何應用 Spring Web Flow ，所實現的業務比較簡單，與實際應用有較大的距離，請讀者諒解。業務的邏輯涉及到數據的獲取、傳遞、保存，相關的業務功能函數的調用等內容，這些功能的實現都可用 Java 代碼來完成，但定義 Spring Web Flow 的語法與 Java 是無關的，這就要求 Spring Web Flow 提供與 Java 代碼的整合機制。要了解這種機制，關鍵在于搞清楚兩個問題：
- 業務邏輯代碼在什么時候被調用？
- 業務邏輯代碼在調用后得到的數據如何保存、傳遞？
7.1.業務邏輯代碼在什么時候被調用？
在 Spring Web Flow 中，業務邏輯代碼的執行可由以下三種情形來觸發：- 客戶端請求中包含了 _eventId 參數
- 執行到框架自定義的切入點
- 執行到 <action-state> 元素
7.1.1客戶端請求中包含了 _eventId 參數
這種方式一般用在 state 之間的 transition ，通過指定 _eventId 參數的值，表明了客戶的行為，從而導致相應事件的發生，在 Spring Web Flow 的定義文件中可以通過 evaluate 元素來指定要處理的業務邏輯。參看清單21：
清單 21 transition 示例 <transition on="submit"><evaluate expression="validator.validate()" />
</transition>
清單 21 的代碼表示，當客戶端的請求中包含“ _eventId=submit ”，則 evaluate 元素中 expression 屬性所指明的表達式會被執行，即 validator 對象的validate 方法會得到調用。
7.1.2執行到框架自定義的切入點
Spring Web Flow 定義了 5 個切入點，通過 flow 定義文件的配置，可在這 5 個切入點插入相關業務邏輯代碼。
表 2 Spring Web Flow 自定義的切入點
| 切入點名稱 | XML 元素名稱 | 觸發時刻 |
| flow start | on-start | flow 執行之前 |
| state entry | on-entry | 進入某個 state 之后，做其他事情之前 |
| view render | on-render | 在進入 view 的 render 流程之后，在 view 真正 render出來之前 |
| state exit | on-exit | 在退出 state 之前 |
| flow end | on-end | flow 執行結束之后 |
清單 22 on-render 元素 <view-state id="viewCart" view="viewCart" >
<on-render>
<evaluate expression="productService.getProducts()" result="viewScope.products"/>
</on-render>
</view-state>
7.1.3執行到 <action-state> 元素
Spring Web Flow 中的這個 <action-state> 是專為執行業務邏輯而設的 state?。如果某個應用的業務邏輯代碼即不適合放在 transition 中由客戶端來觸發，也不適合放在 Spring Web Flow 自定義的切入點，那么就可以考慮添加 <action-state> 元素專用于該業務邏輯的執行。示例代碼參看清單23：
清單 23 action-state 示例<action-state id="addToCart">
<evaluate expression="cart.addItem(productService.getProduct(productId))"/>
<transition to="productAdded"/>
</action-state>
7.2.業務邏輯代碼在調用后得到的數據如何保存、傳遞？
Spring Web Flow 的定義中可直接使用表達式語言（ Expression Language ），前面的代碼都是用的 Unified EL ，對于習慣用 OGNL 的開發人員，可通過 flow-builder-services 的配置改成使用 OGNL 。不管是哪一種表達式語言， Spring Web Flow 都提供了一些固定名稱的變量，用于數據的保存、傳遞。在 Spring Web Flow 的解決方案 一節中，已經提到 Spring Web Flow 所著力解決的問題即是數據存取范圍的問題，為此， Spring Web Flow 提供了兩種比較重要的范圍，一是 flow 范圍，另一個是 conversation 范圍。通過 flowScope 和 conversationScope 這兩個變量， Spring Web Flow 提供了在這兩種范圍里存取數據的方法。清單 24演示了如何將業務邏輯代碼執行的結果存放到flow范圍中。
清單 24 flowScope 示例<evaluate expression="productService.getProducts()" result="flowScope.products" />
注意：Spring Web Flow 2.0 在默認配置下，flowScope 和 conversationScope 的實現依賴于 Java 序列化和反序列化技術，因此存放于 flowScope 或 conversationScope 中的對象需要實現 java.io.Serializable 接口。
Spring Web Flow 還提供了大量其他的變量，以方便數據的存取。如 viewScope 范圍即是從進入 view-state 至退出 view-state 結束， requestScope 即和一般的 request 范圍沒什么區別，等等。另外還有一些用于獲取 flow 以外數據的變量，如 requestParameters 、 messageContext 等等。具體變量的列表可參看 Spring Web Flow自帶的文檔。為示例應用添加商品
接下來，我們要在示例應用的 viewCart.jsp 頁面中添加商品，可按以下步驟操作：添加 ProductService 類
ProductService 主要提供商品列表，并能根據商品的 id 查找出該商品，由于示例較簡單，這里只添加了三條紀錄。見清單 26：清單 26 ProductService 類
package samples.webflow;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import org.springframework.stereotype.Service;
@Service("productService")
public class ProductService {
private Map<Integer, Product> products = new HashMap<Integer, Product>();
public ProductService() {
products.put(1, new Product(1, "Bulldog", 1000));
products.put(2, new Product(2, "Chihuahua", 1500));
products.put(3, new Product(3, "Labrador", 2000));
}
public List<Product> getProducts() {
return new ArrayList<Product>(products.values());
}
public Product getProduct(int productId) {
return products.get(productId);
}
}
Service 注解表示 Spring IoC 容器會初始化一個名為 productService 的 Bean ，這個 Bean 可在 Spring Web Flow 的定義中直接訪問。（這也是為什么在web-application-config.xml中添加注解的原因）
修改 shopping.xml 文件
要在 viewCart 頁面中顯示商品，只需在 view-state 元素的 on-render 切入點調用 productService 的 getProducts 方法，并將所得結果保存到 viewScope 中即可。見清單27：清單 27 shopping.xml 需修改的部分
<!-- view-state中的view對應jsp文件夾中的jsp頁面，on是觸發事件，to對應state id -->
<view-state id="viewCart" view="viewCart">
<on-render>
<!-- 要在 viewCart 頁面中顯示商品，只需在 view-state 元素的 on-render 切入點調用 productService 的
getProducts 方法，并將所得結果保存到 viewScope 中即可 -->
<evaluate expression="productService.getProducts()" result="viewScope.products" />
</on-render>
<transition on="submit" to="viewOrder">
</transition>
</view-state>
修改 viewCart.jsp 頁面
清單 27 表明 productService 的 getProducts 方法所得的結果會存放在 viewScope 中名為 products 的變量中， jsp 頁面的代碼可直接訪問該變量。見清單 28：
清單 28 修改后的 viewCart.jsp 頁面<?xml version="1.0" encoding="utf-8" ?>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>View Cart</title>
</head>
<body>
<h1>View Cart</h1>
<a href="${flowExecutionUrl}&_eventId=submit">Submit</a>
<h2>Products for Your Choice</h2>
<table>
<c:forEach var="product" items="${products}">
<tr>
<td>${product.description}</td>
<td>${product.price}</td>
</tr>
</c:forEach>
</table>
</body>
</html>
7.3.運行應用程序
圖 5 viewCart.jsp 頁面效果——————————————————————————————————————————
7.4.示例代碼
CartApp4示例代碼下載地址：http://www.dbank.com/download/CartApp4.rar?f=c0n9qasa5r&i=3&h=1321064658&v=11ec87d68.用 subflow 實現添加商品到購物車功能
商品已經有列表了，接下來就要增加把商品放入購物車的功能，在本示例中用 subflow 來實現這一功能，操作步驟如下：8.1.實現 Cart 和 CartItem 兩個業務類
CartItem 表示存放于購物車中的條目，主要記錄相應商品及商品數量，同時不要忘記實現 java.io.Serializable 接口，見清單 29：清單 29 CartItem 類
package samples.webflow;
import java.io.Serializable;
//購物車中的條目
public class CartItem implements Serializable {
private static final long serialVersionUID = 8388627124326126637L;
private Product product;//商品
private int quantity;//數量
public CartItem(Product product, int quantity) {
this.product = product;
this.quantity = quantity;
}
//計算該條目的總價格
public int getTotalPrice() {
return this.quantity * this.product.getPrice();
}
//增加商品的數量
public void increaseQuantity() {
this.quantity++;
}
/**
* Return property product
*/
public Product getProduct() {
return product;
}
/**
* Sets property product
*/
public void setProduct(Product product) {
this.product = product;
}
/**
* Return property quantity
*/
public int getQuantity() {
return quantity;
}
/**
* Sets property quantity
*/
public void setQuantity(int quantity) {
this.quantity = quantity;
}
}
除去相應的屬性外， CartItem 可根據商品的數量算出該商品的總價格（ getTotalPrice ），也可通過 increaseQuantity 增加商品數量。
Cart 是購物車的實現類，其同樣要實現 java.io.Serializable 接口，但它沒有像 ProductService 一樣成為由 Spring IoC 容器管理的 Bean ，每個客戶的購物車是不同的，因此不能使用 Spring IoC 容器默認的 Singleton 模式。見清單 30：
package samples.webflow;
import java.io.Serializable;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
//購物車的實現類
public class Cart implements Serializable {
private static final long serialVersionUID = 7901330827203016310L;
private Map<Integer, CartItem> map = new HashMap<Integer, CartItem>();
//getItems 用于獲取當前購物車里的物品
public List<CartItem> getItems() {
return new ArrayList<CartItem>(map.values());
}
//addItem 用于向購物車添加商品
public void addItem(Product product) {
int id = product.getId();
CartItem item = map.get(id);
if (item != null)
item.increaseQuantity();
else
map.put(id, new CartItem(product, 1));
}
//getTotalPrice 用于獲取購物車里所有商品的總價格
public int getTotalPrice() {
int total = 0;
for (CartItem item : map.values())
total += item.getProduct().getPrice() * item.getQuantity();
return total;
}
} Cart 主要實現三個業務函數， getItems 用于獲取當前購物車里的物品， addItem 用于向購物車添加商品， getTotalPrice 用于獲取購物車里所有商品的總價格。
8.2.在 shopping.xml 中添加配置
在 shopping flow 開始時必須分配一個 Cart 對象，由于要調用 subflow ，這個 Cart 對象應存放于 conversationScope 中。同時要添加一個 subflow-state 用于執行添加商品到購物車的任務。清單 31 shopping.xml 中添加的配置 <var name="mycart" class="samples.webflow.Cart" />
<on-start>
<set name="conversationScope.cart" value="mycart"></set>
</on-start>
<!-- view-state中的view對應jsp文件夾中的jsp頁面，on是觸發事件，to對應state id -->
<view-state id="viewCart" view="viewCart">
<on-render>
<!-- 要在 viewCart 頁面中顯示商品，只需在 view-state 元素的 on-render 切入點調用 productService
的 getProducts 方法，并將所得結果保存到 viewScope 中即可 -->
<evaluate expression="productService.getProducts()" result="viewScope.products" />
</on-render>
<transition on="submit" to="viewOrder" />
<transition on="addToCart" to="addProductToCart" />
</view-state>
<subflow-state id="addProductToCart" subflow="addToCart">
<transition on="productAdded" to="viewCart" />
</subflow-state>
8.3.在 /WEB-INF/flows 目錄下添加 addToCart.xml
清單 31 中 subflow-state 元素的 subflow 屬性即指明了這個被調用的 flow 的 id 為“ addToCart ”，現在就要添加addToCart flow的定義。
清單 32 addToCart.xml<?xml version="1.0" encoding="UTF-8"?>
<flow xmlns="http://www.springframework.org/schema/webflow"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/webflow
http://www.springframework.org/schema/webflow/spring-webflow-2.0.xsd">
<on-start>
<set name="requestScope.productId" value="requestParameters.productId" />
</on-start>
<action-state id="addToCart">
<evaluate expression="cart.addItem(productService.getProduct(productId))" />
<transition to="productAdded" />
</action-state>
<end-state id="productAdded" />
</flow>
addToCart flow 主要由一個 action-state 構成，完成添加商品到購物車的功能， addToCart flow 的實現需要有輸入參數，即 productId 。在本示例中是通過請求參數來傳遞，通過 requestParameters 來獲取該數值。這里還要注意到清單 32 中的 end-state 的 id 為“ productAdded ”，與清單 31 中 subflow-state 中的 transition元素的on屬性的名稱是對應的。
8.4.在 webflow-config.xml 中添加 addToCart.xml 的位置
新增加的 flow 不要忘記在 flow-registry 中注冊。
清單 33 flow-registry 中注冊 addToCart<webflow:flow-registry id="flowRegistry" flow-builder-services="flowBuilderServices">
<webflow:flow-location path="/WEB-INF/flows/shopping.xml" id="shopping"/>
<webflow:flow-location path="/WEB-INF/flows/addToCart.xml" id="addToCart"/>
</webflow:flow-registry>
8.5.修改 viewCart.jsp 頁面
最后就可以來看在視圖中如何顯示相關的信息，并觸發相應的 webflow 事件，見清單 34：
清單 34 完整的 viewCart.jsp 的代碼<?xml version="1.0" encoding="utf-8" ?>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>View Cart</title>
</head>
<body>
<h1>View Cart</h1>
<h2>Items in Your Cart</h2>
<c:choose>
<c:when test="${empty cart.items}">
<p>Your cart is empty.</p>
</c:when>
<c:otherwise>
<table border="1" cellspacing="0">
<tr>
<th>Item</th>
<th>Quantity</th>
<th>Unit Price</th>
<th>Total</th>
</tr>
<c:forEach var="item" items="${cart.items}">
<tr>
<td>${item.product.description}</td>
<td>${item.quantity}</td>
<td>${item.product.price}</td>
<td>${item.totalPrice}</td>
</tr>
</c:forEach>
<tr>
<td>TOTAL:</td>
<td></td>
<td></td>
<td>${cart.totalPrice}</td>
</tr>
</table>
</c:otherwise>
</c:choose>
<a href="${flowExecutionUrl}&_eventId=submit">Submit</a>
<h2>Products for Your Choice</h2>
<table>
<c:forEach var="product" items="${products}">
<tr>
<td>${product.description}</td>
<td>${product.price}</td>
<td><a
href="${flowExecutionUrl}&_eventId=addToCart&productId=${product.id}">[add
to cart]</a></td>
</tr>
</c:forEach>
</table>
</body>
</html>
8.5.運行效果
圖 6 添加購物車后的效果8.6代碼實例
CartApp5代碼實例下載地址：http://www.dbank.com/download/CartApp5.rar?f=c0n9qasa5r&i=4&h=1321064658&v=7aab5c3a9.global transition 簡介
顧名思義， global transition 是一種全局的 transition ，可在 flow 執行的各個 state 中被觸發。
清單 35 global-transitons<global-transitions>
<transition on="cancelShopping" to="returnToIndex"/>
</global-transitions> 客戶端請求中如果包含 _eventId=cancelShopping ，則會重新回到 index.jsp 頁面。
轉載于:https://www.cnblogs.com/zhanghaiyang/p/7213566.html
總結
以上是生活随笔為你收集整理的Spring Web Flow实例教程的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： libreoffice
- 下一篇： SFTP例子2----使用JSch实现S