AJAX 上手篇
第一步 – 說聲「請」 (又稱為「怎么發出 XMLHttpRequest」)
為了用 JavaScript 對服務器發送 HTTP 要求,你必須先以相關的類別(class)制出實體(instance)。Internet
Explorer 首先以 ActiveX 對象方式提供 XMLHTTP
類別,而 Mozilla、Safari及其它瀏覽器則隨后以 XMLHttpRequest
類別支持此 ActiveX 對象中的類別及屬性。
因此,如果想跨瀏覽器,那么可以這么寫:?
if
?(window.XMLHttpRequest)?{?
//
?Mozilla,?Safari,?
????http_request?
=
?
new
?XMLHttpRequest();
}?
else
?
if
?(window.ActiveXObject)?{?
//
?IE
????http_request?
=
?
new
?ActiveXObject(
"
Microsoft.XMLHTTP
"
);
}
(由于這段程序僅供說明,所以是采最簡方式寫出。本文第三步中有另一種我們比較常用的寫法。)
有些版本的 Mozilla 瀏覽器在服務器送回的數據未含 XML mime-type 文件頭(header)時會出錯。為了避免這個問題,你可以用下列方法覆寫服務器傳回的檔頭,以免傳回的不是text/xml
。
http_request?
=
?
new
?XMLHttpRequest();
http_request.overrideMimeType('text
/
xml');
接下來是要決定服務器傳回資料后的處理方式,此時你只要以 onreadystatechange
這個屬性指明要處理傳回值的
JavaScript 函式名稱即可,例如:
http_request.onreadystatechange?
=
?nameOfTheFunction;
注意,指定的函式名稱后不加括號也沒有參數。除了指定函式名稱外,你也能用 Javascript 實時定義函式的方法來定一個新的處理函式,如下:
http_request.onreadystatechange?
=
?
function
(){
????
//
?做些事
};
決定處理方式之后你得確實發出 request,此時需叫用 HTTP request 類別的 open()
及 send()
方法,如下:
http_request.open('GET',?'http:
//
www.example.org/some.file',?true);
http_request.send(
null
);
-
open()
的第一個參數是
???? HTTP request 的方法,也就是從
???? GET、POST、HEAD 中擇一使用,亦可用你主機上支持的方式。為遵循 HTTP 標準,請記得這些方法都是大寫,不然有的瀏覽器(如 Firefox)或許不會理你。其它 HTTP request 可以支持的方法列表請參考
???? W3C 規格書 (http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html)。
- 第二個參數是目標 URL。基于安全考慮,你不能叫用同網域以外的網頁。如果網域不同,則叫用
???? open()
時會出現「權限不足,拒絕存取」那類的錯誤。通常大伙會犯的錯誤多為在 domain.tld 網的網站下呼叫 www.domain.tld 中的網頁,僅是一點點差別都不行。
????
- 第三個參數決定此 request 是否不同步進行,如果設定為
???? TRUE
則即使服務器尚未傳回數據也會繼續執行其余的程序,這也就是 AJAX 中第一個 A 代表的意義。
send()
的參數在以 POST 發出 request 時可以是任何想傳給服務器的東西,而數據則以查詢字符串的方式列出,例如:
?
name
=
value
&
anothername
=
othervalue
&
so
=
on
不過如果你想要以 POST 方式傳送數據,則必須先將 MIME 型態改好,如下:
http_request.setRequestHeader('Content
-
Type',?'application
/
x
-
www
-
form
-
urlencoded');
否則服務器就不會理你傳過來的數據了。
第二步 – 「就上咩!」(又稱為「處理服務器傳回的數據」)
傳出 request 時必須提供處理傳回值的函式名稱。
http_request.onreadystatechange?
=
?nameOfTheFunction;
////////////////////////////////////////////////////////////////////
//但是,FireFox 對onreadyStateChange沒有反應,怎么辦,這個方法不能用在
//FireFox 中,有沒有其它的方法?
//??????Added by www.besook.com 2006-03-19
//////////////////////////////////////////////////////////////
那么來看看這個函式該做些什么。首先,它必須檢查 request 目前的狀態:如果狀態值為 4 代表服務器已經傳回所有信息了,便可以開始解析所得信息。
if
?(http_request.readyState?
==
?
4
)?{
????
//
?一切?ok,?繼續解析
}?
else
?{
????
//
?還沒完成
}
readyState
所有可能的值如下:
- 0 (還沒開始)
- 1 (讀取中)
- 2 (已讀取)
- 3 (信息交換中)
- 4 (一切完成)
(資料來源: MSDN (http://msdn.microsoft.com/workshop/author/dhtml/reference/properties/readystate_1.asp))
接下來要檢查服務器傳回的 HTTP 狀態碼。所有狀態碼列表可于 W3C
網站 (http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html)上查到,但我們要管的是200 OK
這種狀態。
if
?(http_request.status?
==
?
200
)?{
????
//
?萬事具備
}?
else
?{
????
//
?似乎有點問題,或許服務器傳回了?404?(查無此頁)?或者?500?(內部錯誤)?什么的
}
檢查傳回的 HTTP 狀態碼后,要怎么處理傳回的數據就由你決定了。有兩種存取數據的方式:
-
http_request.responseText
– 這樣會把傳回值當字符串用
????
-
http_request.responseXML
– 這樣會把傳回值視為
???? XMLDocument
對象,而后可用
???? JavaScript DOM 相關函式處理
第三步 - 萬事俱備 - 簡單范例
好,接著就做一次簡單的 HTTP 范例,演示方才的各項技巧。這段 JavaScript 會向服務器要一份里頭有「I'm
a test.」字樣的 HTML 文件(test.html
),而后以 alert()
將文件內容列出。
<
script?type
=
"
text/javascript
"
?language
=
"
javascript
"
>
????
var
?http_request?
=
?
false
;
????
function
?makeRequest(url)?{
????????http_request?
=
?
false
;
????????
if
?(window.XMLHttpRequest)?{?
//
?Mozilla,?Safari,
????????????http_request?
=
?
new
?XMLHttpRequest();
????????????
if
?(http_request.overrideMimeType)?{
????????????????http_request.overrideMimeType('text
/
xml');
????????????}
????????}?
else
?
if
?(window.ActiveXObject)?{?
//
?IE
????????????
try
?{
????????????????http_request?
=
?
new
?ActiveXObject(
"
Msxml2.XMLHTTP
"
);
????????????}?
catch
?(e)?{
????????????????
try
?{
????????????????????http_request?
=
?
new
?ActiveXObject(
"
Microsoft.XMLHTTP
"
);
????????????????}?
catch
?(e)?{}
????????????}
????????}
????????
if
?(
!
http_request)?{
????????????alert('Giving?up?:(?Cannot?create?an?XMLHTTP?instance');
????????????
return
?
false
;
????????}
????????http_request.onreadystatechange?
=
?alertContents;
????????http_request.open('GET',?url,?
true
);
????????http_request.send(
null
);
????}
????
function
?alertContents()?{
????????
if
?(http_request.readyState?
==
?
4
)?{
????????????
if
?(http_request.status?
==
?
200
)?{
????????????????alert(http_request.responseText);
????????????}?
else
?{
????????????????alert('There?was?a?problem?
with
?the?request.');
????????????}
????????}
????}
</
script
>
<
span
????style
=
"
cursor:?pointer;?text-decoration:?underline
"
????onclick
=
"
makeRequest('test.html')
"
>
????????Make?a?request
</
span
>
在此范例中:
- 首先使用者按下「Make a request」
- 這么一來就會呼叫
???? makeRequest()
函式,亦傳入參數值 test.html
(也就是那份 HTML 檔的名稱,放在同目錄下)
- 接著發出 request,而后會將主導權交給
???? onreadystatechange
指定的 alertContents()
函式
-
alertContents()
檢查響應是否正常,而后以 alert()
將 test.html
的內容列出
你可以由此測試本例 (http://www.w3clubs.com/mozdev/httprequest_test.html),也可以參考測試檔案 (http://www.w3clubs.com/mozdev/test.html)。
第四步 – 「X 檔案」(又稱為「處理 XML 響應值」)
前面的例子中,在收到 HTTP 傳回值后我們以對象的 reponseText
屬性使用 test.html
檔案的內容,接著來試試 responseXML
屬性的方法。
首先,我們得做個格式正確的 XML 文件,以便稍后取用。此檔名喚 test.xml
,內容如下:
<?
xml?version="1.0"?
?>
<
root
>
????I'm?a?test.
</
root
>
在程序中,我們叫用檔案的地方只須略事修改如下:
...
onclick
=
"
makeRequest('test.xml')
"
...
接著在 alertContents()
中,我們必須將 alert(http_request.responseText);
改成這樣:
var
?xmldoc?
=
?http_request.responseXML;
var
?root_node?
=
?xmldoc.getElementsByTagName('root').item(
0
);
alert(root_node.firstChild.data);
這樣一來我們便可取得
responseXML
所傳回的
XMLDocument
對象,而后以 DOM 相關的方法取用
XML 文件內容。你可以參考
test.xml
的原始碼 (
http://www.w3clubs.com/mozdev/test.xml)
以及修改過后的
測試程序 (
http://www.w3clubs.com/mozdev/httprequest_test_xml.html)。
例如數據庫中某一字段存了這樣一個數:3.1415926
但實際中只需要精確取到小數點后兩位的數字:3.14
那就可以這樣取出:
select cast(3.1415926 as decimal(9,2)) as value
如果要取精確到小數點后5位,只須改成:
select cast(3.1415926 as decimal(9,5)) as value。