笔记40 Spring Web Flow——订单流程(构建订单)

二、订单子流程  

在识别完顾客之后,主流程的下一件事情就是确定他们想要什么类型 的披萨。订单子流程就是用于提示用户创建披萨并将其放入订单中 的,如下图所示。

  showOrder状态位于订单子流程的中心位置。这是用 户进入这个流程时看到的第一个状态,它也是用户在添加披萨到订单 后要转移到的状态。它展现了订单的当前状态并允许用户添加其他的 披萨到订单中。要添加披萨到订单时,流程会转移到createPizza状态。这是另外 一个视图状态,允许用户选择披萨的尺寸和面饼上面的配料。在这 里,用户可以添加或取消披萨,两种事件都会使流程转移回 showOrder状态。  从showOrder状态,用户可能提交订单也可能取消订单。两种选择 都会结束订单子流程,但是主流程会根据选择不同进入不同的执行路 径。

订单子流程定义,用于展示订单和添加披萨。

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <flow xmlns="http://www.springframework.org/schema/webflow"
 3   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4   xsi:schemaLocation="http://www.springframework.org/schema/webflow 
 5   http://www.springframework.org/schema/webflow/spring-webflow-2.0.xsd">
 6 
 7     <input name="order" required="true" />
 8     
 9     <!-- Order -->
10     <view-state id="showOrder">
11         <transition on="createPizza" to="createPizza" />
12         <transition on="checkout" to="orderCreated" />
13         <transition on="cancel" to="cancel" />
14     </view-state>
15 
16     <view-state id="createPizza" model="flowScope.pizza">
17         <on-entry>
18           <set name="flowScope.pizza" 
19               value="new com.springinaction.pizza.domain.Pizza()" />
20               
21           <evaluate result="viewScope.toppingsList" 
22               expression="T(com.springinaction.pizza.domain.Topping).asList()" />
23         </on-entry>
24         <transition on="addPizza" to="showOrder">
25           <evaluate expression="order.addPizza(flowScope.pizza)" />
26         </transition>
27         <transition on="cancel" to="showOrder" />
28     </view-state>
29 
30         
31     <!-- End state -->
32     <end-state id="cancel" />
33     <end-state id="orderCreated" />
34 </flow>

  这个子流程实际上会操作主流程创建的Order对象。因此,我们需要以某种方式将Order从主流程传到子流程。在这里,使用<input>元素来接收Order对象。如果你觉得这个流程与Java中的方法有 些类似地话,那这里使用的<input>元素实际上就定义了这个子流 程的签名。这个流程需要一个名为order的参数。 showOrder状态,它是一个基本的视图状态并 具有三个不同的转移,分别用于创建披萨、提交订单以及取消订单。 

  createPizza状态更有意思一些。它的视图是一个表单,这个表单 可以添加新的Pizza对象到订单中。<on-entry>元素添加了一个新 的Pizza对象到流程作用域内,当表单提交时,表单的内容会填充到 该对象中。需要注意的是,这个视图状态引用的model是流程作用域 内的同一个Pizza对象。Pizza对象将绑定到创建披萨的表单中,如 下所示。

通过将流程作用域的对象绑定到HTML表单,实现 添加披萨到订单中。

createPizza.jsp

 1 <%@ taglib prefix="form" uri="http://www.springframework.org/tags/form"%>
 2 <div>
 3 
 4     <h2>Create Pizza</h2>
 5     <form:form commandName="pizza">
 6         <input type="hidden" name="_flowExecutionKey"
 7             value="${flowExecutionKey}" />
 8 
 9         <b>Size: </b>
