小程序php接口封装,Promise实践 实现微信小程序接口封装

相信很多开发者都遇到过回调地狱的问题。由于微信小程序的API基本都是基于回调函数的异步操作,如果不使用其他框架或者封装API,特别是使用较多的wx.request(),基本很快就会遇到回调地狱的问题,维护起来十分痛苦。

举个例子

假设此时在正在开发一个社交小程序,其中有一个功能的是,小程序用户在登录后,可以查看附近的人。

假设使用以下的实现思路,我们通过wx.getLocation()获取用户当前位置,然后通过wx.request()请求后端数据。但在此之前需要登录,参考之前官方文档推荐的登录方式,先调用wx.login()获取code,再用wx.request()请求开发者服务器,成功返回自定义登录态(一般为access_token或其他令牌形式),之后再用自定义登录态请求业务数据。

为了方便看,我把官方文档里的登录流程贴出来⬇️

ff72ba935332317bfdb7e471f2e493aa.png

思路确定后,开始尝试coding(以下代码不建议看完)/* 以下为Page对象的方法 */

getNearby: function() {

// 判断是否已认证,可采用wx.checkSession()方案

if (isAuth) {

// TODO: 获取业务数据

return

}

// wx.login获取code

wx.login({

success(res) {

if (res.code) {

// 获取自定义登录态

wx.request({

url,

method,

headers,

data,

success(res) {

// 请求成功

if (res.statuCode === 200) {

// 读取响应体中的自定义登录态

let token = res.data.token

// 保存自定义登录态

wx.setStorageSync("assess_token", token)

// 获取位置信息

wx.getLocation({

success(res) {

let { latitude, longitude } = res

// 请求业务数据

wx.request({

url,

method,

header,

data: { latitude, longitude },

success(res) {

// 请求成功

if (res.statuCode === 200) {

let data = res.data

// 数据渲染到V层

this.setData({ list: data })

}

// 请求失败

else if (res.statuCode === 400) {

// TODO

}

// 其他错误情况状态码处理

// TODO

},

fail(err) {

// 调用失败处理

}

})

},

fail(err) {

// 调用失败处理

}

})

}

// 请求失败

else if (res.statuCode == 400) {

// TODO

}

// 其他错误情况的状态码处理

},

fail(err) {

// 调用失败处理

}

})

}

else {

// TODO

// 登录失败

}

},

fail(err) {

// wx.login()调用失败处理

// TODO: ...

}

})

}

回调地狱出现了。气功波代码,别说别人,就连自己看都会觉得恶心。

某天英明的产品经理站了出来,说我们可以加点XXXXX,你可能还得找个地方嵌套其他微信接口或者多加几个if else分支,到时候就找个地方哭吧。

解决方案

从某种意义上来说,当今风暴式的前端生态,仰仗于Node以及ES6+的出现。

ES6后对于异步有多种解决方案。一种是采用generator/yield,但generator函数使用起来其实比较麻烦。另外一种是采用Promise,相对比较简单。ES7也可以采用async/await,但本质上async/await也是基于Promise。下面介绍Promise。

Promise

Promise创建

创建Promise很简单,Promise本身是一个构造函数。通过new创建。构造函数的参数为一个回调函数,回调函数有两个参数为resolve和reject(无需手动维护)。resolve和reject是用来改变状态。关于状态放到后边讲。// Promise实例的创建

let p = new Promise((resolve, reject) => {

// TODO

})

Promise有个缺点,一旦创建便会立刻执行。所以一般会用一个函数进行包装。let getPromise = () => {

return new Promise((resolve, reject) => {

// TODO

})

}

Promise状态

Promise实例有三种状态,pending、resolved和rejected,Promise实例创建后就会处于pending状态。回调函数中的resolve和reject就是用来改变Promise实例状态的。当调用resolve时,Promise实例会从pending变成resolved状态,表示成功。当调用reject时,Promise实例会从pending变成rejected状态,表示失败。let getPromise = () => {

return new Promise((resolve, reject) => {

// TODO

// 处理结果

if (result) {

resolve(successObject)

}

else {

reject(error)

}

})

}

常用方法

最常用的方法为then()和catch()这两个方法,通过then()的传递效用就可以解决回调地狱的问题。

其中then()可接收两个参数,都是回调函数,第一个回调函数用来处理resolved状态,参数为Promise实例调用resolve传递的成功对象。第二回调函数用来处理rejected状态,参数为调用Promise实例调用reject传递的错误对象。

