spring 中配置 WebFlow

現(xiàn)在，還不支持在Java中配置Spring Web Flow暖途，所以我們別無(wú)選擇弓柱，只能在XML中對(duì)其進(jìn)行配置。有一些bean會(huì)使用Spring Web Flow的
Spring配置文件命名空間來(lái)進(jìn)行聲明宣决。因此蘸劈，我們需要在上下文定義XML文件中添加這個(gè)命名空間聲明：

<?xml version="1.0" encoding="UTF-8"?>
<bens 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/[CA]spring-webflow-config-2.3.xsd
   http://www.springframework.org/schema/beans
   http://www.springframework.org/schema/beans/spring-beans.xsd">

裝配流程執(zhí)行器

流程執(zhí)行器（flow executor）驅(qū)動(dòng)流程的執(zhí)行昏苏。當(dāng)用戶進(jìn)入一個(gè)流程時(shí)尊沸，流程執(zhí)行器會(huì)為用戶創(chuàng)建并啟動(dòng)一個(gè)流程執(zhí)行
實(shí)例。當(dāng)流程暫停的時(shí)候（如為用戶展示視圖時(shí)）贤惯，流程執(zhí)行器會(huì)在用戶執(zhí)行操作后恢復(fù)流程洼专。
在Spring中，<flow:flow-executor>元素會(huì)創(chuàng)建一個(gè)流程執(zhí)行器：

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

配置流程注冊(cè)表

流程注冊(cè)表（flow registry）的工作是加載流程定義并讓流程執(zhí)行器能夠使用它們孵构。我們可以在Spring中使用<flow:flow-registry>
配置流程注冊(cè)表屁商，如下所示：

<flow:flow-registry id="flowRegistry" base-path="/WEB-INF/flows">
    <flow:flow-location-pattern value="*-flow.xml"/>
</flow:flow-registry>

在這里的聲明中，流程注冊(cè)表會(huì)在“/WEB-INF/flows”目錄下查找流程定義颈墅，這是通過(guò)base-path屬性指明的蜡镶。依據(jù)<flow:flowlocation-
pattern>元素的值，任何文件名以“-flow.xml”結(jié)尾的XML文件都將視為流程定義恤筛。

作為另一種方式官还，我們可以去除base-path屬性，而顯式聲明流程
定義文件的位置：

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

如果你希望更顯式地指定流程ID毒坛，那你可以通過(guò)<flow:flowlocation>元素的id屬性來(lái)進(jìn)行設(shè)置望伦。例如林说，要將pizza作為流程
ID，可以像這樣配置：

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

處理流程請(qǐng)求

是對(duì)于流程而言屯伞，我們需要一個(gè)FlowHandlerMapping來(lái)幫助DispatcherServlet將流程請(qǐng)求發(fā)送給Spring Web Flow腿箩。
在Spring應(yīng)用上下文中，F(xiàn)lowHandlerMapping的配置如下：

<bean class= "org.springframework.webflow.mvc.servlet.FlowHandlerMapping">
  <property name="flowRegistry" ref="flowRegistry"/>
</bean>

Spring Web Flow上劣摇，響應(yīng)請(qǐng)求的是FlowHandlerAdapter珠移。FlowHandlerAdapter等同于Spring
MVC的控制器，它會(huì)響應(yīng)發(fā)送的流程請(qǐng)求并對(duì)其進(jìn)行處理末融。FlowHandlerAdapter可以像下面這樣裝配成一個(gè)Spring
bean剑梳，如下所示：

<bean class="org.springframework.webflow.mvc.servlet.FlowHandlerAdapter">
  <property name="flowExecutor" ref="flowExecutor"/>
</bean>

這個(gè)處理適配器是DispatcherServlet和Spring Web Flow之間的橋梁。它會(huì)處理流程請(qǐng)求并管理基于這些請(qǐng)求的流程滑潘。在這里垢乙，它裝
配了流程執(zhí)行器的引用，而后者是為所處理的請(qǐng)求執(zhí)行流程的语卤。

流程的組件

流程是由三個(gè)主要元素定義的：狀態(tài)追逮、轉(zhuǎn)移和流程數(shù)據(jù)。狀態(tài)（State）是流程中事件發(fā)生的地點(diǎn)粹舵。如果你將流程想
象成公路旅行钮孵，那狀態(tài)就是路途上的城鎮(zhèn)、路邊飯店以及風(fēng)景點(diǎn)眼滤。流程中的狀態(tài)是業(yè)務(wù)邏輯執(zhí)行巴席、做出決策或?qū)㈨?yè)面展現(xiàn)給用戶的地方，
而不是在公路旅行中買Doritos薯片和健怡可樂(lè)的所在诅需。如果流程狀態(tài)就像公路旅行中停下來(lái)的地點(diǎn)漾唉，那轉(zhuǎn)移（transition）就
是連接這些點(diǎn)的公路。在流程中堰塌，你通過(guò)轉(zhuǎn)移的方式從一個(gè)狀態(tài)到另一個(gè)狀態(tài)赵刑。

