DIV CSS 佈局教程網

JS 呼叫後端 Servlet 的兩種方式:表單提交與 jQuery AJAX 對比
編輯:關於JavaScript     

前端要把資料送到後端,最直覺的是提交表單,最靈活的是 AJAX。本文用同一個情境——把聊天訊息寫入歷史紀錄——示範兩種做法,並比較其得失。

方法一:以 document.form.action 提交表單

前端 JS

document.getElementById("sendPerson").value  = SendPerson;
document.getElementById("currentTime").value = currentTime();
document.getElementById("message").value     = message;
document.getElementById("recvPerson").value  = recvPerson;

document.chatform.action = "ToHistoryServlet";
document.chatform.submit();

HTML 中的隱藏欄位

這些欄位用來承裝要送出的資料:

<!-- 傳給 userHistory 的參數 -->
<input type="hidden" name="sendPerson"  id="sendPerson">
<input type="hidden" name="currentTime" id="currentTime">
<input type="hidden" name="message"     id="message">
<input type="hidden" name="recvPerson"  id="recvPerson">

關鍵提醒: input 一定要指定 name 屬性。後端是靠 name 取值的,只給 id 的話 request.getParameter() 會拿到 null。這是新手最常犯的錯誤之一。

後端 Java(Servlet)

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

    String sendPerson = request.getParameter("sendPerson");
    String recvPerson = request.getParameter("recvPerson");
    String sendTime   = request.getParameter("currentTime");
    String message    = request.getParameter("message");

    Message msg = new Message();
    msg.setMessage(message);
    msg.setRecvPerson(recvPerson);
    msg.setSendPerson(sendPerson);
    msg.setSendTime(sendTime);

    HistoryHandle.addMessage(msg);
}

這個方法的缺點

最大問題是頁面會跳走。表單一送出,瀏覽器就導向 Servlet 的輸出結果,原本的使用者操作狀態、輸入中的草稿全部遺失。若只想靜默地存一筆資料、留在原頁面繼續操作,就必須用方法二。

方法二:以 jQuery AJAX 呼叫

$.ajax({
    type: "POST",
    contentType: "application/json",
    url: "ToHistoryServlet?sendPerson=" + SendPerson
       + "&currentTime=" + currentTime()
       + "&message=" + message
       + "&recvPerson=" + recvPerson,
    dataType: 'json',
    success: function (result) {
        alert(result.d);
    }
});

程式碼量更少、頁面不刷新,體驗好得多,是實務上的首選。

但上面這段 AJAX 寫法有幾個問題要修正

原始範例為了求簡,示範了幾個不該沿用的習慣:

  1. 參數應該放在 data 而非硬拼在 URL 上:字串拼接一旦遇到 &、=、中文或空白就會出錯,也容易產生注入風險。
  2. contentType 與 URL 參數矛盾:宣告送 JSON 卻把參數放在 query string,兩者並不一致。
  3. 缺少錯誤處理:網路失敗時使用者得不到任何回饋。

建議改成:

$.ajax({
    type: "POST",
    url: "ToHistoryServlet",
    data: {
        sendPerson:  SendPerson,
        currentTime: currentTime(),
        message:     message,
        recvPerson:  recvPerson
    },
    dataType: "json",
    success: function (result) {
        console.log("已儲存", result);
    },
    error: function (xhr, status, err) {
        console.error("送出失敗", status, err);
    }
});

由 jQuery 負責編碼,不必自己處理特殊字元。

不用 jQuery 的等效寫法

fetch("ToHistoryServlet", {
    method: "POST",
    headers: { "Content-Type": "application/x-www-form-urlencoded" },
    body: new URLSearchParams({
        sendPerson:  SendPerson,
        currentTime: currentTime(),
        message:     message,
        recvPerson:  recvPerson
    })
})
.then(function (r) {
    if (!r.ok) throw new Error("HTTP " + r.status);
    return r.json();
})
.then(function (result) { console.log("已儲存", result); })
.catch(function (err) { console.error(err); });

URLSearchParams 會自動完成 URL 編碼,省去手動 encodeURIComponent 的麻煩。

兩種方法的選擇建議

  • 表單提交:適合「送出後本來就要換頁」的情境,例如登入、結帳、上傳後跳轉。優點是無需 JS 也能運作(可【降級】),並天然支援瀏覽器的重新整理與上一頁。
  • AJAX:適合「送出後要留在原頁」的情境,例如按讚、自動儲存、即時聊天。缺點是必須自行處理載入中狀態、錯誤提示與重試。

另外提醒一個安全性重點:Servlet 端務必對所有 getParameter 的結果做驗證與轉義,前端傳什麼不代表後端就能直接信任或寫入資料庫——使用 PreparedStatement 避免 SQL 注入,輸出到畫面前做 HTML 轉義避免 XSS。

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