DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
用 JavaScript 與 Ajax 送出非同步請求:XMLHttpRequest 完全入門
編輯:AJAX詳解     

多數 Web 應用程式採用「請求/回應」模型取得完整的 HTML 頁面:點一個按鈕、等伺服器回應、再點下一個按鈕、再等。有了 Ajax 與 XMLHttpRequest 物件,就能改用一種不必讓使用者乾等的請求/回應模型。本文從最基礎的地方開始,把這個物件徹底講清楚。

先說清楚 Web 2.0 是什麼

談 Web 2.0 之前,先問一句:那 Web 1.0 是什麼?它指的是傳統的請求/回應模型——在 Amazon 上點個按鈕或輸入關鍵字,瀏覽器送出請求,伺服器回傳另一個完整的 HTML 頁面。所以每次互動,畫面都會重新繪製,使用者往往看得到閃爍或抖動。

Web 2.0 在很大程度上消除了這種看得見的往返。在 Google Maps 上拖動地圖、縮放,幾乎沒有整頁重繪;Flickr 的瀏覽體驗也類似。請求與回應仍然存在,只是被藏到幕後了。使用者感覺更像在操作桌面軟體——這種新的體驗與典範轉移,就是人們談到 Web 2.0 時所指的東西。

關鍵在於:我們需要一種方式,讓請求與回應只攜帶真正需要的資料,而不是整頁 HTML。只有在真的要換頁時,才值得傳一整份新頁面。絕大多數互動其實只是在既有頁面上補一點細節、改一段文字、換一批數據——這些情況正適合 Ajax。

XMLHttpRequest 簡介

要實現這件事,必須熟悉一個 JavaScript 物件:XMLHttpRequest。它體積很小,卻是 Web 2.0 與 Ajax 的核心。先看幾個最常用的成員:

  • open():建立到伺服器的新請求。
  • send():向伺服器送出請求。
  • abort():中止目前請求。
  • readyState:提供目前的就緒狀態。
  • responseText:伺服器回傳的文字內容。

歸納一下會發現,這些方法與屬性全都繞著同一件小事打轉:送出請求、處理回應。沒有神祕的 GUI 物件,也沒有祕技,但用好它足以徹底改變你的應用程式。

最簡單的 new

建立一個變數並指向 XMLHttpRequest 實例,在 JavaScript 裡非常簡單:

<script language="javascript" type="text/javascript">
var request = new XMLHttpRequest();
</script>

JavaScript 不必宣告變數型別,所以不需要像 Java 那樣寫 XMLHttpRequest request = new XMLHttpRequest();。用 var 命名、賦值,之後就能在函式中使用它。

錯誤處理:別讓舊瀏覽器無聲失敗

實務上什麼都可能出錯。較早期的瀏覽器不支援這個物件,你應該優雅地告知使用者,而不是讓程式靜靜地什麼都不做:

var request = false;

try {
    request = new XMLHttpRequest();
} catch (failed) {
    request = false;
}

if (!request) {
    alert("無法初始化 XMLHttpRequest!");
}

流程是:先把 request 設為 false 當作哨兵;用 try/catch 嘗試建立;失敗時維持 false;最後檢查,若仍是 false 就提示使用者。

應付 Microsoft:三層 try/catch

看起來一切良好——直到你在 Internet Explorer 上測試。

IE 絕不是小眾瀏覽器,不去支援它就等於放棄大部分使用者。幸運的是 IE 也支援 Ajax,只是名稱不同:新版本使用 Msxml2.XMLHTTP,舊版本使用 Microsoft.XMLHTTP。把兩者都包進來:

var request = false;

try {
    request = new XMLHttpRequest();
} catch (trymicrosoft) {
    try {
        request = new ActiveXObject("Msxml2.XMLHTTP");     // 較新版 IE
    } catch (othermicrosoft) {
        try {
            request = new ActiveXObject("Microsoft.XMLHTTP");  // 舊版 IE
        } catch (failed) {
            request = false;
        }
    }
}

