笔记40 Spring Web Flow——订单流程（构建订单）

二、订单子流程　　

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

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

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

<?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">

    <input name="order" required="true" />
    
    <!-- Order -->
    <view-state id="showOrder">
        <transition on="createPizza" to="createPizza" />
        <transition on="checkout" to="orderCreated" />
        <transition on="cancel" to="cancel" />
    </view-state>

    <view-state id="createPizza" model="flowScope.pizza">
        <on-entry>
          <set name="flowScope.pizza" 
              value="new com.springinaction.pizza.domain.Pizza()" />
              
          <evaluate result="viewScope.toppingsList" 
              expression="T(com.springinaction.pizza.domain.Topping).asList()" />
        </on-entry>
        <transition on="addPizza" to="showOrder">
          <evaluate expression="order.addPizza(flowScope.pizza)" />
        </transition>
        <transition on="cancel" to="showOrder" />
    </view-state>

        
    <!-- End state -->
    <end-state id="cancel" />
    <end-state id="orderCreated" />
</flow>

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

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

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

createPizza.jsp

<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form"%>
<div>

    <h2>Create Pizza</h2>
    <form:form commandName="pizza">
        <input type="hidden" name="_flowExecutionKey"
            value="${flowExecutionKey}" />

        <b>Size: </b>
        <br />
        <form:radiobutton path="size" label="Small (12-inch)" value="SMALL" />
        <br />
        <form:radiobutton path="size" label="Medium (14-inch)" value="MEDIUM" />
        <br />
        <form:radiobutton path="size" label="Large (16-inch)" value="LARGE" />
        <br />
        <form:radiobutton path="size" label="Ginormous (20-inch)"
            value="GINORMOUS" />
        <br />
        <br />

        <b>Toppings: </b>
        <br />
        <form:checkboxes path="toppings" items="${toppingsList}"
            delimiter="<br/>" />
        <br />
        <br />


        <input type="submit" class="button" name="_eventId_addPizza"
            value="Continue" />
        <input type="submit" class="button" name="_eventId_cancel"
            value="Cancel" />
    </form:form>
</div>

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

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

三、支付

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

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

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

　　使用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">

    <input name="order" required="true"/>
    
    <view-state id="takePayment" model="flowScope.paymentDetails">
        <on-entry>
          <set name="flowScope.paymentDetails" 
              value="new com.springinaction.pizza.domain.PaymentDetails()" />

          <evaluate result="viewScope.paymentTypeList" 
              expression="T(com.springinaction.pizza.domain.PaymentType).asList()" />
        </on-entry>
        <transition on="paymentSubmitted" to="verifyPayment" />
        <transition on="cancel" to="cancel" />
    </view-state>

    <action-state id="verifyPayment">
        <evaluate result="order.payment" expression=
            "pizzaFlowActions.verifyPayment(flowScope.paymentDetails)" />
        <transition to="paymentTaken" />
    </action-state>
            
    <!-- End state -->
    <end-state id="cancel" />
    <end-state id="paymentTaken" />
</flow>

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

package com.springinaction.pizza.domain;

import java.util.Arrays;
import java.util.List;

import org.apache.commons.lang3.text.WordUtils;

public enum PaymentType {
  CASH, CHECK, CREDIT_CARD;
  
  public static List<PaymentType> asList() {
    PaymentType[] all = PaymentType.values();
    return Arrays.asList(all);
  }
  
  @Override
  public String toString() {
    return WordUtils.capitalizeFully(name().replace('_', ' '));
  }
}

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