前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >处理微信小程序授权登录

处理微信小程序授权登录

原创
作者头像
ruochen
发布2021-11-26 13:10:52
8K0
发布2021-11-26 13:10:52
举报
文章被收录于专栏:若尘的技术专栏

前言

当微信小程序项目中涉及到获取用户信息并实现用户登录时,可以通过微信官方提供的登录能力方便地获取微信的用户身份标识,快速建立小程序内的用户体系。官方文档只是提供如何去调用授权登录,如果直接原封不动的照搬文档来进行代码编写,这样势必会造成代码的维护性差,所以本篇着重介绍如果更优雅的处理微信小程序的授权登录。

授权登录的基本流程

微信小程序登录流程.jpg

上图是微信小程序官网提供的授权登录基本流程图,这里我只从前端开发的角度来讲解一下该流程。

  1. 通过wx.login()获取临时登录凭证code。
  2. 通过调用服务端提供的接口把code传递给服务端,然后服务端会返回给前端openidsesstion_key。这就代表已经成功完成授权登录了,至于openidsesstion_key的用途,后面再进行讲解。

大体的登录流程搞清楚之后,就可以进行代码的编写了。因为微信提供的api接口调用不利于代码维护,所以我借助了promise进行封装处理(不了解的可以看ES6文档,里面有详细介绍),这样做的好处就是以后可以链式调用接口,也可以结合async/await(ES6语法)将异步接口进行同步处理。

get/post 接口的封装处理

在根目录中创建service文件夹,用于存放与接口相关的代码,在service文件夹创建一个myRequest.js文件并对小程序的get/post请求进行封装处理,代码如下:

代码语言:txt
复制
//get请求封装(跳页判断)
代码语言:txt
复制
//通过全局函数getApp可以获取全局变量,需要全局的数据可以在根目录下的app.js进行设置
代码语言:txt
复制
let app=getApp();
代码语言:txt
复制
const myGet = (url, data)=>{
代码语言:txt
复制
  return new Promise((resolve, reject)=>{
代码语言:txt
复制
    wx.request({
代码语言:txt
复制
      url: `${app.globalData.HTTP}${url}`,
代码语言:txt
复制
      data:data,
代码语言:txt
复制
      method:"GET",
代码语言:txt
复制
      //这个authorization就是含有openid和sesstion_key信息的值
代码语言:txt
复制
      header: { 'authorization': app.globalData.authorization},//获取全局变量中的用户信息,并放入到请求头中
代码语言:txt
复制
      success:(res)=>{
代码语言:txt
复制
        if (res.data.code == 409) {
代码语言:txt
复制
          //409代表用户未进行登录,强制跳到写好的登录页
代码语言:txt
复制
          wx.navigateTo({
代码语言:txt
复制
            url: '../login/login'
代码语言:txt
复制
          })
代码语言:txt
复制
        } else{
代码语言:txt
复制
          resolve(res.data);
代码语言:txt
复制
        }
代码语言:txt
复制
      },
代码语言:txt
复制
      fail:(res)=>{
代码语言:txt
复制
        reject();
代码语言:txt
复制
      }
代码语言:txt
复制
    })
代码语言:txt
复制
  })
代码语言:txt
复制
}
代码语言:txt
复制
//post请求封装(跳页判断)
代码语言:txt
复制
const myPost = (url, data) => {
代码语言:txt
复制
  return new Promise((resolve, reject) => {
代码语言:txt
复制
    wx.request({
代码语言:txt
复制
      url: `${app.globalData.HTTP}${url}`,
代码语言:txt
复制
      data: data,
代码语言:txt
复制
      method: "POST",
代码语言:txt
复制
      header: { 'authorization': app.globalData.authorization},
代码语言:txt
复制
      success: (res) => {
代码语言:txt
复制
        if (res.data.code == 409){
代码语言:txt
复制
          wx.navigateTo({
代码语言:txt
复制
            url: '../login/login'
代码语言:txt
复制
          })
代码语言:txt
复制
        }else{
代码语言:txt
复制
          resolve(res.data);
代码语言:txt
复制
        }
代码语言:txt
复制
      },
代码语言:txt
复制
      fail: (res) => {
代码语言:txt
复制
        reject();
代码语言:txt
复制
      }
代码语言:txt
复制
    })
代码语言:txt
复制
  })
代码语言:txt
复制
}
代码语言:txt
复制
module.exports = {
代码语言:txt
复制
  myGet,
代码语言:txt
复制
  myPost,
代码语言:txt
复制
}

全局变量配置app.js代码如下( 注意全局变量数据会在刷新页面或是重新进入小程序之后初始化,并不能永久保存当前的数据状态 ):