if (!request) {
    alert("無法初始化 XMLHttpRequest!");
}

層層嵌套只是為了「依序嘗試,全失敗才放棄」。改寫之後在 IE 上測試,表單應該正常出現,不再有錯誤訊息。

靜態程式碼還是包成函式?

上面幾段程式碼都直接寫在 <script> 標籤裡,這種不放在函式中的寫法稱為靜態 JavaScript——它在頁面呈現給使用者之前就已執行,這也是多數 Ajax 開發者的習慣做法。

當然也可以包成函式,在需要時才呼叫:

var request;

function createRequest() {
    try {
        request = new XMLHttpRequest();
    } catch (trymicrosoft) {
        try {
            request = new ActiveXObject("Msxml2.XMLHTTP");
        } catch (othermicrosoft) {
            try {
                request = new ActiveXObject("Microsoft.XMLHTTP");
            } catch (failed) {
                request = false;
            }
        }
    }
    if (!request) { alert("無法初始化 XMLHttpRequest!"); }
}

function getCustomerInfo() {
    createRequest();
    // 之後再用 request 做事
}

但這種寫法把錯誤通知延後了。想像一個有十幾個欄位的表單,使用者填到第十四欄時才觸發 Ajax,這時才發現初始化失敗並跳出警告——他剛剛花的時間全白費了。這種體驗足以讓人再也不回來。

用靜態程式碼,使用者在點開頁面時就看到錯誤,雖然一樣惱人,卻比填完十分鐘才被告知要好。讓問題越早曝光越好,這是我偏好靜態寫法的原因。

沙箱模型:只能對同域發請求

Ajax 採用沙箱安全模型,XMLHttpRequest 只能對同一個網域送出請求。若程式跑在 www.example.com,就只能向該網域下的腳本請求。跨網域需要伺服器端 CORS 標頭或後端代理,這是後話。

設定伺服器 URL

多數應用會把靜態路徑與表單中的資料組合成 URL:

function getCustomerInfo() {
    var phone = document.getElementById("phone").value;
    var url = "/cgi-local/lookupCustomer.php?phone=" + escape(phone);
}

因為受同源政策限制,URL 裡不需要網域名稱。電話號碼作為 GET 參數接在後面。若沒見過 escape(),它的作用是把無法以純文字安全傳送的字元轉義——例如空格會被編碼,才能在網址中傳遞。需要更多參數時,用 & 串接即可(第一個參數以 ? 與程式名分隔)。今日請改用 encodeURIComponent(),它的編碼規則更完整。

對應的表單大致如下:

<body>
<p><img src="breakneck-logo.gif" alt="Break Neck Pizza" /></p>
<form action="POST">
  <p>Enter your phone number:
     <input type="text" size="14" name="phone" id="phone" />
  </p>
  <p>Your order will be delivered to:</p>
  <div id="address"></div>
  <p>Type your order in here:</p>
  <p><textarea name="order" rows="6" cols="50" id="order"></textarea></p>
  <p><input type="submit" value="Order Pizza" id="submit" /></p>
</form>
</body>

當使用者輸入或改變電話號碼時觸發 getCustomerInfo(),它就取出號碼並組出 URL。

打開請求:open() 的五個參數

  • request-type:請求方式,通常是 GET 或 POST,也可以是 HEAD。
  • url:要連線的網址。
  • asynch:是否非同步,預設 true。建議即使使用預設值也明確寫出,程式意圖更清楚。
  • username/password:需要驗證時指定,可省略。
function getCustomerInfo() {
    var phone = document.getElementById("phone").value;
    var url = "/cgi-local/lookupCustomer.php?phone=" + encodeURIComponent(phone);
    request.open("GET", url, true);
}

挑戰非同步:為什麼第三個參數這麼重要

在傳統模型中,客戶端送出請求後必須等待伺服器回應。等待期間,介面會以某種方式告訴你「正在忙」:Windows 的沙漏、Mac 的旋轉球,或者應用程式直接凍結,過一會游標才變回來。

