Ajax 讓前後端之間的資料交換變得容易,也讓局部更新成為可能:不必重新載入整個頁面,就能更新其中一小塊內容。對 JavaWeb 專案而言,它主要扮演瀏覽器與伺服器之間的資料通道。

與其堆疊知識點,不如從一個可運行的案例走一遍流程。
開啟 Eclipse,新增一個 web 專案。目錄結構如下:

<?xml version="1.0" encoding="UTF-8"?> <web-app> </web-app>
這樣環境就搭好了。先別急著往下寫,確定到目前為止都沒問題:在 WebContent 目錄下新增一個空白 jsp 頁面,隨便寫點內容。

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "https://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body style="padding:100px"> <h1>Hello World</h1> </body> </html>
啟動 Tomcat 把專案跑起來。

沒有報錯。開啟瀏覽器輸入 https://localhost/ajax/index.jsp(我的 Tomcat 連接埠是 80,可省略不寫)。

來了,沒問題,說明環境搭建成功。

順著這個類比來理解:Tomcat 是伺服器,裡面有一個叫 ajax 的 web 專案,而這些 Servlet 就好比專案裡的一個個小功能。
你的電腦裡裝了 QQ、Word、殺毒軟體等程式;一個 web 專案也就是一個應用程式,本質上和電腦上的 QQ 是一樣的概念。你打開 QQ 可以聊天、語音、視訊,對應到 JavaWeb 專案,就是一個個 Servlet。
很多人聽過框架,例如 SpringMVC 裡有一個個 Controller。它們到底是什麼?其實就是對 Servlet 做的封裝,本質不變。我們寫 Servlet 需要去 web.xml 註冊,否則用不了——就像安裝一套軟體也會寫入註冊資訊,道理相同。
先繼承 HttpServlet 並覆寫 doGet:
import java.io.IOException;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class MyServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
System.out.println("111");
}
}
接著在 web.xml 註冊:
<?xml version="1.0" encoding="UTF-8"?>
<web-app>
<servlet>
<servlet-name>MyServlet</servlet-name> <!-- servlet 名稱 -->
<servlet-class>MyServlet</servlet-class> <!-- servlet 類別的完整路徑 -->
</servlet>
<servlet-mapping>
<servlet-name>MyServlet</servlet-name>
<url-pattern>/MyServlet</url-pattern> <!-- 對外的映射位址 -->
</servlet-mapping>
</web-app>
重啟 Tomcat,訪問 https://localhost/ajax/MyServlet:

伺服器端差不多了,接下來寫一個給使用者操作的頁面。使用者正是透過這個頁面來呼叫 Servlet。我們的目標很簡單:在頁面上送一句話給伺服器,伺服器回一句話回來。為了省事,樣式直接借用 Bootstrap。

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "https://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" href="${pageContext.request.contextPath}/bootstrap/css/bootstrap.min.css">
<title>Insert title here</title>
<style type="text/css">
.container { margin-top:100px; }
</style>
<script>
window.onload = function () {
var btn = document.getElementById("submit");
btn.onclick = function () {
alert();
}
};
</script>
</head>
<body>
<div class="container">
<div class="row">
<div class="col-lg-8">
<div class="input-group">
<input type="text" class="form-control">
<span class="input-group-btn">
<button id="submit" class="btn btn-default" type="button">提交</button>
</span>
</div>
</div>
</div>
</div>
</body>
</html>

點擊提交鈕後先跳個 alert,確認事件綁定沒問題,再繼續往下寫。
以往我們靠 form 表單提交,但這麼做頁面會刷新,程式碼也相對繁瑣。Ajax 的出現改善了這點,局部刷新在當時是很不錯的解法。先放上實作:
btn.onclick = function () {
var xhr = window.XMLHttpRequest ? new XMLHttpRequest()
: new ActiveXObject("Microsoft.XMLHTTP");
xhr.open("get", "MyServlet?message=" + document.getElementsByTagName("input")[0].value, true);
xhr.send();
xhr.onreadystatechange = function () {
if (xhr.readyState == 4 && xhr.status == 200) {
alert(xhr.responseText);
}
};
}
同時修改 MyServlet:
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
String msg = req.getParameter("message");
System.out.println(msg);
}
重啟 Tomcat,訪問 index.jsp。按 F12 開啟開發者工具,找到 Network 面板(以 Chrome 為例):