當(dāng)你在城鎮(zhèn)之間旅行的時(shí)候，你可能要買一些紀(jì)念品场刑，留下一些記憶并在路上取一些空的零食袋般此。類似地，在流程處理中牵现，它要收集一些
數(shù)據(jù)：流程的當(dāng)前狀況铐懊。我很想將其稱為流程的狀態(tài)，但是在我們討論流程的時(shí)候狀態(tài)（state）已經(jīng)有了另外的含義瞎疼。

狀態(tài)

image.png

視圖狀態(tài)

在流程定義的XML文件中科乎，<view-state>用于定義視圖狀態(tài)：

<view-state id="welcome"/>

如果你愿意顯式指定另外一個(gè)視圖名，那可以使用view屬性做到這
一點(diǎn)：

<view-state id="welcome" view="greeting"/>

如果流程為用戶展現(xiàn)了一個(gè)表單丑慎，你可能希望指明表單所綁定的對(duì)
象喜喂。為了做到這一點(diǎn)瓤摧，可以設(shè)置model屬性：

<view-state id="takePayment" view="flowScope.paymentDetails"/>

行為狀態(tài)

在流程定義XML中，行為狀態(tài)使用<action-state>元素來(lái)聲明玉吁。

<action-state id="saveOrder">
  <evaluate expression="pizzaFlowActions.saveOrder(order)"/>
  <transition to="thankYou"/>
</action-state>

盡管不是嚴(yán)格需要的照弥，但是<action-state>元素一般都會(huì)有一個(gè)<evaluate>作為子元素。<evaluate>元素給出了行為狀態(tài)要做的事情进副。expression屬性指定了進(jìn)入這個(gè)狀態(tài)時(shí)要評(píng)估的表達(dá)式这揣。在本示例中，給出的expression是SpEL表達(dá)式影斑，它表明將會(huì)找到ID為pizzaFlowActions的bean并調(diào)用其saveOrder()方法给赞。

決策狀態(tài)

決策狀態(tài)能夠在流程執(zhí)行時(shí)產(chǎn)生兩個(gè)分支。決策狀態(tài)將評(píng)估一個(gè)Boolean類型的表達(dá)式矫户，然后在兩個(gè)狀態(tài)轉(zhuǎn)移中選擇一個(gè)片迅，這要取決于表達(dá)式會(huì)計(jì)算出true還是false。在XML流程定義中皆辽，決策狀態(tài)通過(guò)<decision-state>元素進(jìn)行定義柑蛇。典型的決策狀態(tài)示例如下所示：

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

你可以看到，<decision-state>并不是獨(dú)立完成工作的驱闷。<if>元素是決策狀態(tài)的核心耻台。這是表達(dá)式進(jìn)行評(píng)估的地方，如果表達(dá)式結(jié)果為true空另，流程將轉(zhuǎn)移到then屬性指定的狀態(tài)中盆耽，如果結(jié)果為false，流程將會(huì)轉(zhuǎn)移到else屬性指定的狀態(tài)中扼菠。

子流程狀態(tài)

將流程分成獨(dú)立的部分是個(gè)不錯(cuò)的主意摄杂。<subflow-state>允許在一個(gè)正在執(zhí)行的流程中調(diào)用另一個(gè)流程。這類似于在一個(gè)方法中調(diào)用另一個(gè)方法娇豫。

<subflow-state id="order" subflow="pizza/order">
  <input name="order" value="order"/>
  <transition on="orderCreated" to="payment"/>
</subflow-state>

在這里匙姜，<input>元素用于傳遞訂單對(duì)象作為子流程的輸入畅厢。如果子流程結(jié)束的<end-state>狀態(tài)ID為orderCreated冯痢，那么流程將會(huì)轉(zhuǎn)移到名為payment的狀態(tài)。

結(jié)束狀態(tài)

最后框杜，所有的流程都要結(jié)束浦楣。這就是當(dāng)流程轉(zhuǎn)移到結(jié)束狀態(tài)時(shí)所做的。<end-state>元素指定了流程的結(jié)束咪辱，它一般會(huì)是這樣聲明的：

<end-state id="customerReady">

