DIV CSS 佈局教程網

二次封裝 jQuery Ajax 的實務做法詳解
編輯:AJAX基礎知識     

前言

Ajax 的全稱是 Asynchronous JavaScript and XML,即非同步的 javaScript 與 XML。

Ajax 涉及的技術

1. 以 CSS 和 XHTML 呈現。

2. 以 DOM 模型進行互動與動態顯示。

3. 以 XMLHttpRequest 與伺服器非同步通訊(核心)。

4. 以 JavaScript 綁定與呼叫。

前端處理資料時難免要與後端溝通。Ajax 是透過 XMLHttpRequest 物件與伺服器通訊,jQuery 在其之上封裝了 $.ajax,實用性強又簡單易用。本文示範如何再包一層:參考 express 的中介軟體概念處理資料、回傳 Promise(Deferred)物件以減少回調,讓 Ajax 寫起來更簡潔優雅。

 $.ajax({
    url: url,
    data: data,
    dataType: 'json',
    type: 'get',
    success: new Function () {},
    error: new Function () {},
    .......
})

大部分時候,我們只要傳入 url 與 data,就能拿到想要的資料。

痛點

但在真實專案中使用 $.ajax,仍有幾個惱人的地方。

如今幾乎所有專案的非同步介面都會再包一層結構,把後端處理業務時的資訊一起帶回來,於是回傳從單純的 data 變成了:

{code: 200, data:{}, err_msg:''}

如果每個請求回來都要先判斷 code 是否正確,再決定要做業務處理還是跳錯誤提示,整個專案寫下來實在冗餘:

 $.ajax({
    url: url,
    data: data,
    success: function (data) {
        if (data.code == 200) {
            dosomething()
        } else {
            alert(data.err_msg);
        }
    }
})

為了解掉這個問題,我們用一個函式再包一層,把「判斷成功與否,然後處理業務或提示錯誤」抽成公共邏輯:

 util.ajax = function (obj, successFn) {
    $.ajax({
        url: obj.url || '/interface',
        data: obj.data || {},
        dataType: obj.dataType || 'json',
        type: obj.type || 'get',
        success: function (data) {
            if (data.code != 200) {
                alert(data.err_msg);
            } else {
                successFn(data.data)
            }
        },
        error: function (err) {
            alert(err)
        }
    })
}

改用 Promise

用 util.ajax 取代 $.ajax,就不必在每處重複判斷業務錯誤。接著再進一步:不用回調,改用 promise 風格呼叫,回調巢狀消失,程式碼自然清晰:

 util.ajax = function (obj) {
    var deferred = $.Deferred();
    $.ajax({
        url: obj.url || '/interface',
        data: obj.data || {},
        dataType: obj.dataType || 'json',
        type: obj.type || 'get',
    }).success(function (data) {
        if (data.code != 200) {
            deferred.reject(data.err_msg);
        } else {
            deferred.resolve(data.data)
        }
    }).error(function (err) {
        deferred.reject('接口出錯,請重試');
    })
    return deferred.fail(function (err) {
        alert(err)
    });
}

// 調用
var obj = {
    url: '/interface',
    data: {
        interface_name: 'name',
        interface_params: JSON.stringify({})
    }
};
util.ajax(obj)
    .done(function (data) {
        dosomething(data)
    })

加入中介軟體

這是公共方法,但實務上難免遇到差異化的處理需求。我們參考 express,引入中介軟體來解決:

 util.ajax = function (obj, middleware) {
    var deferred = $.Deferred();
    $.ajax({
        url: obj.url || '/interface',
        data: obj.data || {},
        dataType: obj.dataType || 'json',
        type: obj.type || 'get',
    }).success(function (data) {
        if (data.code != 200) {
            deferred.reject(data.err_msg);
        } else {
            deferred.resolve(data.data)
        }
    }).error(function (err) {
        deferred.reject('接口出錯,請重試');
    })

    // 添加中間件
    if (!middleware) {
        middleware = function () {};
    }

    return deferred.done(middleware).fail(function (err) {
        message({
            content: err,
            type: 'error',
            showLeftIcon: true,
            duration: 5000
        });
    });
}

// 調用
var obj = {
    url: '/interface',
    data: {
        interface_name: 'name',
        interface_params: JSON.stringify({})
    }
};
var middleware = function (data) {
    data.forEach(function (item) {
        item.fullName = item.firstName + item.lastName
    })
}
util.ajax(obj, middleware)
    .done(function (data) {
        console.log(data.fullName)
    })

三個改進層層疊上去,封裝的價值就很清楚了:錯誤判斷只寫一次、回調改鏈式、差異化邏輯由呼叫端以中介函式注入。這樣的 util.ajax 看起來已經不太像 jQuery 的 $.ajax,而比較像團隊自己的資料存取層——這正是二次封裝的目的。

總結

以上就是本文的全部內容,希望對你的學習或工作有所幫助。有疑問歡迎留言交流。

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