適用於傳統多頁應用 (MPA),提交後瀏覽器導向新頁面。
// 前端 JS
function submitToServlet() {
document.getElementById('sendPerson').value = getSendPerson();
document.getElementById('currentTime').value = getCurrentTime();
document.getElementById('message').value = getMessage();
document.getElementById('recvPerson').value = getRecvPerson();
var form = document.forms['chatform']; // 或 document.getElementById('formId')
form.action = 'ToHistoryServlet'; // Servlet 路徑
form.method = 'POST';
form.submit(); // 頁面跳轉
}
// HTML 隱藏欄位 (需有 name 屬性供後端 getParameter)
<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">
// 後端 Servlet (Java)
@WebServlet("/ToHistoryServlet")
public class ToHistoryServlet extends HttpServlet {
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
req.setCharacterEncoding("UTF-8"); // 解決 POST 中文亂碼
String sendPerson = req.getParameter("sendPerson");
String recvPerson = req.getParameter("recvPerson");
String sendTime = req.getParameter("currentTime");
String message = req.getParameter("message");
Message msg = new Message(sendPerson, recvPerson, sendTime, message);
HistoryHandle.addMessage(msg);
// 跳轉或轉發
resp.sendRedirect("success.jsp");
}
}
缺點:頁面整頁刷新/跳轉,用戶體驗差,狀態難保持。
$.ajax({
type: 'POST',
url: 'ToHistoryServlet', // 相對或絕對路徑
data: {
sendPerson: getSendPerson(),
currentTime: getCurrentTime(),
message: getMessage(),
recvPerson: getRecvPerson()
},
dataType: 'json', // 預期回應 JSON
success: function(result) {
if (result.success) {
alert('儲存成功');
// 更新局部 UI
} else {
alert('失敗: ' + result.msg);
}
},
error: function(xhr, status, err) {
console.error('AJAX 錯誤:', status, err);
alert('請求異常');
}
});
// 後端回應 JSON
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws IOException {
req.setCharacterEncoding("UTF-8");
resp.setContentType("application/json;charset=UTF-8"); // 關鍵:設定回應類型與編碼
// 取參數...
// 業務邏輯...
// 回傳 JSON
PrintWriter out = resp.getWriter();
out.write("{\"success\":true,\"msg\":\"儲存成功\"}");
out.flush();
}
| 層級 | 設定 | 說明 |
|---|---|---|
| 1. 頁面 | <meta charset="utf-8"> | HTML 文檔編碼 |
| 2. JS 請求 | contentType: 'application/x-www-form-urlencoded; charset=UTF-8' (jQuery 預設即為此) | 請求標頭聲明編碼 |
| 3. 伺服器接收 | request.setCharacterEncoding("UTF-8") (在 getParameter 前調用) | 解碼 POST Body |
| 4. 伺服器回應 | response.setContentType("application/json;charset=UTF-8") (在 getWriter() 前) | 編碼回應 Body |
| 5. Tomcat 全域 | server.xml: <Connector ... URIEncoding="UTF-8" /> | 解決 GET 參數編碼 (GET 參數在 URL,不經過 request body) |
GET 參數在 URL 查詢字串,Tomcat 預設用 ISO-8859-1 解碼。兩種解法:
URIEncoding="UTF-8" (推薦,一勞永逸)。new String(param.getBytes("ISO-8859-1"), "UTF-8")。$.ajax 或 fetch 替代舊式 XMLHttpRequest。error 回調、HTTP 狀態碼、業務錯誤碼統一規範。X-CSRF-Token)。