這篇把原生 Ajax 一整套流程走過一遍:如何取得 XMLHttpRequest 物件、如何發 GET 與 POST、如何做成「帳號可用性即時檢查」、中文亂碼怎麼處理、以及最後的級聯下拉選單。每一節都附上完整可運行的程式碼。
問題:如何取得 XMLHttpRequest 物件。
方案:區分瀏覽器,使用不同的取得方式。
<script type="text/javascript">
/* 取得 Ajax 物件 */
function getXhr(){
var xhr = null;
// 確保 IE7、IE8、FireFox 下可運行
if (window.XMLHttpRequest) {
xhr = new XMLHttpRequest();
} else {
// 確保 IE6 可運行,更古老的 IE 就不考慮了
xhr = new ActiveXObject("Microsoft.XMLHttp");
}
return xhr;
// 更簡易的寫法:
// xhr = window.XMLHttpRequest ? new XMLHttpRequest()
// : new ActiveXObject("Microsoft.XMLHttp");
}
</script>
部署後訪問頁面:

圖 – 2
點擊連結後:

圖 - 3
用 IE 測試的結果:


圖 – 4
注意:本次測試用的是 IE11。IE 早期的 5.5、6.0 版本建立的都是 ActiveXObject 型別,從 IE7 開始才支援以 XMLHttpRequest 方式取得 Ajax 物件。
完整程式碼:
<html>
<head>
<title>ajax01.html</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<script type="text/javascript">
function getXhr(){
var xhr = null;
if (window.XMLHttpRequest) {
xhr = new XMLHttpRequest();
} else {
xhr = new ActiveXObject("Microsoft.XMLHttp");
}
return xhr;
}
</script>
</head>
<body>
<a href="javascript:;" onclick="alert(getXhr());">取得 Ajax 物件</a>
</body>
</html>
方案:依「建立物件 → 建立請求 → 設定回呼 → 送出請求」四步完成一次非同步呼叫。
<script type="text/javascript">
function getXhr(){
var xhr = null;
if (window.XMLHttpRequest) {
xhr = new XMLHttpRequest();
} else {
xhr = new ActiveXObject("Microsoft.XMLHttp");
}
return xhr;
}
function getText(){
// 1. 取得 Ajax 物件
var xhr = getXhr();
// 2. 設定回呼函式
xhr.onreadystatechange = function(){
if (xhr.readyState == 4 && xhr.status == 200) {
alert(xhr.responseText);
}
};
// 3. 建立請求
xhr.open("get", "get_text.do", true);
// 4. 送出請求
xhr.send(null);
}
</script>
ActionServlet:
package web;
import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.http.*;
public class ActionServlet extends HttpServlet {
public void service(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html;charset=UTF-8");
PrintWriter out = response.getWriter();
// 取得請求資源路徑
String uri = request.getRequestURI();
String path = uri.substring(uri.lastIndexOf("/"), uri.lastIndexOf("."));
if (path.equals("/get_text")) {
out.println("get請求-服務器返回的數據");
}
out.close();
}
}
執行後點擊連結:


web.xml 的相關設定:
<servlet> <servlet-name>ActionServlet</servlet-name> <servlet-class>web.ActionServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>ActionServlet</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping>
方案:在 GET 的四步之上,多增加一個設定——把請求標頭的 content-type 設為 application/x-www-form-urlencoded。
先把 getXhr 抽到 my.js 裡重用:

// js/my.js
function getXhr() {
var xhr = null;
if (window.XMLHttpRequest) {
xhr = new XMLHttpRequest();
} else {
xhr = new ActiveXObject("Microsoft.XMLHttp");
}
return xhr;
}
ajax03.html:
<script type="text/javascript" src="js/my.js"></script>
<script type="text/javascript">
function getText(){
var xhr = getXhr();
xhr.onreadystatechange = function(){
if (xhr.readyState == 4 && xhr.status == 200) {
alert(xhr.responseText);
}
};
xhr.open("post", "post_text.do", true);
xhr.setRequestHeader('content-type', 'application/x-www-form-urlencoded');
xhr.send("uname=daliu_it");
}
</script>
ActionServlet 增加一個分支:
else if (path.equals("/post_text")) {
String name = request.getParameter("uname");
System.out.println(name);
out.println("又來了一次的" + name);
}
執行結果:

方案:填完帳號後按鈕觸發驗證,把伺服器回傳的說明訊息顯示出來。
<body>
<form action="" method="post">
<fieldset>
<legend>注册信息</legend>
用戶名:
<input name="uname" id="uname" />
<input type="button" value="檢查一下吧" onclick="check_name()" />
<span id="name_msg" style="color: red;"></span>
<br /><br />
<input type="submit" value="注冊" />
</fieldset>
</form>
</body>
<script type="text/javascript">
function check_name(){
var xhr = getXhr();
xhr.onreadystatechange = function(){
if (xhr.readyState == 4 && xhr.status == 200) {
document.getElementById("name_msg").innerHTML = xhr.responseText;
}
};
xhr.open("post", "check_name.do", true);
xhr.setRequestHeader('content-type', 'application/x-www-form-urlencoded');
// 伺服器還沒回應之前,先給使用者一個回饋
document.getElementById("name_msg").innerHTML = "正在檢查。。。";
var uname = document.getElementById("uname");
xhr.send("uname=" + uname.value);
}
</script>
伺服器端加上一個模擬延遲,才好觀察 Loading 提示的效果:
else if (path.equals("/check_name")) {
String name = request.getParameter("uname");
// 模擬網絡延遲
try { Thread.sleep(6000); } catch (InterruptedException e) { e.printStackTrace(); }
System.out.println(name);
if ("Luffy".equals(name)) {
out.println("該用戶名不可用");
} else {
out.println("可以使用!");
}
}
順序很重要:open 與 setRequestHeader 這兩句不能顛倒,setRequestHeader 必須在 open 之後、send 之前,否則不會生效。
輸入不可用的帳號:

