微信小程序授權(quán)登錄的優(yōu)雅處理方式
前言
當微信小程序項目中涉及到獲取用戶信息并實現(xiàn)用戶登錄時,可以通過微信官方提供的登錄能力方便地獲取微信的用戶身份標識,快速建立小程序內(nèi)的用戶體系。官方文檔只是提供如何去調(diào)用授權(quán)登錄,如果直接原封不動的照搬文檔來進行代碼編寫,這樣勢必會造成代碼的維護性差,所以本篇著重介紹如果更優(yōu)雅的處理微信小程序的授權(quán)登錄。
授權(quán)登錄的基本流程
上圖是微信小程序官網(wǎng)提供的授權(quán)登錄基本流程圖,這里我只從前端開發(fā)的角度來講解一下該流程。
- 通過wx.login()獲取臨時登錄憑證code。
- 通過調(diào)用服務端提供的接口把code傳遞給服務端,然后服務端會返回給前端openid和sesstion_key。這就代表已經(jīng)成功完成授權(quán)登錄了,至于openid和sesstion_key的用途,后面再進行講解。
大體的登錄流程搞清楚之后,就可以進行代碼的編寫了。因為微信提供的api接口調(diào)用不利于代碼維護,所以我借助了promise進行封裝處理(不了解的可以看ES6文檔,里面有詳細介紹),這樣做的好處就是以后可以鏈式調(diào)用接口,也可以結(jié)合async/await(ES6語法)將異步接口進行同步處理。
get/post 接口的封裝處理
在根目錄中創(chuàng)建service文件夾,用于存放與接口相關的代碼,在service文件夾創(chuàng)建一個myRequest.js文件并對小程序的get/post請求進行封裝處理,代碼如下:
//get請求封裝(跳頁判斷) //通過全局函數(shù)getApp可以獲取全局變量,需要全局的數(shù)據(jù)可以在根目錄下的app.js進行設置 let app=getApp(); const myGet = (url, data)=>{ return new Promise((resolve, reject)=>{ wx.request({ url: `${app.globalData.HTTP}${url}`, data:data, method:"GET", //這個authorization就是含有openid和sesstion_key信息的值 header: { 'authorization': app.globalData.authorization},//獲取全局變量中的用戶信息,并放入到請求頭中 success:(res)=>{ if (res.data.code == 409) { //409代表用戶未進行登錄,強制跳到寫好的登錄頁 wx.navigateTo({ url: '../login/login' }) } else{ resolve(res.data); } }, fail:(res)=>{ reject(); } }) }) } //post請求封裝(跳頁判斷) const myPost = (url, data) => { return new Promise((resolve, reject) => { wx.request({ url: `${app.globalData.HTTP}${url}`, data: data, method: "POST", header: { 'authorization': app.globalData.authorization}, success: (res) => { if (res.data.code == 409){ wx.navigateTo({ url: '../login/login' }) }else{ resolve(res.data); } }, fail: (res) => { reject(); } }) }) } module.exports = { myGet, myPost, }
全局變量配置app.js代碼如下(注意全局變量數(shù)據(jù)會在刷新頁面或是重新進入小程序之后初始化,并不能永久保存當前的數(shù)據(jù)狀態(tài)):
//app.js App({ onLaunch: function() { //這里可以根據(jù)項目實際需求寫一些項目初始化需要執(zhí)行的代碼 }, globalData: { HTTP: "https://shop.yamecent.com/", //我們獲取openid和sesstion_key之后,會把它存放到小程序內(nèi)存的authorization中,這樣數(shù)據(jù)不會丟失,除非刪除該小程序 authorization: wx.getStorageSync('authorization') || "",//獲取存儲在小程序內(nèi)存中的authorization } })
授權(quán)登錄接口封裝
這部分封裝會用到async/await,將異步接口進行同步處理,不了解的可以參看ES6文檔說明,在service文件夾下創(chuàng)建login.js代碼如下:
const myRequest = require('./myRequest.js'); const app = getApp(); const HTTP = app.globalData.HTTP; //微信login接口獲取code封裝 const myLogin=()=>{ return new Promise((resolve, reject)=>{ wx.login({ success:(res)=>{ resolve(res.code); }, fail:(res)=>{ reject(res.errMsg); console.log("微信登錄獲取code失敗"); } }) }) } //獲取openid和session_key接口封裝 const getUserMsg=(myUrl,myData)=>{ return new Promise((resolve,reject)=>{ wx.request({ url: myUrl, method: "POST", data: myData, success:(res)=>{ if(res.data.code==500){ //獲取失敗 wx.showToast({ title: res.data.msg, icon: 'none', duration: 2000, mask:true, }) resolve(500);//失敗是返回500 }else{ resolve(res.data.data); } }, fail:(res)=>{ reject(res.data.msg); console.log("獲取openid和session_key接口失敗"); } }) }) } //封裝存儲(注意:這里的存儲過程是異步的) const mySetStorage=(key,val)=>{ return new Promise((resolve, reject) => { wx.setStorage({ key: key, data: val, success: () => { resolve(true); }, fail: () => { reject(false); } }) }) } //封裝獲取存儲 const myGetStorage=(key)=>{ return new Promise((resolve,reject)=>{ wx.getStorage({ key: 'key', success: (res)=>{ resolve(res.data); }, fail:()=>{ reject("獲取存儲失敗"); } }) }) } //授權(quán)方法封裝 //sendData是通過授權(quán)按鈕獲取到的用戶信息,這里要作為參數(shù)傳遞給后臺來保存用戶的信息 //cb是授權(quán)登錄成功之后所要執(zhí)行的函數(shù),具體是什么功能的函數(shù),要根據(jù)項目需求而定,也可能不需要 const myAuthorize = (sendData,cb="") => { async function accredit() { wx.showLoading({ title: '認證中', mask:true }) let code = await myLogin();//微信登陸獲取code接口 sendData.code=code; let author = await getUserMsg(`${HTTP}auth`, sendData);//獲取后臺openid sesstion_key接口 wx.hideLoading(); if(author==500){ return; } await mySetStorage("authorization", author.Authorization);//存到內(nèi)存中,進入小程序中獲取并存入app.globalData中 app.globalData.authorization = author.Authorization; typeof cb == "function" && cb(author);//回調(diào)所需要用的登陸狀態(tài)參數(shù) //這里可以補充一下其它業(yè)務邏輯,如tabbar用戶購物車數(shù)量等邏輯 wx.showToast({ title: '成功授權(quán)', icon: 'success', duration: 2000, mask: true }); } accredit(); } module.exports = { myAuthorize, mySetStorage, myGetStorage }
授權(quán)登錄封裝好了之后再看看如何在項目中如何使用,由于微信小程序授權(quán)只能通過button來觸發(fā),所以使用 button 組件,并將 open-type 指定為 getUserInfo 類型,獲取用戶基本信息。login.wxml代碼如下:
<button class='btn' open-type="getUserInfo" bindgetuserinfo='gotoLogin'>立即登錄</button>
login.js代碼如下:
// pages/login/login.js const myRequest = require('../../common/script/myRequest.js'); const login = require('../../common/script/login.js'); const app = getApp(); const HTTP = app.globalData.HTTP; Page({ /** * 頁面的初始數(shù)據(jù) */ data: { }, gotoLogin: function (e) { let sendOjb={};//用于存放用戶信息 if (e.detail.errMsg =="getUserInfo:ok"){ sendOjb = { avatar: e.detail.userInfo.avatarUrl, nickname: e.detail.userInfo.nickName, sex: e.detail.userInfo.gender, province: e.detail.userInfo.province, city: e.detail.userInfo.city}; login.myAuthorize(sendOjb,()=>{ wx.navigateBack();//成功之后返回之前的頁面,也可以根據(jù)項目需求寫一些其它的邏輯 }) }else{ } }, /** * 生命周期函數(shù)--監(jiān)聽頁面加載 */ onLoad: function (options) { }, })
結(jié)束語
以上代碼復制粘貼到自己的微信小程序項目中就能夠正常運行,如有錯誤或需要改進的地方還請與我聯(lián)系,我將及時進行改正。
到此這篇關于微信小程序授權(quán)登錄的優(yōu)雅處理方式的文章就介紹到這了,更多相關微信小程序授權(quán)登錄內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家!
相關文章
JavaScript中你不得不知道的Promise高級用法分享
在JavaScript中,Promise是一種解決異步編程問題的重要方式,本文主要來和大家探討一下23個Promise的高級用法,每一個都在JavaScript的海洋中航行,讓開發(fā)者們能夠以更高效、優(yōu)雅的方式處理異步操作,希望對大就有所幫助2023-12-12jQuery javascript獲得網(wǎng)頁的高度與寬度的實現(xiàn)代碼
下面小編就為大家?guī)硪黄猨Query javascript獲得網(wǎng)頁的高度與寬度的實現(xiàn)代碼。小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考2016-04-04詳解Bootstrap的aria-label和aria-labelledby應用
這篇文章主要介紹了詳解Bootstrap的aria-label和aria-labelledby應用的相關資料,需要的朋友可以參考下2016-01-01Javascript浮點數(shù)乘積運算出現(xiàn)多位小數(shù)的解決方法
這篇文章主要介紹了Javascript浮點數(shù)乘積運算出現(xiàn)多位小數(shù)的解決方法,需要的朋友可以參考下2014-02-02JS字符串false轉(zhuǎn)boolean的方法(推薦)
下面小編就為大家?guī)硪黄狫S字符串false轉(zhuǎn)boolean的方法(推薦)。小編覺得挺不錯的,現(xiàn)在就分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2017-03-03