接上一篇。這次引入一個私有函式 _serialize,負責把 JavaScript 物件序列化成 HTTP 所需的參數格式,支援兩種結構:
{name:'jack', age:20} --> name=jack&age=20
{fruit:['apple','banana','orange']} --> fruit=apple&fruit=banana&fruit=orange
改完之後,data 就能直接寫成物件:
Ajax.request('servlet/ServletJSON', {
data : {name:'jack', age:20},
success : function(xhr){
// 在這裡處理 xhr
},
failure : function(xhr){
// 失敗時的處理
}
});
var Ajax =
function(){
function request(url, opt){
function fn(){}
var async = opt.async !== false,
method = opt.method || 'GET',
encode = opt.encode || 'UTF-8',
data = opt.data || null,
success = opt.success || fn,
failure = opt.failure || fn;
method = method.toUpperCase();
if (data && typeof data == 'object'){ // 物件轉成鍵值字串
data = _serialize(data);
}
if (method == 'GET' && data){
url += (url.indexOf('?') == -1 ? '?' : '&') + data;
data = null;
}
var xhr = window.XMLHttpRequest ? new XMLHttpRequest()
: new ActiveXObject('Microsoft.XMLHTTP');
xhr.onreadystatechange = function(){
_onStateChange(xhr, success, failure);
};
xhr.open(method, url, async);
if (method == 'POST'){
xhr.setRequestHeader('Content-type',
'application/x-www-form-urlencoded;charset=' + encode);
}
xhr.send(data);
return xhr;
}
function _serialize(obj){
var a = [];
for (var k in obj){
var val = obj[k];
if (val.constructor == Array){
for (var i = 0, len = val.length; i < len; i++){
a.push(k + '=' + encodeURIComponent(val[i]));
}
} else {
a.push(k + '=' + encodeURIComponent(val));
}
}
return a.join('&');
}
function _onStateChange(xhr, success, failure){
if (xhr.readyState == 4){
var s = xhr.status;
if (s >= 200 && s < 300){
success(xhr);
} else {
failure(xhr);
}
}
}
return { request: request };
}();
這次除了序列化,還多加了 encode 設定(預設 UTF-8),並把它帶進 POST 的 Content-type 標頭,避免中文或特殊字元在編碼不一致時變成亂碼。
單看「data 可以是物件」似乎沒什麼大用,但一旦與表單結合,價值就出現了。當你想用 Ajax 而非傳統方式送出表單時,把表單元素序列化成請求參數是一件麻煩事。以下這個 formToHash 工具函式,把表單元素按鍵值形式轉為物件返回:
function formToHash(form){
var hash = {}, el;
for (var i = 0, len = form.elements.length; i < len; i++){
el = form.elements[i];
if (el.name == "" || el.disabled) continue;
switch (el.tagName.toLowerCase()){
case "fieldset":
break;
case "input":
switch (el.type.toLowerCase()){
case "radio":
if (el.checked)
hash[el.name] = el.value;
break;
case "checkbox":
if (el.checked){
if (!hash[el.name]){
hash[el.name] = [el.value];
} else {
hash[el.name].push(el.value);
}
}
break;
case "button":
case "image":
break;
default:
hash[el.name] = el.value;
break;
}
break;
case "select":
if (el.multiple){
for (var j = 0, lens = el.options.length; j < lens; j++){
if (el.options[j].selected){
if (!hash[el.name]){
hash[el.name] = [el.options[j].value];
} else {
hash[el.name].push(el.options[j].value);
}
}
}
} else {
hash[el.name] = el.value;
}
break;
default:
hash[el.name] = el.value;
break;
}
}
form = el = null; // 協助釋放參考
return hash;
}
幾個實作要點:
name 或已停用的元素直接跳過,與瀏覽器實際送出表單的行為一致。<select> 會收集成陣列,正好對應 _serialize 中「同名多值」的處理分支。form 與 el 設為 null,及早中斷參考,對舊版 IE 的記憶體回收有實際幫助。兩者搭配之後,Ajax 送出表單只剩一行:
Ajax.request('servlet/ServletJSON', {
method : 'POST',
data : formToHash(document.getElementById('myForm')),
success : function(xhr){ /* 處理回應 */ }
});
下一篇要處理的是回應的問題:responseText 是純文字、responseXML 是 XML 文件,而現在越來越多人用 JSON。如何讓呼叫端用一致的方式取得這三種結果,就是下一個改進目標。