輸入可用的帳號:

那行「正在檢查。。。」看似不起眼,卻是良好互動體驗的關鍵——它在伺服器回應之前先佔住位置,讓使用者知道系統沒當機。

問題:若帳號填中文,控制台上伺服器端收到的資料是亂碼。但用 Firefox 提交中文卻能被正確識別。

原因:Firefox 會主動告訴伺服器該用什麼方式解碼;IE 與 Chrome 送出的資料到了伺服器端,會以預設的 ISO-8859-1 解析,而提交時瀏覽器是依 meta 標記指定的 UTF-8 進行編碼的。編碼與解碼不一致,亂碼於焉產生。
方案:在取得表單資料之前,把伺服器端的解碼方式設為 UTF-8。在 service 方法中加一行即可:
request.setCharacterEncoding("UTF-8");
重新運行,分別用 Chrome、IE、Firefox 測試,中文都能正確取得。
問題:把提交方式改成 get、伺服器端仍保留 UTF-8 解碼,中文一樣亂。

原因:GET 的資料位於請求標頭的 URI 中。HTTP 協定對 URI 本身的編碼方式是 UTF-8,但 URI 後面查詢字串的編碼方式卻是 ISO-8859-1;到了伺服器端,容器對 URI 的解碼方式同樣是 ISO-8859-1,自然解析不了中文。要支援網址中的中文,必須在瀏覽器端與伺服器端同時設定 UTF-8。
步驟一:修改 Tomcat 的預設解碼設定。編輯 conf/server.xml,在 Connector 節點加上 URIEncoding="UTF-8"。

步驟二:前端也要處理。為了讓整個 URI 都以 UTF-8 編碼,在 open 的第二個參數上套一層 encodeURI():

<script type="text/javascript">
function check_name(){
var uname = document.getElementById("uname");
var uri = "check_name.do?uname=" + uname.value;
var xhr = getXhr();
xhr.onreadystatechange = function(){
if (xhr.readyState == 4 && xhr.status == 200) {
document.getElementById("name_msg").innerHTML = xhr.responseText;
}
};
xhr.open("get", encodeURI(uri), true);
document.getElementById("name_msg").innerHTML = "正在檢查。。。";
xhr.send(null);
}
</script>
伺服器端維持不變。執行結果:

方案:下拉選單觸發 onchange 時,把選中城市的 value 送給伺服器;伺服器比對後回傳該城市的區域組合;客戶端依「;」與「,」拆開,逐一建立 Option 物件加入下層選單。
先在 my.js 補兩個小工具函式:
function $(id) { return document.getElementById(id); }
function $F(id) { return $(id).value; }
select.html:
<body>
<select id="s1" style="width: 120px;" onchange="getCity(this.value);">
<option value="bj">北京</option>
<option value="sh">上海</option>
<option value="gz">廣州</option>
</select>
<select id="s2" style="width: 120px;"></select>
<script type="text/javascript">
function getCity(v1) {
var xhr = getXhr();
xhr.onreadystatechange = function() {
if (xhr.readyState == 4 && xhr.status == 200) {
var txt = xhr.responseText; // 朝陽,cy;東城,dc
var strs = txt.split(';');
$('s2').innerHTML = ''; // 先清空 s2
for (var i = 0; i < strs.length; i++) {
var str1s = strs[i].split(',');
/* 建立一個 Option 物件 */
var op = new Option(str1s[0], str1s[1]);
/* options 是 select 的屬性,其值是一個陣列,元素為 Option 物件 */
$('s2').options[i] = op;
}
}
};
xhr.open('get', 'getCity.do?name=' + v1, true);
xhr.send(null);
}
</script>
</body>
伺服器端加上對應分支:
else if (path.equals("/getCity")) {
String name = request.getParameter("name");
if ("bj".equals(name)) {
out.println("朝陽,cy;東城,dc");
} else if ("sh".equals(name)) {
out.println("靜安,ja;黃浦,hp;浦東新,pdx");
} else {
out.println("白雲,by;番禺,py");
}
}

第一,readyState 與 status 要一起判斷。只檢查 readyState == 4 是不夠的,還必須確認 status == 200,否則 404 或 500 的回應也會被當成成功處理。
第二,編碼要在兩端對齊。POST 靠 request.setCharacterEncoding,GET 則要同時處理 encodeURI 與容器的 URIEncoding。這兩類亂碼的成因不同,解法也不同,混在一起談很容易搞錯。
第三,open 與 setRequestHeader 的順序不能顛倒。這是初學階段最常出現、也最難自行察覺的錯誤之一。
原始碼下載:https://yunpan.cn/cQs2VUIqdERkb 提取碼 61a9