代码语言:txt
复制
//app.js
代码语言:txt
复制
App({
代码语言:txt
复制
  onLaunch: function() {
代码语言:txt
复制
    //这里可以根据项目实际需求写一些项目初始化需要执行的代码
代码语言:txt
复制
  },
代码语言:txt
复制
  globalData: {
代码语言:txt
复制
    HTTP: "https://shop.yamecent.com/",
代码语言:txt
复制
    //我们获取openid和sesstion_key之后,会把它存放到小程序内存的authorization中,这样数据不会丢失,除非删除该小程序
代码语言:txt
复制
    authorization: wx.getStorageSync('authorization') || "",//获取存储在小程序内存中的authorization
代码语言:txt
复制
  }
代码语言:txt
复制
})

授权登录接口封装

这部分封装会用到async/await,将异步接口进行同步处理,不了解的可以参看ES6文档说明,在service文件夹下创建login.js代码如下:

代码语言:txt
复制
const myRequest = require('./myRequest.js');
代码语言:txt
复制
const app = getApp();
代码语言:txt
复制
const HTTP = app.globalData.HTTP;
代码语言:txt
复制
//微信login接口获取code封装 
代码语言:txt
复制
const myLogin=()=>{
代码语言:txt
复制
  return new Promise((resolve, reject)=>{
代码语言:txt
复制
    wx.login({
代码语言:txt
复制
      success:(res)=>{
代码语言:txt
复制
        resolve(res.code);
代码语言:txt
复制
      },
代码语言:txt
复制
      fail:(res)=>{
代码语言:txt
复制
        reject(res.errMsg);
代码语言:txt
复制
        console.log("微信登录获取code失败");
代码语言:txt
复制
      }
代码语言:txt
复制
    })
代码语言:txt
复制
  })
代码语言:txt
复制
}
代码语言:txt
复制
//获取openid和session_key接口封装
代码语言:txt
复制
const getUserMsg=(myUrl,myData)=>{
代码语言:txt
复制
  return new Promise((resolve,reject)=>{
代码语言:txt
复制
    wx.request({
代码语言:txt
复制
      url: myUrl,
代码语言:txt
复制
      method: "POST",
代码语言:txt
复制
      data: myData,
代码语言:txt
复制
      success:(res)=>{
代码语言:txt
复制
        if(res.data.code==500){
代码语言:txt
复制
          //获取失败
代码语言:txt
复制
          wx.showToast({
代码语言:txt
复制
            title: res.data.msg,
代码语言:txt
复制
            icon: 'none',
代码语言:txt
复制
            duration: 2000,
代码语言:txt
复制
            mask:true,
代码语言:txt
复制
          })
代码语言:txt
复制
          resolve(500);//失败是返回500          
代码语言:txt
复制
        }else{
代码语言:txt
复制
          resolve(res.data.data);
代码语言:txt
复制
        }       
代码语言:txt
复制
      },
代码语言:txt
复制
      fail:(res)=>{
代码语言:txt
复制
        reject(res.data.msg);
代码语言:txt
复制
        console.log("获取openid和session_key接口失败");        
代码语言:txt
复制
      }
代码语言:txt
复制
    })
代码语言:txt
复制
  })
代码语言:txt
复制
}
代码语言:txt
复制
//封装存储(注意:这里的存储过程是异步的)
代码语言:txt
复制
const mySetStorage=(key,val)=>{
代码语言:txt
复制
  return new Promise((resolve, reject) => {
代码语言:txt
复制
    wx.setStorage({
代码语言:txt
复制
      key: key,
代码语言:txt
复制
      data: val,
代码语言:txt
复制
      success: () => {
代码语言:txt
复制
        resolve(true);
代码语言:txt
复制
      },
代码语言:txt
复制
      fail: () => {
代码语言:txt
复制
        reject(false);
代码语言:txt
复制
      }
代码语言:txt
复制
    })
代码语言:txt
复制
  })  
代码语言:txt
复制
}
代码语言:txt
复制
//封装获取存储
代码语言:txt
复制
const myGetStorage=(key)=>{
代码语言:txt
复制
  return new Promise((resolve,reject)=>{
代码语言:txt
复制
    wx.getStorage({
代码语言:txt
复制
      key: 'key',
代码语言:txt
复制
      success: (res)=>{
代码语言:txt
复制
        resolve(res.data);
代码语言:txt
复制
      },
代码语言:txt
复制
      fail:()=>{
代码语言:txt
复制
        reject("获取存储失败");
代码语言:txt
复制
      }
代码语言:txt
复制
    })
代码语言:txt
复制
  })
代码语言:txt
复制
}
代码语言:txt
复制
//授权方法封装
代码语言:txt
复制
//sendData是通过授权按钮获取到的用户信息,这里要作为参数传递给后台来保存用户的信息
代码语言:txt
复制
//cb是授权登录成功之后所要执行的函数,具体是什么功能的函数,要根据项目需求而定,也可能不需要
代码语言:txt
复制
const myAuthorize = (sendData,cb="") => {
代码语言:txt
复制
  async function accredit() {
代码语言:txt
复制
    wx.showLoading({
代码语言:txt
复制
      title: '认证中',
代码语言:txt
复制
      mask:true
代码语言:txt
复制
    })
代码语言:txt
复制
    let code = await myLogin();//微信登陆获取code接口
代码语言:txt
复制
    sendData.code=code;
代码语言:txt
复制
    let author = await getUserMsg(`${HTTP}auth`, sendData);//获取后台openid sesstion_key接口
代码语言:txt
复制
    wx.hideLoading();
代码语言:txt
复制
    if(author==500){
代码语言:txt
复制
      return;
代码语言:txt
复制
    }
代码语言:txt
复制
    await mySetStorage("authorization", author.Authorization);//存到内存中,进入小程序中获取并存入app.globalData中
代码语言:txt
复制
    app.globalData.authorization = author.Authorization;
代码语言:txt
复制
    typeof cb == "function" && cb(author);//回调所需要用的登陆状态参数
代码语言:txt
复制
    //这里可以补充一下其它业务逻辑,如tabbar用户购物车数量等逻辑
代码语言:txt
复制
    wx.showToast({
代码语言:txt
复制
      title: '成功授权',
代码语言:txt
复制
      icon: 'success',
代码语言:txt
复制
      duration: 2000,
代码语言:txt
复制
      mask: true
代码语言:txt
复制
    });               
代码语言:txt
复制
  }
代码语言:txt
复制
  accredit();
代码语言:txt
复制
}
代码语言:txt
复制
module.exports = {
代码语言:txt
复制
  myAuthorize,
代码语言:txt
复制
  mySetStorage,
代码语言:txt
复制
  myGetStorage
代码语言:txt
复制
}