這正是傳統 Web 應用讓人覺得遲鈍的原因——按下按鈕後,應用程式實際上處於不可用狀態,直到請求回來。若伺服器需要大量運算,等待時間可能相當長。

而非同步請求不等待。送出之後程式繼續執行,使用者照樣可以在表單中輸入、捲動、甚至離開。沒有沙漏,沒有凍結。伺服器安靜地處理,完成後再回頭通知原來的呼叫者。結果是:應用程式感覺迅速、有反應,完全不一樣。所有花俏的 GUI 元件都無法彌補同步模型帶來的遲鈍。

送出請求:send()

設定好之後就能送出,方法名稱很貼切——send()。它只有一個參數:要送出的內容。但前面已經把資料放在網址裡了:

var url = "/cgi-local/lookupCustomer.php?phone=" + encodeURIComponent(phone);

在典型的 Ajax 應用中,大約八成的請求用 GET 就夠了,用網址帶參數比 send() 簡單得多。若需要傳送敏感資訊或 XML,才考慮用 send() 承載。不需要帶內容時,傳 null 即可:

function getCustomerInfo() {
    var phone = document.getElementById("phone").value;
    var url = "/cgi-local/lookupCustomer.php?phone=" + encodeURIComponent(phone);
    request.open("GET", url, true);
    request.send(null);
}

指定回呼方法:真正的祕密

捫心自問,上面這些程式碼有哪裡是革命性的?只有 open() 裡那個 true 建立了非同步請求,其餘和寫 Servlet、PHP 沒兩樣。Ajax 最大的祕密其實是一個簡單的屬性:onreadystatechange。

先看流程:建立請求、送出請求。因為是非同步,getCustomerInfo() 不會等伺服器,程式繼續往下跑然後退出,控制權交由表單,使用者可以繼續操作。

那麼伺服器完成之後呢?以現在的程式碼來說——什麼都不會發生。這顯然不行。伺服器處理完之後,需要有一個「告訴頁面怎麼做」的機制。

onreadystatechange 就是這個機制。它讓你指定一個回呼函式,伺服器完成請求後會回頭呼叫它。之所以叫「回呼」,是因為由伺服器反向呼叫網頁中的程式碼,不論使用者當時在做什麼——可能正把手從鍵盤移開,也可能正在打字、移動滑鼠、捲動畫面。它一概不管。

這就是「非同步」的真義:使用者這一層在操作表單,伺服器那一層在回應請求並觸發回呼。

function getCustomerInfo() {
    var phone = document.getElementById("phone").value;
    var url = "/cgi-local/lookupCustomer.php?phone=" + encodeURIComponent(phone);
    request.open("GET", url, true);
    request.onreadystatechange = updatePage;   // 必須在 send() 之前設定
    request.send(null);
}

位置很關鍵:一定要在 send() 之前指定,否則伺服器回應時找不到要呼叫的函式。

HTTP 就緒狀態:為什麼會跳出四次警告

先寫一個最簡單的回呼來觀察:

function updatePage() {
    alert("伺服器已完成!");
}

在自己的網頁上試試,輸入電話號碼後離開該欄位,你會看到彈跳的警告視窗——而且按確定之後又跳出來,依瀏覽器不同,可能出現兩次、三次甚至四次。

原因是:我們還沒考慮 HTTP 就緒狀態。事實上,每當就緒狀態改變,都會呼叫一次這個方法。就緒狀態共有五種:

  • 0:請求尚未送出(呼叫 open() 之前)。
  • 1:請求已建立但還沒送出(呼叫 send() 之前)。
  • 2:請求已送出、正在處理(通常此時可取得回應標頭)。
  • 3:請求已處理,回應中有部分資料可用,但伺服器尚未完成。
  • 4:回應已完成,可以安全使用資料。

跨瀏覽器的行為並不一致:有些從 2 直接開始,有些會完整回報每一階段,有些甚至重複回報狀態 1。所以我們真正需要處理的只有就緒狀態 4:

