8.3.3 构建订单

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

你可以看到,showOrder 状态位于订单子流程的中心位置。这是用户进入这个流程时看到的第一个状态,它也是用户在添加披萨到订单后要转移到的状态。它展现了订单的当前状态并允许用户添加其他的披萨到订单中。

要添加披萨到订单时,流程会转移到 createPizza 状态。这是另外一个视图状态,允许用户选择披萨的尺寸和面饼上面的配料。在这里,用户可以添加或取消披萨,两种事件都会使流程转移回 showOrder 状态。

从 showOrder 状态,用户可能提交订单也可能取消订单。两种选择都会结束订单子流程,但是主流程会根据选择不同进入不同的执行路径。

如下显示了如何将图中所阐述的内容转变成 Spring Web Flow 定义。

程序清单 8.8 订单子流程的视图状态,用于展示订单和添加披萨
<?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 从主流程传到子流程。你可能还记得在程序清单 8.1 中我们使用了 <input> 元素来将 Order 传递进流程。在这里,我们使用它来接收 Order 对象。如果你觉得这个流程与Java中的方法有 些类似地话,那这里使用的 <input> 元素实际上就定义了这个子流程的签名。这个流程需要一个名为 order 的参数。

接下来,我们会看到 showOrder 状态,它是一个基本的视图状态并具有三个不同的转移,分别用于创建披萨、提交订单以及取消订单。

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

<%@ 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 子流程,这也是接下来我们要看的。

Last updated