AJAX幾乎每個專案都會用到,但網路上抄來的多數版本相容性都不理想。以下分兩部分:先是自己整理的可移植性較高的原生寫法,再是jQuery的 $.ajax()。
var ajax = function(){};
ajax.prototype = {
request: function(method, url, callback, postVars){
var xhr = this.createXhrObject();
xhr.onreadystatechange = function(){
if (xhr.readyState !== 4) return;
(xhr.status === 200) ?
callback.success(xhr.responseText, xhr.responseXML) :
callback.failure(xhr, xhr.status);
};
if (method !== 'POST'){
url += '?' + this.JSONStringify(postVars);
postVars = null;
}
xhr.open(method, url, true);
xhr.send(postVars);
},
createXhrObject: function(){
var methods = [
function(){ return new XMLHttpRequest(); },
function(){ return new ActiveXObject('Msxml2.XMLHTTP'); },
function(){ return new ActiveXObject('Microsoft.XMLHTTP'); }
];
for (var i = 0, len = methods.length; i < len; i++){
try {
methods[i]();
} catch(e){
continue;
}
// 找到可用的建構方式後快取起來,下次不必再試
this.createXhrObject = methods[i];
return methods[i]();
}
throw new Error('無法建立ajax物件');
},
JSONStringify: function(obj){
return JSON.stringify(obj)
.replace(/"|{|}/g, '')
.replace(/:/g, '=')
.replace(/,/g, '&');
}
};
// 使用方式
new ajax().request('GET', 'a.aspx', {
success: function(text){ console.log(text); },
failure: function(xhr, status){ console.log('失敗:' + status); }
}, { id: 1, type: '商品' });
這裡有兩個值得學的細節:createXhrObject() 用「逐一嘗試 + 覆寫自身」的手法做特性偵測,成功一次之後就不再重複嘗試;而 request() 把成功與失敗拆成兩個回呼,呼叫端不必再自己判斷狀態碼。
有了jQuery,AJAX寫起來輕penditure許多。高階的 $.get()、$.post() 之外,$.ajax() 提供了完整的設定能力。
<script type="text/javascript">
function textAjax(){
$.ajax({
type: 'GET', // 預設GET,另一常見選項為POST
url: 'ResponseText.aspx', // 預設為當前頁網址
dataType: 'html', // 預期伺服器回傳的資料類型
beforeSend: beforeSend, // 送出前
success: callback, // 成功
error: error, // 失敗
complete: complete // 無論成功失敗都會執行
});
}
function beforeSend(XMLHttpRequest){
$('#showResult').append('<div>發送請求……</div>');
}
function callback(msg){
$('#showResult').append('<div>請求成功,回傳資料:' + msg + '</div>');
}
function error(XMLHttpRequest, textStatus, errorThrown){
// 通常 textStatus 與 errorThrown 只有其中一個有值
$('#showResult').append('<div>請求出錯啦!</div>');
}
function complete(XMLHttpRequest, textStatus){
$('#showResult').append('<div>請求完成</div>');
}
</script>
<input value="Text_ajax函數" type="button" onclick="textAjax()" />
<div id="showResult"></div>
伺服器端只需輸出內容:
protected void Page_Load(object sender, EventArgs e){
Response.Write("呵呵!測試成功啦!");
}
方法一:送前編碼、收後解碼。注意encodeURI要用兩次,後端再解回來:
// 前端
data: { id: 1, type: encodeURI(encodeURI('商品')) }
// 後端
String type = request.getParameter("type");
type = URLDecoder.decode(type, "UTF-8");
方法二:設定contentType並標明charset。
contentType: "application/x-www-form-urlencoded; charset=UTF-8"
關鍵在 charset=UTF-8——少了它就不生效,而jQuery預設的contentType並不含這段。其他JS框架或直接操作XMLHttpRequest時,概念相同:設定標頭即可。另外別忘了jQuery內部已對參數做過一次 encodeURIComponent。
兩者相比,方法二不需要在後端多做解碼,因此更值得採用。