DIV CSS 佈局教程網

Ajax 使用教學:從 XHR 物件到 jQuery 封裝的完整流程
編輯:AJAX基礎知識     

Ajax 幾乎是現代前端開發的必修課。它的職責其實非常單一:傳送資料、接收資料。理解這一點,剩下的 API 都只是細節。

Ajax 是什麼

Ajax 一般被解讀為 Asynchronous JavaScript And XML。如今,凡是能讓瀏覽器不刷新整頁就與伺服器溝通的技術,都被歸入這一類。

這裡的同步與非同步,說的是通訊方式:同步是送出資料後必須等對方回應才送下一批;非同步則是送出後不等回應,直接繼續往下走,回應到來時再處理。

能達到「不刷新整頁而與伺服器通訊」的手段有幾種:Flash、frameset(只更新其中一個框架)、以及 XMLHttpRequest。最後者是對 JavaScript 的擴充,也是建立 Ajax 應用的最佳選擇——實務上大家乾脆把 Ajax 當成 XHR 的代名詞。

至於資料格式,雖然名字裡有 XML,今日多數專案已改用 JSON 來回傳資料。

基本使用流程

三步驟:取得 XHR 物件、送出資料、接收並處理回應。

var xhr;
if (window.XMLHttpRequest) {
    xhr = new XMLHttpRequest();
} else {
    xhr = new ActiveXObject("Microsoft.XMLHTTP"); // IE5、IE6
}

xhr.open("get", "demo!register.action?name=zt&age=23", true);
xhr.send(null);

xhr.onreadystatechange = function () {
    if (xhr.readyState == 4 && xhr.status == 200) {
        alert(JSON.parse(xhr.responseText));
    }
};

open() 的三個參數

xhr.open(arg1, arg2, arg3);
  • arg1:請求方式,通常為 get 或 post。
  • arg2:請求的伺服器位址。
  • arg3:是否非同步。true 表示非同步(Ajax 的精髓所在),false 表示同步。

要注意的是,呼叫 open() 只是「準備」請求,並未真正與伺服器通訊;直到 send() 被呼叫,連線才開始。send() 的參數會作為請求主體送出:使用 get 時通常傳 null;要透過請求主體送資料時,則需把 open() 的方式設為 post,再把資料放進 send()。

設定順序有講究

對 XHR 的所有設定,都應該在 send() 之前完成:

xhr.open(...);
xhr.setRequestHeader(...);
xhr.overrideMimeType(...);
xhr.onreadystatechange = function () { ... };
xhr.send(...);

嚴格來說 onreadystatechange 是一個事件綁定,放在 send() 之後也能運作;但為了可讀性,建議統一寫在 send() 之前。

監看請求狀態

send() 之後,用 xhr.readyState 與 xhr.status 判斷結果。兩者分別為 4 與 200 時代表成功,此時可透過 xhr.responseText 取得回應內容——注意它是字串,不是物件。

幾個常用 API

xhr.abort():中止請求,直接呼叫即可。

xhr.abort();

xhr.setRequestHeader():設定請求標頭。

xhr.setRequestHeader("Content-Type", "application/json; charset=utf-8");

第一個參數是標頭名稱,第二個是值。它必須呼叫在 open() 與 send() 之間,否則會丟出異常。標頭名稱雖不區分大小寫,仍建議寫成標準格式以便閱讀。

xhr.overrideMimeType():覆寫回應的 Content-Type。

xhr.overrideMimeType('text/plain; charset=utf-8');

JSON.parse 與 JSON.stringify

兩者的方向剛好相反:JSON.parse() 把字串轉為物件,JSON.stringify() 把物件轉為字串。

xhr.onreadystatechange = function () {
    if (xhr.readyState == 4 && xhr.status == 200) {
        var data = JSON.parse(xhr.responseText);
    }
};

用 post 送出資料(非檔案上傳)時,通常也要先序列化,並把 Content-Type 設為 application/json:

var sendData = { name: "zt", age: 23 };
xhr.setRequestHeader("Content-Type", "application/json; charset=utf-8");
xhr.send(JSON.stringify(sendData));

順帶一提,這兩個方法組隊還能實現物件的深拷貝:

var copyData = JSON.parse(JSON.stringify(sendData));

jQuery 的 $.ajax

原生寫法雖然不难,但每次都要處理相容性與狀態判斷。jQuery 把它包成一行設定:

$.ajax({
    type: "post",              // 請求方式
    url: "url",                // 請求位址
    data: "...",               // 送到伺服器的資料
    contentType: "...",        // 若 data 是 JSON 字串,設為 application/json
    success: function (data) { ... },  // 成功回呼
    error: function () { ... }         // 失敗回呼
});

也可以寫成鏈式:

$.ajax({ type: "post", url: "url", data: "...", contentType: "..." })
    .done(function (data) { ... })
    .fail(function () { ... });

回呼函式中的 data 就是伺服器回應的內容,直接使用即可。

用全域設定減少重複

jQuery 提供 $.ajaxSetup()、.ajaxStart()、.ajaxStop()、.ajaxComplete()、.ajaxError()、.ajaxSuccess()、.ajaxSend() 等全域設定與事件。

$.ajaxSetup({
    type: "post",
    contentType: "application/json; charset=utf-8"
});

設定之後,個別呼叫就只需寫:

$.ajax({ url: "", success: function () { ... }, error: function () { ... } });

全域事件最實用的場景是 loading 遮罩。若每次請求都手動開關遮罩,程式碼到處重複;交給全域事件處理就乾淨得多:

$(document).ajaxStart(function () { loadingMask.show(); });
$(document).ajaxComplete(function () { loadingMask.hide(); });

小結

Ajax 的核心觀念只有三個:XHR 物件、open/send 兩段式流程、readyState 與 status 的狀態判斷。掌握之後,無論用原生寫法或框架封裝,都只是在同一套模型上做不同層次的抽象。

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