实际中then()我们一般只用来处理resolved的情况,即只传递第一个回调函数。对于rejected情况更多是采用catch()统一处理。let getPromise = () => {

return new Promise((resolve, reject) => {

// TODO

// 处理结果

if (result) {

resolve(successObject)

}

else {

reject(error)

}

})

}

getPromise()

.then(res => {

console.log(res)

// TODO

})

.catch(err => {

//TODO

})

使用then()方法可以继续返回一个Promise对象,通过return一个新的Promise,可以持续的向下传递。getPromise()

.then(res => {//第一层Promise

console.log(res)

// TODO

return getPromise()

)

.then(res => {// 第二层Promise

console.log(res)

// TODO

})

.catch(err => {

// TODO

})

其他常用方法有诸如Promise.all(),Promise.race()。当需要等待多个Promise结果时会采用。两个方法都是接收一个由Promise组成的对象数组。使用Promise.all()时,只有当全部的Promise对象全部resolved Promise.all()状态才是resolved。而Promise.race()只需有一个Promise对象为resolved时,其状态就为resolved。

更多方法可阅读相关文档。

封装小程序接口

学习了Promise基础,通过封装异步操作,使用Promise链就可以解决回调地狱问题。

因为wx.request()使用频率比较高,先对wx.request()封装。/* 可以将公用的方法挂在app.js中 */

request: function(method, url, header, data) {

return new Promise((resolve, reject) => {

wx.request({

method,

url,

header,

data,

success(res) {

resolve(res)

},

fail(err) {

reject(err)

}

})

})

}

基本框架就这样,我们可以进一步修改,比如请求url的基础路径,添加一些公用的header,针对状态码做一些全局处理等。request: function(method, url, header = {}, data = {}) {

// 启动时可将storage中的令牌挂到app.js

let token = app.assess_token

if (token) {

header["Authorization"] = token

}

return new Promise((resolve, reject) => {

wx.request({

method,

url: "https://api.domain.com/v1" + url,

header,

data,

success(res) {

// 请求成功

if (res.statusCode === 200) {

resolve(res)

}

// 请求成功无响应体

else if (res.statusCode === 204) {

/*

可做一些成功提示,

如调用wx.showToast()、wx.showModal()或自定义弹出层等

*/

resolve(res)

}

// 未认证

else if (res.statusCode === 401) {

/* 可做一些错误提示,或者直接跳转至登录页面等 */

reject(res)

}

else if (res.statusCode == 400) {

/* 可做一些错误提示*/

reject(res)

}

else if (res.statuCode === 403) {

/* 无权限错误提示*/

reject(res)

}

// ...其他状态码处理

},

fail(err) {

/* 可做一些全局错误提示,如网络错误等 */

reject(err)

}

})

})

}

封装之后,举个例子,发送请求就可以修改为/* 方法体中 */

let app = getApp()

app.request("POST", "/auth", {}, { username, password })

.then(res => { // 第一层请求

// TODO 成功处理

return app.request("GET", "/goods", {}, {})

})

.then(res => {// 第二层请求

// TODO 成功处理

// 渲染视图

})

.catch(err => {

// TODO 错误处理

})

封装一下其他的微信接口/* 可以将公用的方法挂在app.js中 */

wxLogin: function() {

return new Promise((resovle, reject) => {

wx.login({

success(res) {

if (res.code) {

resovle(res)

}

else {

reject({ message: "登录失败" })

}

},

fail(err) {

reject(err)

}

})

})

}

getLocation: function() {

return new Promise((resolve, reject) => {

wx.getLocation({

success(res) {

resolve(res)

},

fail(err) {

reject(err)

}

})

})

}

对于最初的例子,可以就修改为/* Page对象的方法 */

getNearby: function() {

// 判断是否已认证,可采用wx.checkSession()方案

if (isAuth) {

// TODO: 获取业务数据

return

}

app.wxLogin()

.then(res => {

// 将code发送给开发者服务器,获取自定义登录态

return app.request("POST", "/auth", {}, { code, res.code })

})

.then(res => {

// 保存自定义登录态

setStorage("access_token", res.data.access_token)

// TODO: 其他登录成功操作...

return app.getLocation()

})

.then(({ latitude, longitude }) => {

let url = "/nearby?latitude=" + latitude + "&longitude=" + longitude

return app.request("GET", url)

})

.then(res => {

// TODO: 数据处理

let data = res.data

// 渲染视图层

this.setData({ data })

})

.catch(err => {

// TODO 错误处理

})

}

之后若有需添加新的请求或者其他异步操作,直接在Promise链上操作就行了。

推荐教程:《微信小程序》

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值