DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
Ajax 封裝實作(二):讓請求參數可以直接傳物件
編輯:AJAX詳解     

接上一篇。這次引入一個私有函式 _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 中「同名多值」的處理分支。
  • 送出按鈕(button、image)不列入資料,避免把 UI 元素誤送後端。
  • 最後把 form 與 el 設為 null,及早中斷參考,對舊版 IE 的記憶體回收有實際幫助。

兩者搭配之後,Ajax 送出表單只剩一行:

Ajax.request('servlet/ServletJSON', {
    method  : 'POST',
    data    : formToHash(document.getElementById('myForm')),
    success : function(xhr){ /* 處理回應 */ }
});

下一篇要處理的是回應的問題:responseText 是純文字、responseXML 是 XML 文件,而現在越來越多人用 JSON。如何讓呼叫端用一致的方式取得這三種結果,就是下一個改進目標。

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