當(dāng)?shù)竭_(dá)<end-state>狀態(tài)振劳，流程會(huì)結(jié)束。接下來(lái)會(huì)發(fā)生什么取決于
幾個(gè)因素：

• 如果結(jié)束的流程是一個(gè)子流程油狂，那調(diào)用它的流程將會(huì)從<subflow-state>處繼續(xù)執(zhí)行历恐。<end-state>的ID將會(huì)用作事件觸發(fā)從<subflow-state>開(kāi)始的轉(zhuǎn)移寸癌。
• 如果<end-state>設(shè)置了view屬性，指定的視圖將會(huì)被渲染弱贼。視圖可以是相對(duì)于流程路徑的視圖模板蒸苇，如果添加“externalRedirect:”前綴的話，將會(huì)重定向到流程外部的頁(yè)面吮旅，如果添加“flowRedirect:”將重定向到另一個(gè)流程中溪烤。
• 如果結(jié)束的流程不是子流程，也沒(méi)有指定view屬性庇勃，那這個(gè)流程只是會(huì)結(jié)束而已檬嘀。瀏覽器最后將會(huì)加載流程的基本URL地址，當(dāng)前已沒(méi)有活動(dòng)的流程责嚷，所以會(huì)開(kāi)始一個(gè)新的流程實(shí)例鸳兽。

轉(zhuǎn)移

轉(zhuǎn)移使用<transition>元素來(lái)進(jìn)行定義，它會(huì)作為各種狀態(tài)元素（<action-state>罕拂、<view-state>贸铜、<subflow-state>）的子元素。最簡(jiǎn)單的形式就是<transition>元素在流程中指定下一個(gè)狀態(tài)：

<transition to="customerReady"/>

更常見(jiàn)的轉(zhuǎn)移定義是基于事件的觸發(fā)來(lái)進(jìn)行的聂受。在視圖狀態(tài)蒿秦，事件通常會(huì)是用戶采取的動(dòng)作。在行為狀態(tài)蛋济，事件是評(píng)估表達(dá)式得到的結(jié)果棍鳖。而在子流程狀態(tài)，事件取決于子流程結(jié)束狀態(tài)的ID碗旅。在任意的事件中（這里沒(méi)有任何歧義）渡处，你可以使用on屬性來(lái)指定觸發(fā)轉(zhuǎn)移的事件：

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

在拋出異常時(shí)，流程也可以進(jìn)入另一個(gè)狀態(tài)祟辟。例如医瘫，如果顧客的記錄沒(méi)有找到，你可能希望流程轉(zhuǎn)移到一個(gè)展現(xiàn)注冊(cè)表單的視圖狀態(tài)旧困。以下的代碼片段顯示了這種類型的轉(zhuǎn)移：

<transiton on-exception= "com.springinaction.pizza.service.CustomerNotFoundException" to="registrationForm"/>

全局轉(zhuǎn)移

在創(chuàng)建完流程之后醇份，你可能會(huì)發(fā)現(xiàn)有一些狀態(tài)使用了一些通用的轉(zhuǎn)移。例如吼具，如果在整個(gè)流程中到處都有如下<transition>的話僚纷，我一點(diǎn)也不感覺(jué)意外：

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

與其在多個(gè)狀態(tài)中都重復(fù)通用的轉(zhuǎn)移，我們可以將<transition>元素作為<global-transitions>的子元素拗盒，把它們定義為全局轉(zhuǎn)移怖竭。例如：

<global-transitions>
  <transition on="cancel" to="endState"/>
</global-transitions>

定義完這個(gè)全局轉(zhuǎn)移后，流程中的所有狀態(tài)都會(huì)默認(rèn)擁有這個(gè)cancel轉(zhuǎn)移陡蝇。

流程數(shù)據(jù)

聲明變量

流程數(shù)據(jù)保存在變量中痊臭，而變量可以在流程的各個(gè)地方進(jìn)行引用哮肚。它能夠以多種方式創(chuàng)建。在流程中創(chuàng)建變量的最簡(jiǎn)單形式是使用<var>元素：

<var name="customer" class="com.springinaction.pizza.domain.Customer"/>

作為行為狀態(tài)的一部分或者作為視圖狀態(tài)的入口广匙，你有可能會(huì)使用<evaluate>元素來(lái)創(chuàng)建變量绽左。例如：

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

在本例中，<evaluate>元素計(jì)算了一個(gè)表達(dá)式（SpEL表達(dá)式）并將結(jié)果放到了名為toppingsList的變量中艇潭，這個(gè)變量是視圖作用域的拼窥。

類似地，<set>元素也可以設(shè)置變量的值：

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