小程序在內(nèi)測的時候就已經(jīng)開始玩了,不過最開始的時候覺得,這sx東西東西怎么這么坑的樣子,網(wǎng)絡(luò)請求居然不是返回Promise而是用Callback的方式, 傳值居然不能把值寫在方法里只能用dataset,在這個全面組件化的大環(huán)境下居然不支持組件化... 其實最開始主要是書寫時習(xí)慣的問題,秉承著我又不做小程序開發(fā),就先忍著你的態(tài)度放任不管了。然而天有不測風(fēng)云,最近因為業(yè)務(wù)的需求不得不做小程序相關(guān)的開發(fā),我就倔脾氣果斷就不能忍了。果斷的把不爽的地方改成能按我喜歡的方式來走,其中還遇到了一些其他的坑,一個個慢慢填,并把這些記錄下來整理成了文章。 網(wǎng)絡(luò)請求網(wǎng)絡(luò)請求小程序提供了wx.request,這個是我最想吐槽的點, 仔細(xì)看一下 api,這貨不就是n年前的 $.ajax 嗎,好古老啊。 // 官方例子 wx.request({ url: 'test.php', //僅為示例,并非真實的接口地址 data: { x: '' , y: '' }, header: { 'content-type': 'application/json' // 默認(rèn)值 }, success: function(res) { console.log(res.data) } }) 現(xiàn)在還是只有一個請求就已經(jīng)感覺寫的很長了,如果一個頁面需要多個請求呢,如果請求的順序還有要求呢該怎么辦,各種嵌套又臭又長,如果要求所以請求都完成之后再顯示界面呢 瞬間懵逼。 這個時候我弱弱的看了一眼小程序的JS版本的支持,歐耶,比較良心的支持ES6。也就是說我們可以將其改成Promise是可能的。接下來看我如何改造。 /* utils/api.js 自定義網(wǎng)絡(luò)請求 */ const baseURL = 'https://yourapi.com' // 自己后臺API地址 const http = ({ url = '', params = {}, ...other} = {}) => { wx.showLoading({ title: '加載中...' }) let time = Date.now() console.log(`開始:${time}`) return new Promise((resolve, reject) => { wx.request({ url: getUrl(url), data: params, header: getHeader(), ...other, complete: (res) => { wx.hideLoading() console.log(`耗時:${Date.now() - time}`) if (res.statusCode >= 200 && res.statusCode < 300) { resolve(res.data) } else { reject(res) } } }) }) } const getUrl = url => { if (url.indexOf('://') == -1) { url = baseURL + url } return url } const getHeader = () => { try { var token = wx.getStorageSync('token') if (token) { return { 'token': token } } return {} } catch (e) { return {} } } module.exports = { baseURL, get (url, params = {}) { return http({ url, params }) }, post(url, params = {}) { return http({ url, params, method: 'post' }) }, put(url, params = {}) { return http({ url, params, method: 'put' }) }, // 這里不能使用 delete, delete為關(guān)鍵字段 myDelete(url, params = {}) { return http({ url, params, method: 'delete' }) } } 接了下來我們就可以正常的時候用了,寫一下簡單的例子吧 const api = require('../../utils/api.js') // 單個請求 api.get('list').then(res => { console.log(res) }).catch(e => { console.log(e) }) // 一個頁面多個請求 Promise.all([ api.get('list'), api.get(`detail/${id}`) ]).then(result => { console.log(result) }).catch(e => { console.log(e) }) 如果習(xí)慣了 fetch 以及 axios 的朋友應(yīng)該都會比較喜歡這種寫法。 在做網(wǎng)絡(luò)請求的時候還遇到一個問題,登錄授權(quán)的問題。 登錄問題做一個應(yīng)用,肯定避免不了登錄操作。用戶的個人信息啊,相關(guān)的收藏列表等功能都需要用戶登錄之后才能操作。一般我們使用token做標(biāo)識。然后又會涉及到token不存在,用戶第一次登錄,token過期后,重新登錄等問題。比較常規(guī)的操作是直接跳轉(zhuǎn)到登錄頁面。 然后坑就出現(xiàn)了,小程序并沒有登錄界面,使用的是 wx.login 。 wx.login 會獲取到一個 code,拿著該 code 去請求我們的后臺會最后返回一個token到小程序這邊,保存這個值為 token 每次請求的時候帶上這個值。(詳情可以查看小程序登錄。) 然而僅僅這樣就夠了嗎? 很顯然并不是。一般還需要把用戶的信息帶上比如用戶微信昵稱,微信頭像等,這時候就需要使用 wx.getUserInfo ,這里涉及到一個用戶授權(quán)的問題,留一個坑接下來再解決。帶上用戶信息就夠了嘛? too young too simple!我們的項目不可能只有小程序,相應(yīng)的微信公眾平臺可能還有相應(yīng)的App,我們需要把賬號系統(tǒng)打通,讓用戶在我們的項目中的賬戶是同一個。這就需要用到微信開放平臺提供的 UnionID 。 ps.基于小程序在微信中的易傳播性, 為了鼓勵用戶去傳播分享一般還會提供邀請獎勵機(jī)制。但是微信這邊又會對誘導(dǎo)分享進(jìn)行和諧處理。視情況慎用。(本文會在例子上加上該功能) 看到這,是不是覺得頭都大了,就一個小小的登錄功能坑這么多。 年輕的我瑟瑟發(fā)抖~~~。慢慢開始填吧。先上登錄代碼 /* utils/api.js 自定義網(wǎng)絡(luò)請求 */ ... function login() { return new Promise((resolve, reject) => { // 先調(diào)用 wx.login 獲取到 code wx.login({ success: res => { // 再調(diào)用 wx.getUserInfo 獲取到用戶的一些信息 (一些基本信息,以及生成UnionID 所用到的信息 比如 rawData, signature, encryptedData, iv) wx.getUserInfo({ // 若獲取不到用戶信息 (最大可能是用戶授權(quán)不允許,也有可能是網(wǎng)絡(luò)請求失敗,但該情況很少) fail: (e) => { reject(e) }, success: ({ rawData, signature, encryptedData, iv }) => { let param = { code: res.code, rawData, signature, encryptedData, iv } // 若有邀請ID try { let invite = wx.getStorageSync('invite') if (invite) { param.invite = invite } } catch (e) { } // 登錄操作 http({ url: 'login', params: param, method: 'post' }).then(res => { // 該為我們后端的邏輯 若code > 0為登錄成功,其他情況皆為異常 (視自身情況而定) if (res.code > 0) { // 保存用戶信息 wx.setStorage({ key: 'userinfo', data: res.data }) wx.setStorage({ key: "token", data: res.message, success: () => { resolve(res) } }) } else { reject(res) } }).catch(error => reject(error)) } }) } }) }) } ... 授權(quán)問題根據(jù)上面的代碼,可以很清楚的看到,若用戶在登錄的時候不允許小程序獲取他的用戶信息之后才能繼續(xù)。若用戶在這個時候點拒絕了呢, 會怎么樣? 一片空白!~~ What’s the fuck! 怎么什么都沒有!垃圾破小程序~~ 冷靜點的用戶也會百臉懵逼狀。我是誰?我該怎么辦? 也許你會覺得,用戶點允許就好了啊,怎么會這么笨,這種用戶肯定不會多之類的話。我在我們小程序中加了統(tǒng)計大約有 20% 的用戶點了拒絕, 如果后續(xù)我們沒有做任何引導(dǎo)的話,這 20% 的用戶就會永遠(yuǎn)失去。這個后果我們完全不能接受。 經(jīng)過我們的小組研究與討論,給出了一下的一套方案。 具體代碼可以如下表示,用到了 wx.openSetting 來跳轉(zhuǎn)到設(shè)置授權(quán)界面。 /* index.js */ // 若有用戶信息存在則繼續(xù) Page({ onLoad () { wx.getStorage({ key: 'userinfo', success: (res) => { this.setUserinfo(res) }, fail: (res) => { api.login().then((res) => { this.setUserinfo(res) }).catch(e => { if (e.errMsg && e.errMsg === 'getUserInfo:fail auth deny') { this.setData({ isauth: false }) } }) } }) }, toSetting() { wx.openSetting({ success: (res) => { this.setData({ isauth: res.authSetting['scope.userInfo'] }) if (res.authSetting['scope.userInfo']) { api.login().then((res) => { this.setUserinfo(res) }) } } }) } }) // setUserinfo 就是對用戶信息做一下處理 不具體展開了 /* index.wxml */ <view class="unauth" wx:if="{{!isauth}}"> <image class="unauth-img" src="../../images/auth.png"></image> <text class="unauth-text">檢查到您沒打開授權(quán)</text> <button class="color-button unauth-button" bindtap="toSetting">去設(shè)置</button> </view> <view class="container" wx:else> ... </view> token 失效問題登錄獲取到的 token 是有時效的,失效過了會怎么樣 ? 如果后臺小伙伴嚴(yán)格按照 REST API 規(guī)范設(shè)計接口 API 的話,他會給我們返回一個錯了 http code 為 401。(常見的Http Code以及相關(guān)代碼的意義本文就不做展開了,不了解的小伙伴可以自行 google 百度一下。)401 之后我們就需要對該Code進(jìn)行相應(yīng)的處理。可以如下這么寫 api.get('list').then(res => { /* do something */ }).catch(e => { if (res.statusCode === 401) { api.login().then(() => { api.get('list').then(res => { /* do something */ }) }) } }) 看起來沒什么問題,也完成需求了。但是會發(fā)現(xiàn)這有很大的問題。
屢一下我們要實現(xiàn)的目標(biāo)。
這個體現(xiàn)出把自己封裝一個網(wǎng)絡(luò)請求的好處, 我們可以直接改寫 api.js 中的 http 方法里對 error 的處理就好。上代碼: const http = ({ url = '', params = {}, ...other} = {}) => { wx.showLoading({ title: '加載中...' }) let time = Date.now() console.log(`開始:${time}`) return new Promise((resolve, reject) => { wx.request({ url: getUrl(url), data: params, header: getHeader(), ...other, complete: (res) => { wx.hideLoading() console.log(`耗時:${Date.now() - time}`) if (res.statusCode >= 200 && res.statusCode < 300) { resolve(res.data) } else if (res.statusCode === 401) { // 401 為鑒權(quán)失敗 很大可能是token過期 // 重新登錄 并且重復(fù)請求 login().then(res => { http({ url, params, ...other }).then(res => { resolve(res) }) }) } else { reject(res) } } }) }) } 小結(jié)網(wǎng)絡(luò)請求這塊,算目前開發(fā)項目中必不可少的一塊。但是例如 小程序,vue, react, weex 等其實都有一套自己的或者自己推薦的一套API以及相應(yīng)的寫法。沒一個都按照他推薦的來寫,其實挺蛋疼的,用著很不爽。把他們的API封裝一下,暴露出來統(tǒng)一的API, 給自己用或者尤其是給自己團(tuán)隊的小伙伴用就比較方便,少了很多重復(fù)學(xué)習(xí)成本,并且因為統(tǒng)一的API帶來的統(tǒng)一的格式也是很大的一個好處。 說到小程序要弄清楚的東西不少,有些坑我還在摸索怎么處理。比如小程序的組件化,全局變量的使用(什么值可以放在app.js里),html標(biāo)簽的轉(zhuǎn)換等,后續(xù)弄透了我會再出來獻(xiàn)丑的。 |