jQuery.Form 插件提供的 ajaxSubmit 方法能在調用當下立即提交表單,適合「點擊某個按鈕就發送數據」這類場景。下面是一個前後端完整對接的例子。
$("#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()) 意圖更清楚。
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 自動處理這個問題。
這兩個方法都來自 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 更清晰。