Network 會把所有資料互動列出來,包含載入的 js、css,以及每一則請求與回應。重新整理頁面後:

伺服器首先收到 https://localhost/ajax/index.jsp 這個請求,回傳 index.jsp 與 bootstrap.min.css——因為頁面裡確實引入了後者,所以它被一起載入。

輸入一句話並點擊提交:

input 的內容被送到 MyServlet,主控台已經收到(這次剛好沒遇到中文亂碼)。

因為 Servlet 沒有回傳任何內容,所以 alert 出來是空的。那就讓它回一句話:
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
String msg = req.getParameter("message");
System.out.println(msg);
resp.setContentType("text/html;charset=utf-8");
PrintWriter out = resp.getWriter();
out.println("你好,這是服務器返回的信息!");
out.flush();
out.close();
}
再次點擊提交:

成功。接著看請求的詳細資訊:

對照 JS 程式碼就一目了然了:
btn.onclick = function () {
var xhr = window.XMLHttpRequest ? new XMLHttpRequest()
: new ActiveXObject("Microsoft.XMLHTTP");
xhr.open("get", "MyServlet?message=" + document.getElementsByTagName("input")[0].value, true);
xhr.send();
xhr.onreadystatechange = function () {
if (xhr.readyState == 4 && xhr.status == 200) {
alert(xhr.responseText);
}
};
}
readyState 的 five 個階段:
0:請求尚未初始化
1:伺服器連線已建立,尚未發送
2:請求已接收
3:請求處理中
4:請求已完成,回應已就緒
當 readyState 等於 4 且狀態碼為 200 時,代表回應已就緒。此時 xhr.responseText 就是 Servlet 中 out.println("你好,這是服務器返回的信息!") 輸出的那串文字。
GET 會把參數顯示在網址列上,POST 不會,因此 POST 相對安全一些。流程與 GET 幾乎相同,直接看程式:
window.onload = function () {
var btn = document.getElementById("submit");
btn.onclick = function () {
var xhr = window.XMLHttpRequest ? new XMLHttpRequest()
: new ActiveXObject("Microsoft.XMLHTTP");
xhr.open("post", "MyServlet", true);
xhr.setRequestHeader("Content-type", "application/x-www-form-urlencoded");
var postData = { message: document.getElementsByTagName("input")[0].value };
// 轉成 POST 需要的查詢字串格式
var postDataStr = (function (obj) {
var str = "";
for (var prop in obj) {
str += prop + "=" + obj[prop] + "&";
}
return str;
})(postData);
alert(postDataStr);
xhr.send(postDataStr);
xhr.onreadystatechange = function () {
if (xhr.readyState == 4 && xhr.status == 200) {
alert(xhr.responseText);
}
};
}
};
MyServlet.java:
import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class MyServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
req.setCharacterEncoding("UTF-8"); // POST 時需指定編碼,避免中文亂碼
String msg = req.getParameter("message");
System.out.println(msg);
resp.setContentType("text/html;charset=utf-8");
PrintWriter out = resp.getWriter();
out.println("你好,這是服務器返回的信息!");
out.flush();
out.close();
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
doGet(req, resp);
}
}
兩個容易忽略的細節:POST 時必須在伺服器端呼叫 req.setCharacterEncoding("UTF-8"),否則中文極易亂碼;而 GET 的參數來自 URL,編碼問題則要從 server.xml 的 connector 設定著手。另外,範例中手動組字串的方式在正式專案中建議改用 URLSearchParams,並記得對參數值做 encode,避免內容含 & 或 = 時把參數拆壞。