DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML與XSLT
XMLHttpRequest 物件全解:建立方式、屬性與方法逐一說明
編輯:XML與XSLT     

XMLHttpRequest 是什麼

最通用的定義是:XMLHttpRequest 是一套 API,讓 JavaScript、VBScript、JScript 等腳本語言能透過 HTTP 協定傳送或接收 XML 及其他格式的資料。它最大的用處,是在不重新載入整個頁面的前提下更新頁面的局部內容——這正是 AJAX 的核心能力之一。

微軟官方文件(MSDN)的描述是:XmlHttp 提供用戶端與 HTTP 伺服器通訊的協定,用戶端可透過 XmlHttp 物件向伺服器送出請求,再用 XML DOM 處理回應。

這個技術其實很早就出現了,只是早期瀏覽器支援不足,僅有 IE 支援,多數網頁程式設計師並未真正採用。後來 Mozilla 與 Safari 把它當成事實標準實作,主流瀏覽器陸續跟進。但要特別注意:XMLHttpRequest 目前並非 W3C 標準(編按:現今已由 W3C 標準化為 XMLHttpRequest),因此在各家瀏覽器上的行為仍有些差異。

建立物件

IE 把 XMLHttpRequest 實作為一個 ActiveX 物件,其他瀏覽器(Firefox、Safari、Opera)則實作為原生的 JavaScript 物件。因此建立時必須做能力偵測:

<script type="text/javascript">
var xmlhttp;

function createXMLHttpRequest() {
    if (window.ActiveXObject) {
        // IE:透過 ActiveXObject 建立
        xmlhttp = new ActiveXObject("Microsoft.XMLHTTP");
    }
    else if (window.XMLHttpRequest) {
        // 其他瀏覽器:原生 JavaScript 物件
        xmlhttp = new XMLHttpRequest();
    }
}
</script>

方法

open()

建立一個新的 HTTP 請求,指定方法、URL 與驗證資訊。

oXMLHttpRequest.open(bstrMethod, bstrUrl, varAsync, bstrUser, bstrPassword);
  • bstrMethod:HTTP 方法,如 POST、GET、PUT、PROPFIND,大小寫不敏感。
  • bstrUrl:請求的 URL,可為絕對或相對位址。
  • varAsync(選填):布林值,指定是否為非同步。預設 true;若為 true,狀態改變時會呼叫 onreadystatechange 指定的回呼函式。
  • bstrUser(選填):伺服器需要驗證時的用戶名。若未指定且伺服器要求驗證,會跳出驗證視窗。
  • bstrPassword(選填):驗證用的密碼。若用戶名為空則忽略。

呼叫此方法後,接著呼叫 send() 把資料送出去。

send()

oXMLHttpRequest.send(varBody);

把請求送到 HTTP 伺服器並接收回應。參數 varBody 是欲傳送的資料。同步或異步取決於 open() 的 varAsync 參數:若為 false,此方法會等到請求完成或超時才回傳;若為 true,則立即回傳。

varBody 可接受 BSTR、UI1 的 SAFEARRAY、XML DOM 物件或 IStream。編碼行為依型別而異:BSTR 會以 UTF-8 編碼,需自行設定含 charset 的 Content-Type 標頭;XML DOM 物件會採用文件中宣告的編碼,若無宣告則預設 UTF-8;SAFEARRAY 與 IStream 則原樣送出,需自行設定 Content-Type。

getAllResponseHeaders() 與 getResponseHeader()

strValue = oXMLHttpRequest.getAllResponseHeaders();
strValue = oXMLHttpRequest.getResponseHeader(bstrHeader);

前者取回所有 HTTP 標頭,每組名稱與值以冒號分隔、以 \r\n 結尾;後者取得指定標頭的值。兩者都必須在 send() 完成後才能呼叫。

setRequestHeader()

oXMLHttpRequest.setRequestHeader(bstrHeader, bstrValue);

單獨指定某個請求標頭。若同名標頭已存在則覆寫。必須在 open() 之後呼叫。

abort()

oXMLHttpRequest.abort();

取消目前的請求,呼叫後物件會回到未初始化狀態。

屬性

onreadystatechange

指定 readyState 改變時要觸發的事件處理常式。此屬性只寫,屬於 W3C DOM 物件的擴充。

readyState

回傳請求的目前狀態,為唯讀的長整數:

  • 0(未初始化):物件已建立,但尚未呼叫 open()。
  • 1(初始化):open() 已呼叫,但尚未呼叫 send()。
  • 2(傳送資料):send() 已呼叫,但狀態與標頭仍未知。
  • 3(資料傳送中):已收到部分資料,此時讀取 responseBody 或 responseText 會出錯。
  • 4(完成):資料接收完畢,可完整讀取回應內容。

回應相關屬性

  • responseBody:以無符號陣列形式回傳未解碼的其二進位資料。
  • responseStream:以 ADO Stream 物件形式回傳回應。
  • responseText:以字串回傳回應。XMLHTTP 預設以 UTF-8 解碼,若回應帶有 BOM,則可解碼 UCS-2(大/小端)或 UCS-4 資料。注意此屬性不處理 XML 文件中的編碼宣告,那要用 responseXML。
  • responseXML:把回應格式化為 XML DOM 物件後回傳。若回應不是格式良好的 XML,此屬性本身不回傳錯誤物件,需從 DOM 物件取得錯誤資訊。

status 與 statusText

status 回傳標準 HTTP 狀態碼(長整數、唯讀),statusText 回傳響應行狀態(字串、唯讀)。兩者都必須在資料傳送並接收完畢後才能取得。常見狀態碼包括 200 OK、201 Created、204 No Content、301 Moved Permanently、304 Not Modified、400 Bad Request、401 Unauthorized、403 Forbidden、404 Not Found、408 Request Timeout、500 Internal Server Error、502 Bad Gateway、503 Service Unavailable 等。

完整範例骨架

function PostOrder(xmldoc) {
    createXMLHttpRequest();

    xmlhttp.open("GET", "https://localhost/example.htm", false);

    xmlhttp.onreadystatechange = HandleStateChange;

    xmlhttp.send(xmldoc);

    alert(xmlhttp.getAllResponseHeaders());
    alert(xmlhttp.getResponseHeader("Content-Type"));
}

function HandleStateChange() {
    if (xmlhttp.readyState == 4) {
        alert(xmlhttp.responseText);
        alert("Result = " + xmlhttp.responseXML.xml);
        alert(xmlhttp.status);
        alert(xmlhttp.statusText);
    }
}

實務上的提醒:非同步(第三個參數為 true)是絕大多數場景的正確選擇,同步請求會凍結整個使用者介面。另外,基於同源政策,用戶端腳本只能向同網域的資源發出請求,跨網域需另用 CORS 或伺服器端代理處理。

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