function updatePage() {
    if (request.readyState == 4) {
        alert("伺服器已完成!");
    }
}

加上這個判斷,警告就只會出現一次了。

HTTP 狀態碼:完成了,但卻是錯誤

還有一個漏洞:如果伺服器完成了處理,卻回報一個錯誤怎麼辦?伺服器端程式往往不知道自己是被 Ajax、JSP 還是普通表單呼叫的,只能沿用傳統的 HTTP 方式回報結果。

你一定遇過輸入錯誤網址而得到 404 的情形;此外 403(禁止)與 401(未授權)也很常見。這些狀態碼都出現在已完成的回應中——伺服器確實回應了(就緒狀態是 4),但沒給你期望的資料。

所以除了就緒狀態,還要檢查狀態碼。我們期待的是 200:

function updatePage() {
    if (request.readyState == 4) {
        if (request.status == 200) {
            alert("伺服器已完成!");
        }
    }
}

再多加一點錯誤處理,就能涵蓋大部分常見狀況:

function updatePage() {
    if (request.readyState == 4) {
        if (request.status == 200) {
            alert("伺服器已完成!");
        } else if (request.status == 404) {
            alert("請求的網址不存在");
        } else {
            alert("發生錯誤,狀態碼:" + request.status);
        }
    }
}

把網址故意改成不存在的路徑試試,你會看到對應的提示。很難窮舉所有錯誤條件,但這小小的改動已能應付真實專案裡約八成的問題。

讀取回應文字

現在具備了兩個前提:請求已完成(就緒狀態)、伺服器回應正常(狀態碼)。最後一步是取出資料——它保存在 responseText 屬性中。

伺服器端回什麼格式,完全由它自己決定:逗號分隔、管線符號分隔,或一整段長文字都可以。本範例中,伺服器回傳客戶的上一筆訂單與地址,中間以管線符號 | 分隔:

function updatePage() {
    if (request.readyState == 4) {
        if (request.status == 200) {
            var response = request.responseText.split("|");
            document.getElementById("order").value = response[0];
            document.getElementById("address").innerHTML =
                response[1].replace(/\n/g, "<br>");
        } else {
            alert("狀態碼:" + request.status);
        }
    }
}

先用 JavaScript 的 split() 依管線符號切開,得到陣列。第一個值(上一筆訂單)塞進 id 為 order 的欄位;第二個值(地址)需要多一點處理——因為裡面的換行是 \n,得替換成 XHTML 風格的 <br>,最後寫進 <div> 的內部 HTML。

結果就是表單突然被客戶資料填滿了:

如果回應內容可能含有使用者輸入,請改用 textContent 並手動處理換行,避免 innerHTML 帶來 XSS 風險。

還有一個 responseXML

另一個重要屬性是 responseXML。若伺服器選擇以 XML 回應,這個屬性就會裝著回應的 XML 文件。處理 XML 與處理純文字差很多,涉及解析、DOM 操作等課題,值得另闢篇幅細談。對許多簡單的 Ajax 應用來說,responseText 已經足夠;但很快你會發現,Ajax 也能很漂亮地處理 XML。

結語

整篇文章只講一個物件,聽起來有點極端,但你在每一個 Ajax 頁面中都會反覆用到它。把它的屬性與方法摸熟,之後無論用哪一套工具箱,出問題時你都有能力往下追一層,找出真正的原因。

現在市面上的框架大多把這些細節藏了起來,讓 Ajax 開發變得容易。但若不知道底下在做什麼,一旦框架出錯,你就只能撓頭或去論壇發問。理解如何直接使用 XMLHttpRequest,除錯與解決怪問題都會輕意很多。工具箱只有在你需要時真的能解決問題,才算好東西。

所以,去熟悉 XMLHttpRequest 吧。如果你手上已有用框架寫的 Ajax 程式碼,不妨試著改寫成直接使用這個物件——這是理解原理最好的練習。

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