DIV CSS 佈局教程網

ajaxSubmit 異步提交表單的前後端完整對接
編輯:JavaScript綜合知識     

jQuery.Form 插件提供的 ajaxSubmit 方法能在調用當下立即提交表單,適合「點擊某個按鈕就發送數據」這類場景。下面是一個前後端完整對接的例子。

前台 JavaScript

$("#nickForm").ajaxSubmit({
    type: "post",
    url: "https://localhost:8080/test/myspace.do?method=updateNick¶m=1",
    dataType: "json",
    success: function (result) {
        // 返回提示信息
        alert(result.nickMsg);
    }
});

幾個配置項的作用:type 指定請求方法;url 是提交目標,這裡同時帶了查詢字符串參數(method、para)和表單數據,兩者會合併發送;dataType: "json" 讓 jQuery 自動把響應解析為對象,所以可以直接寫 result.nickMsg;success 裡拿到的是已解析的對象,不必再 eval。

後端封裝

public ActionForward toUpdateNickName(ActionMapping mapping, ActionForm form,
        HttpServletRequest request, HttpServletResponse response) {

    PrintWriter pw = response.getWriter();
    JSONObject obj = new JSONObject();
    obj.put("nickMsg", "昵稱修改成功!");
    pw.print(obj);
    pw.close();
}

這裡用的是 Struts 的 ActionForm 模式,後端把結果封裝成 JSONObject 直接寫回響應流。

一個必須補上的細節:編碼

上面的後端代碼有一個隱患——沒有設置響應編碼。如果表單裡提交的是中文昵稱,響應中的中文很可能變成亂碼。正確寫法是在 getWriter() 之前設置編碼:

// 必須在 getWriter() 之前調用,之後設置無效
response.setCharacterEncoding("UTF-8");
response.setContentType("text/plain;charset=UTF-8");

PrintWriter pw = response.getWriter();
JSONObject obj = new JSONObject();
obj.put("nickMsg", "昵稱修改成功!");
pw.print(obj.toString());     // 注意:建議顯式調 toString()
pw.close();

順帶說一下,pw.print(obj) 這種寫法依賴 JSONObject 重寫了 toString(),能工作但不够明確。寫成 pw.print(obj.toString()) 意圖更清楚。

用 try-with-resources 保證流關閉

public void toUpdateNickName(HttpServletRequest request,
                            HttpServletResponse response) throws IOException {

    response.setCharacterEncoding("UTF-8");
    response.setContentType("application/json;charset=UTF-8");

    JSONObject obj = new JSONObject();
    obj.put("nickMsg", "昵稱修改成功!");

    try (PrintWriter pw = response.getWriter()) {
        pw.print(obj.toString());
        pw.flush();
    }
}

原代碼裡如果在 getWriter() 之後、close() 之前拋出異常,響應流就不會被關閉,長期下來可能導致資源泄漏。try-with-resources 自動處理這個問題。

ajaxSubmit 與 ajaxForm 該選哪個

這兩個方法都來自 jQuery.Form 插件,區別在觸發方式:

  • ajaxForm(options)——註冊綁定。它攔截表單的 submit 事件,用戶點擊提交按鈕或在輸入框按回車時才發請求。需要在 options 之外隨時手動提交時,可以調 $('#form').ajaxSubmit()。
  • ajaxSubmit(options)——立即執行。調用當下就發一次請求,不管用戶有沒有操作。

換句話說,如果需求是「用戶填完表單點提交」,用 ajaxForm 更合適;如果是「用戶點了列表裡某個『修改昵稱』按鈕,順手把旁邊表單的內容發出去」,用 ajaxSubmit。

一點現代化建議

如果目標瀏覽器都支持 FormData(IE10 以下除外),其實不需要引入這個插件:

$("#nickForm").on("submit", function (e) {
    e.preventDefault();                        // 阻止默認提交

    $.ajax({
        url: "myspace.do?method=updateNick",
        type: "POST",
        data: new FormData(this),              // 直接序列化整個表單,支持文件上傳
        processData: false,                    // 不處理數據
        contentType: false,                    // 不設置 Content-Type,讓瀏覽器自動帶 boundary
        dataType: "json",
        success: function (res) { alert(res.nickMsg); }
    });
});

相比插件方案,這段代碼少一個依賴,還能直接支持文件上傳,同時用 e.preventDefault() 攔截表單提交比在函數裡 return false 更清晰。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved