前后分离模型之封装 Api 调用

1、前后分离模型之封装 Api 调用Ajax 和异步处理调用 API 访问数据采用的 Ajax 方式，这是一个异步过程，异步过程最基本的处理方式是事件或回调，其实这两种处理方式实现原理差不多，都需要在调用异步过程的时候传入一个在异步过程结束的时候调用的接口。比如 jQuery Ajax 的success就是典型的回调参数。不过使用 jQuery 处理异步推荐使用 Promise 处理方式。Promise 处理方式也是通过注册回调函数来完成的。jQuery 的 Promise 和 ES6 的标准 Promise 有点不一样，但在then上可以兼容，通常称为 thenable。jQuery 的 Promise 没有提供.catch()接口，但它自己定义的.done()、.fail()和.always()三个注册回调的方式也很有特色，用起来很方便，它是在事件的方式来注册的（即，可以注册多个同类型的处理函数，在该触发的时候都会触发）。当然更直观的一点的处理方式是使用 ES2017 带来的 async/await 方式，可以用同步代码的形式来写异步代码，当然也有一些坑在里面。对于前端工程师来说，最大

2、的坑就是有些浏览器不支持，需要进行转译，所以如果前端代码没有构建过程，一般还是就用 ES5 的语法兼容性好一些（jQuery 的 Promise 是支持 ES5 的，但是标准 Promise 要 ES6 以后才可以使用）。自己封装工具函数在处理 Ajax 的过程中，虽然有现成的库（比如 jQuery.ajax，axios 等），它毕竟是为了通用目的设计的，在使用的时候仍然不免繁琐。而在项目中，对 Api 进行调用的过程几乎都大同小异。如果设计得当，就连错误处理的方式都会是一样的。因此，在项目内的 Ajax 调用其实可以进行进一步的封装，使之在项目内使用起来更方便。如果接口方式发生变化，修改起来也更容易。比如，当前接口要求使用 POST 方法调用（暂不考虑 RESTful），参数必须包括action，返回的数据以 JSON 方式提供，如果出错，只要不是服务器异常都会返回特定的 JSON 数据，包括一个不等于 0 的code和可选的message属性。那么用 jQuery 写这么一个 Ajax 调用，大概是这样const apiUrl = http:/ .ajax(url, type: p

3、ost, dataType: json, data: action: login, username: uname, password: passwd ) .done(function(data) if (data.code) alert(data.message | 登录失败！); else window.location.assign(home); ) .fail(function() alert(服务器错误); );初步封装同一项目中，这样的 Ajax 调用，基本上只有data部分和.done回调中的else部分不同，所以进行一次封装会大大减少代码量，可以这样封装function appAjax(action, params) var deffered = $.Deferred(); jQuery .ajax(apiUrl, type: post, dataType: json, data: $.extend( action: action , params) ) .done(function(data) / 当 code 为 0 或省略时，表示没有错误， / 其它值表示错误代码

4、 if (data.code) if (data.message) / 如果服务器返回了消息，那么向用户呈现消息 / resolve(null)，表示不需要后续进行业务处理 alert(data.message); deffered.resolve(); else / 如果服务器没返回消息，那么把 data 丢给外面的业务处理 deferred.reject(data); else / 正常返回数据的情况 deffered.resolve(data); ) .fail(function() / Ajax 调用失败，向用户呈现消息，同时不需要进行后续的业务处理 http:/ alert(服务器错误); deffered.resolve(); ); return deferred.promise();而业务层的调用就很简单了appAjax(login, username: uname, password: passwd).done(function(data) if (data) window.location.assign(home); ).fail(function() alert(登

5、录失败););更换 API 调用接口上面的封装对调用接口和返回数据进行了统一处理，把大部分项目接口约定的内容都处理掉了，剩下在每次调用时需要处理的就是纯粹的业务。现在项目组决定不用 jQuery 的 Ajax，而是采用 axios 来调用 API（axios 不见得就比 jQuery 好，这里只是举例），那么只需要修改一下appAjax()的实现即可。所有业务调用都不需要修改。假设现在的目标环境仍然是 ES5，那么需要第三方 Promise 提供，这里拟用 Bluebird，兼容原生 Promise 接口（在 HTML 中引入，未直接出现在 JS 代码中）。function appAjax(action, params) var deffered = $.Deferred(); axios .post(apiUrl, data: $.extend( action: action , params) ) .then(function(data) . , function() . ); return deferred.promise();这次的封装采用了 axios 来实现 Web Api

6、 调用。但是为了保持原来的接口（jQuery Promise 对象有提供.done()、.fail()和.always()事件处理），appAjax仍然不得不返回 jQuery Promise。这样，即使所有地方都不再需要使用 jQuery，这里仍然得用。去除 jQuery就只在这里使用 jQuery 总让人感觉如芒在背，想把它去掉。有两个办法1. 修改所有业务中的调用，去掉.done()、.fail()和.always()，改成.then()。这一步工作量较大，但基本无痛，因为 jQuery Promise 本身支持.then()。但是有一点需要特别注意，这一点稍后说明2. 自己写个适配器，兼容 jQuery Promise 的接口，工作量也不小，但关键是要充分测试，避免差错。上面提到第 1 种方法中有一点需要特别注意，那就是.then()和.done()系列函数在处理方式上有所不同。.then()是按 Promise 的特性设计的，它返回的是另一个 Promise 对象；而.done()系列函数是按事件机制实现的，返回的是原来的 Promise 对象。所以像下面这样的代码在修改时就

7、要注意了appAjax(url, params) .done(function(data) console.log(第 1 处处理, data) ) .done(function(data) console.log(第 2 处处理, data) );/ 第 1 处处理 / 第 2 处处理 http:/简单的把.done()改成.then()之后（注意不需要使用 Bluebird，因为 jQuery Promise 支持.then()）appAjax(url, params) .then(function(data) console.log(第 1 处处理, data); ) .then(function(data) console.log(第 2 处处理, data); );/ 第 1 处处理 / 第 2 处处理 undefined原因上面已经讲了，这里正确的处理方式是合并多个 done 的代码，或者在.then()处理函数中返回data：appAjax(url, params) .then(function(data) console.log(第 1 处处理, data); return data; ) .then(function(data) console.log(第 2 处处理, data); );使用 Promise 接口改善设计我们的appAjax()接口部分也可以设计成 Promise 实现，这是一个更通用的接口。既使用不用 ES2015+ 特性，也可以使用像 jQuery Promise 或 Bluebird 这样的三方库提供的 Promise。function appAjax(action, params) / axios 依赖于 Promise，ES5 中可以使用 Bluebird 提供的 Promise return axios .post(apiUrl, dat

《前后分离模型之封装 Api 调用》由会员m****分享，可在线阅读，更多相关《前后分离模型之封装 Api 调用》请在金锄头文库上搜索。