8. 输入/输出映射

每个流都有一个定义明确的 input/output 协定。 流可以在开始时传递输入属性,也可以在结束时返回输出属性。 在这方面,调用流在概念上类似于调用具有以下签名的方法:spring-doc.cn

FlowOutcome flowId(Map<String, Object> inputAttributes);

其中 a 具有以下签名:FlowOutcomespring-doc.cn

public interface FlowOutcome {
   public String getName();
   public Map<String, Object> getOutputAttributes();
}

8.1. 输入

该元素声明一个 flow input 属性,如下所示:inputspring-doc.cn

<input name="hotelId" />

输入值将保存在流范围中的属性名称下。 例如,前面示例中的输入保存在名称 .hotelIdspring-doc.cn

8.1.1. 声明输入类型

该属性声明 input 属性的类型:typespring-doc.cn

<input name="hotelId" type="long" />

如果 input 值与声明的类型不匹配,则尝试进行类型转换。spring-doc.cn

8.1.2. 分配输入值

该属性指定要为其分配 input 值的表达式,如下所示:valuespring-doc.cn

<input name="hotelId" value="flowScope.myParameterObject.hotelId" />

如果可以确定表达式的值类型,则如果未指定属性,则该元数据将用于类型强制转换。typespring-doc.cn

8.1.3. 根据需要标记输入

该属性强制 input 不为 null 或为空,如下所示:requiredspring-doc.cn

<input name="hotelId" type="long" value="flowScope.hotelId" required="true" />

8.2. 元素output

该元素声明 flow output 属性。 输出属性在表示特定流结果的终端状态中声明。 下面的清单定义了一个元素:outputoutputspring-doc.cn

<end-state id="bookingConfirmed">
    <output name="bookingId" />
</end-state>

输出值是从属性名称下的流范围获取的。 例如,将为前面示例中的输出分配变量的值。bookingIdspring-doc.cn

8.2.1. 指定值的源output

该属性表示特定的输出值表达式,如下所示:valuespring-doc.cn

<output name="confirmationNumber" value="booking.confirmationNumber" />

8.3. 检查点:输入/输出映射

您应该查看包含输入/输出映射的示例预订流程:spring-doc.cn

<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
                          https://www.springframework.org/schema/webflow/spring-webflow.xsd">

    <input name="hotelId" />

    <on-start>
        <evaluate expression="bookingService.createBooking(hotelId, currentUser.name)"
                  result="flowScope.booking" />
    </on-start>

    <view-state id="enterBookingDetails">
        <transition on="submit" to="reviewBooking" />
    </view-state>

    <view-state id="reviewBooking">
        <transition on="confirm" to="bookingConfirmed" />
        <transition on="revise" to="enterBookingDetails" />
        <transition on="cancel" to="bookingCancelled" />
    </view-state>

    <end-state id="bookingConfirmed" >
        <output name="bookingId" value="booking.id"/>
    </end-state>

    <end-state id="bookingCancelled" />

</flow>

该流现在接受 input 属性,并在确认新预订时返回 output 属性。hotelIdbookingIdspring-doc.cn