10         <br />
11         <form:radiobutton path="size" label="Small (12-inch)" value="SMALL" />
12         <br />
13         <form:radiobutton path="size" label="Medium (14-inch)" value="MEDIUM" />
14         <br />
15         <form:radiobutton path="size" label="Large (16-inch)" value="LARGE" />
16         <br />
17         <form:radiobutton path="size" label="Ginormous (20-inch)"
18             value="GINORMOUS" />
19         <br />
20         <br />
21 
22         <b>Toppings: </b>
23         <br />
24         <form:checkboxes path="toppings" items="${toppingsList}"
25             delimiter="<br/>" />
26         <br />
27         <br />
28 
29 
30         <input type="submit" class="button" name="_eventId_addPizza"
31             value="Continue" />
32         <input type="submit" class="button" name="_eventId_cancel"
33             value="Cancel" />
34     </form:form>
35 </div>

  当通过当通过Continue按钮提交订单时,尺寸和配料选择将会绑定 到Pizza对象中并且触发addPizza转移。与这个转移关联的 <evaluate>元素表明在转移到showOrder状态之前,流程作用域 内的Pizza对象将会传递给订单的addPizza()方法中。 

  有两种方法来结束这个流程。用户可以点击showOrder视图中的 Cancel按钮或者Checkout按钮。这两种操作都会使流程转移到一个 <end-state>。但是选择的结束状态id决定了退出这个流程时触发 事件,进而最终确定了主流程的下一步行为。主流程要么基于 cancel事件要么基于orderCreated事件进行状态转移。在前者情 况下,外边的主流程会结束;在后者情况下,它将转移 到takePayment子流程。

三、支付

  在披萨流程要结束的时候,最后的子流程提示用户输入他们的支付信息。这个简单 的流程如下图所示。

  支付子流程也使用<input>元素接收一 个Order对象作为输入。 

  进入支付子流程的时候,用户会到达takePayment状 态。这是一个视图状态,在这里用户可以选择使用信用卡、支票或现 金进行支付。提交支付信息后,将进入verifyPayment状态。这是 一个行为状态,它将校验支付信息是否可以接受。

  使用XML定义的支付流程如下所示,支付子流程有一个视图状态和一个行为状态。

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <flow xmlns="http://www.springframework.org/schema/webflow"
 3   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4   xsi:schemaLocation="http://www.springframework.org/schema/webflow 
 5   http://www.springframework.org/schema/webflow/spring-webflow-2.0.xsd">
 6 
 7     <input name="order" required="true"/>
 8     
 9     <view-state id="takePayment" model="flowScope.paymentDetails">
10         <on-entry>
11           <set name="flowScope.paymentDetails" 
12               value="new com.springinaction.pizza.domain.PaymentDetails()" />
13 
14           <evaluate result="viewScope.paymentTypeList" 
15               expression="T(com.springinaction.pizza.domain.PaymentType).asList()" />
16         </on-entry>
17         <transition on="paymentSubmitted" to="verifyPayment" />
18         <transition on="cancel" to="cancel" />
19     </view-state>
20 
21     <action-state id="verifyPayment">
22         <evaluate result="order.payment" expression=
23             "pizzaFlowActions.verifyPayment(flowScope.paymentDetails)" />
24         <transition to="paymentTaken" />
25     </action-state>
26             
27     <!-- End state -->
28     <end-state id="cancel" />
29     <end-state id="paymentTaken" />
30 </flow>

  在流程进入takePayment视图时,<on-entry>元素将构建一个支付表单并使用SpEL表达式在流程作用域内创建一 个PaymentDetails实例,这是支撑表单的对象。它也会创建视图 作用域的paymentTypeList变量,这个变量是一个列表包含了 PaymentType枚举(如下所示)的值。在这里,SpEL的 T()操作用于获得PaymentType类,这样就可以调用静态的 asList()方法。

 1 package com.springinaction.pizza.domain;
 2 
 3 import java.util.Arrays;
 4 import java.util.List;
 5 
 6 import org.apache.commons.lang3.text.WordUtils;
 7 
 8 public enum PaymentType {
 9   CASH, CHECK, CREDIT_CARD;
10   
11   public static List<PaymentType> asList() {
12     PaymentType[] all = PaymentType.values();
13     return Arrays.asList(all);
14   }
15   
16   @Override
17   public String toString() {
18     return WordUtils.capitalizeFully(name().replace('_', ' '));
19   }
20 }

  在面对支付表单的时候,用户可能提交支付也可能会取消。根据做出的选择,支付子流程将以名为paymentTaken或cancel的<end-state>结束。就像其他的子流程一样,不论哪种<end-state>都 会结束子流程并将控制交给主流程。但是所采用<end-state>的id 将决定主流程中接下来的转移。

猜你喜欢

转载自www.cnblogs.com/lyj-gyq/p/9107481.html