授权登录封装好了之后再看看如何在项目中如何使用,由于微信小程序授权只能通过button来触发,所以使用 button 组件,并将 open-type 指定为

getUserInfo 类型,获取用户基本信息。login.wxml代码如下:

代码语言:txt
复制
<button class='btn' open-type="getUserInfo" bindgetuserinfo='gotoLogin'>立即登录</button>

login.js代码如下:

代码语言:txt
复制
// pages/login/login.js
代码语言:txt
复制
const myRequest = require('../../common/script/myRequest.js');
代码语言:txt
复制
const login = require('../../common/script/login.js');
代码语言:txt
复制
const app = getApp();
代码语言:txt
复制
const HTTP = app.globalData.HTTP;
代码语言:txt
复制
Page({
代码语言:txt
复制
  /**
代码语言:txt
复制
   * 页面的初始数据
   */
  data: {
  
代码语言:txt
复制
  },
代码语言:txt
复制
  gotoLogin: function (e) {
代码语言:txt
复制
    let sendOjb={};//用于存放用户信息
代码语言:txt
复制
    if (e.detail.errMsg =="getUserInfo:ok"){
代码语言:txt
复制
      sendOjb = { avatar: e.detail.userInfo.avatarUrl,
代码语言:txt
复制
                  nickname: e.detail.userInfo.nickName, 
代码语言:txt
复制
                  sex: e.detail.userInfo.gender,
代码语言:txt
复制
                  province: e.detail.userInfo.province, 
代码语言:txt
复制
                  city: e.detail.userInfo.city};  
代码语言:txt
复制
      login.myAuthorize(sendOjb,()=>{
代码语言:txt
复制
        wx.navigateBack();//成功之后返回之前的页面,也可以根据项目需求写一些其它的逻辑
代码语言:txt
复制
      })    
代码语言:txt
复制
    }else{
代码语言:txt
复制
    }
代码语言:txt
复制
  },
代码语言:txt
复制
  /**
代码语言:txt
复制
   * 生命周期函数--监听页面加载
   */
  onLoad: function (options) {
代码语言:txt
复制
  },
代码语言:txt
复制
})

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
作者已关闭评论
0 条评论
热度
最新
推荐阅读
目录
  • 前言
  • 授权登录的基本流程
  • get/post 接口的封装处理
  • 授权登录接口封装
相关产品与服务
云开发 CloudBase
云开发(Tencent CloudBase,TCB)是腾讯云提供的云原生一体化开发环境和工具平台,为200万+企业和开发者提供高可用、自动弹性扩缩的后端云服务,可用于云端一体化开发多种端应用(小程序、公众号、Web 应用等),避免了应用开发过程中繁琐的服务器搭建及运维,开发者可以专注于业务逻辑的实现,开发门槛更低,效率更高。
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档