前言
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,而比較像團隊自己的資料存取層——這正是二次封裝的目的。
總結
以上就是本文的全部內容,希望對你的學習或工作有所幫助。有疑問歡迎留言交流。