DIV CSS 佈局教程網

Ajax 完全指南:從物件建立到中文亂碼與連動選單
編輯:AJAX基礎知識     

這篇把原生 Ajax 一整套流程走過一遍:如何取得 XMLHttpRequest 物件、如何發 GET 與 POST、如何做成「帳號可用性即時檢查」、中文亂碼怎麼處理、以及最後的級聯下拉選單。每一節都附上完整可運行的程式碼。

一、取得 Ajax 物件

問題:如何取得 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>

二、發送 GET 請求

方案:依「建立物件 → 建立請求 → 設定回呼 → 送出請求」四步完成一次非同步呼叫。

<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>

三、發送 POST 請求

方案:在 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);
}

執行結果:

四、用 Ajax 驗證帳號是否可用

方案:填完帳號後按鈕觸發驗證,把伺服器回傳的說明訊息顯示出來。

<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 之前,否則不會生效。

輸入不可用的帳號:

輸入可用的帳號:

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

五、POST 請求的中文亂碼

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

原因:Firefox 會主動告訴伺服器該用什麼方式解碼;IE 與 Chrome 送出的資料到了伺服器端,會以預設的 ISO-8859-1 解析,而提交時瀏覽器是依 meta 標記指定的 UTF-8 進行編碼的。編碼與解碼不一致,亂碼於焉產生。

方案:在取得表單資料之前,把伺服器端的解碼方式設為 UTF-8。在 service 方法中加一行即可:

request.setCharacterEncoding("UTF-8");

重新運行,分別用 Chrome、IE、Firefox 測試,中文都能正確取得。

六、GET 請求的中文亂碼

問題:把提交方式改成 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>

伺服器端維持不變。執行結果:

七、用 Ajax 實作級聯下拉選單

方案:下拉選單觸發 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

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