Spring MVC Ajax 嵌套表单数据的提交

概述

在一些场景里，某个大表单里常常嵌套着一个或若干个小逻辑块，比如以下表单里“设计预审”中包括了一个子模块表单“拟定款项”。

在这种情况下该怎么去设计实体类以及表单呢？

实体类的设计

在设计实体类时最好的方式是“主模块包括了自己的字段，而子模块只通过一个属性被引用过来”，如下（以下字段都省略了 getter 和 setter 方法）。

主模块：

public class DesignApplyForAuditUpdate extends BaseEntity {
    private String taskId;
    private String taskComment;

    private ProjectPaymentItem projectPaymentItem;
}

子模块：

public class ProjectPaymentItem extends BaseEntity {

    // 定金
    private BigDecimal earnestPromotionAmount;
    private BigDecimal earnestPromotionPercentage;

    // 首付工程款
    private BigDecimal paymentPercentageFirstPay;

    // 水电工程项
    private BigDecimal paymentPercentageShuiDian;

}

表单的设计

在子模块元素，可以考虑使用“.”(点)操作符。大概看看主表单和子表单的模样。

主表单：

<td colspan="3">
    <input class="easyui-textbox" type="text" name="taskComment" id="txtTaskComment_Edit"
           data-options=" multiline:true, validType:'length[1,2000]', novalidate:'novalidate', width:435, height:58 "/>
</td>

子表单（内嵌于主表单之中）：

<td colspan="3">
    <span>已交纳</span>
    <input type="text" class="easyui-numberbox" name="projectPaymentItem.earnestPromotionAmount"
           id="txtEarnestPromotionAmount_Edit"
           missingmessage="请确保是有效的数字"
           min="0" max="99000000" precision="2"
           data-options="width:150, required:true, novalidate:'novalidate' "/>
    <span>元，优惠百分比：</span>
    <input type="text" class="easyui-numberbox" name="projectPaymentItem.earnestPromotionPercentage"
           id="txtEarnestPromotionPercentage_Edit"
           missingmessage="请确保是有效的数字"
           min="100" max="10000" precision="0"
           data-options="width:150, required:true, novalidate:'novalidate' "/>
    <span>%</span>
    <div>
        <span>可抵消金额：</span>
        <span id="earnestPromotionResult">5000</span>
        <span>元</span>
    </div>
</td>

可以看到，子模块的 name 属性值前面需要通过点间隔符来补充一个前缀：“projectPaymentItem”

经过 Ajax 提交后，服务端会以主子结构完好的承接客户端的数据。

客户端的 Ajax 和 SpringMVC 控制器

对于表单数据的提交只需采用普通的 Ajax 配置来提交就可以，即使实体模型是嵌套层次。

• 客户收集数据以及 Ajax

// 表单值获取
var formData = $taskForm.form('r_serialize', false);

// 发起请求操作
$.ajax({
    data: formData,
    url: url,
    type: "POST",
    dataType: "json",
    success: function (result) {
        console.info("保存成功，返回的数据为：↓");
        console.info(result);

        if (result.success) {
            $.messager.show({
                title: '提示', // 头部面板上显示的标题文本。
                msg: result.message
            });
        }
    },
    error: function (result) {
    }
}); //end ajax

尽管要提交的数据存在嵌套，但这还不属性复杂模型，所以 Ajax 只需按普通数据来提交即可。

看一下提交的数据：

• SpringMVC 控制器接收数据

// 暂存
@RequestMapping(value = "/UpdateDesignApplyForAudit", method = RequestMethod.POST)
@ResponseBody
public TransactionResult UpdateDesignApplyForAudit(DesignApplyForAuditUpdate designApplyForAuditUpdate, @CookieValue(value = "base_cookieKey", required = false) CookieObject cookieObject) {
    designApplyForAuditUpdate.setCookieObject(cookieObject);
    TransactionResult result = null;
}

designApplyForAuditUpdate 的值如下：

最后提一下客户端针对子表单的赋值，尽管上述的取值很方便，但赋值仍需逐个进行：

// 拟定款项
projectPaymentItemPartialView.initialForm(result.data.projectPaymentItem);

initialForm: function (data) {
    // 定金
    $txtEarnestPromotionAmount_Edit.numberbox('setValue', data.earnestPromotionAmount);
    $txtEarnestPromotionPercentage_Edit.numberbox('setValue', data.earnestPromotionPercentage);

    // 工程款
    $txtPaymentPercentageFirstPay_Edit.numberbox('setValue', data.paymentPercentageFirstPay);
    $txtPaymentPercentageShuiDian_Edit.numberbox('setValue', data.paymentPercentageShuiDian);
    $txtPaymentPercentageWaGong_Edit.numberbox('setValue', data.paymentPercentageWaGong);
    $txtPaymentPercentageMuGong_Edit.numberbox('setValue', data.paymentPercentageMuGong);
    $txtPaymentPercentageYouQi_Edit.numberbox('setValue', data.paymentPercentageYouQi);
    $txtPaymentPercentageFinalPay_Edit.numberbox('setValue', data.paymentPercentageFinalPay);

    // 额外款项
    $txtExtraAmount_Edit.numberbox('setValue', data.extraAmount);
}