来源:https://wintc.top/article/53
在做Vue、React项目的时候常会用axios请求库来与后端进行数据交互。我们通常采用一个用户凭证token来验证用户身份,服务器根据token进行判断当前用户是否有权限调用接口。
经常遇到的一个问题是,调用接口时token可能已经过期,此时调用接口会失败,需要重新登录后再调用接口。通常我们可能处理为,用户走完登录流程后再重新手动触发一次请求。这样的实现本身没什么问题,但是给用户的操作体验上有被中断的感觉,今天尝试解决了一下这个问题。
一、业务痛点
我的业务场景是,当一个接口(比如”用户发表评论“)返回token过期或者未验证的状态码时,调出登录弹窗,登录成功后再次发送评论请求。当然我们可以在评论接口处对状态码进行判断,token失效则重新发送请求;如果有其它接口也类似处理。这个方法最大的问题在于对于每个接口都要单独处理,然而程序员最大的优点就是——懒。这个方法虽然可行,对于一个懒人来说并不怎么好用,那更好的办法的是什么呢?
二、业务实现——以登录过期,重新发送请求为例(Vue实现)
axios请求拦截器本身可以获取请求的地址、参数、超时时间等配置,请求的重发变得很简单;同时axios库的请求返回为一个promise对象,得益于Promise强大的嵌套异步处理,可以使得请求接口调用对请求重发“无感”——即调用接口的时候你可以默认它一定成功,因为失败的情况在拦截器已经重发了。
1. 使用拦截器进行请求重发
function getToken () { return localStorage.getItem('token') } function clearToken () { localStorage.removeItem('token') } function setToken (token) { localStorage.setItem('token', token) } function login () { // 登录处理代码 } const instance = axios.create({ baseURL: 'http://xxxx', // 请求域名前缀 timeout: 10 * 1000 }) const requestError = error => Promise.reject(error) const beforeRequest = config => { config.headers['token'] = getToken() || undefined return config } const beforeResponse = res => () => { if (res.data.code == 401) { // 401错误表示未登录授权或者token失效 clearToken() return login().then(() => { return instance.request(res.config) // 这里是核心代码,登录成功后重新请求!返回Promise对象。 }) } return res } instance.interceptors.request.use(beforeRequest, requestError) instance.interceptors.response.use(beforeResponse, requestError)
2.登录调用(login函数)封装
上述代码里重新请求部分调用了login函数(login().then(callback)),login函数体空置了,接下来将讨论其实现。login预期返回一个Proimise,登录成功则Promise.then注册的回调函数将被调用。
我们可以将登录弹窗封装为一个组件,然后通过手动挂载组件来函数式地调用登录流程。可以在登录组件内部提供一个函数以供外部login函数调用,比如showModal,该函数直接返回一个Promise,login函数只要调用该函数并直接返回即可。
登录组件Login.vue封装:
<template> <div v-show="show"> <!-- 登录框 --> </div> </template> <script> export default { data () { return { username: '', password: '', resolve: null, reject: null, show: false } }, methods: { showModal () { return new Promise((resolve, rejcet) => { this.show = true this.resolve = resolve this.reject = reject }) }, hideModal () { this.show = false this.reject = null this.resolve = null this.username = '' this.password = '' }, success () { this.hideModal() this.resolve && this.resolve() }, fail () { this.hideModal() this.reject && this.reject() } } } </script>
封装好了Login.vue组件,接下来实现login函数:
import Login from '@/components/Login.vue' import Vue from 'vue' // ... let vm = null function login() { if (!vm) { const LoginConstructor = Vue.extend(Login) vm = new LoginConstructor().$mount() } return vm.showModal() } // ...
login函数闭包了一个外部变量vm,目的是通过vm引用已创建的Login组件实例,避免重复创建(即“单例”)。这样,完整的登录后重发请求流程即完成了。
三、总结
一般而言只要谈到异步,通常提到回调函数。JS里的Promise是一个强大的回调函数管理器。本文的实现方案正是利用了Promise的特性,在接口无权限时,将“登录+重新请求”的过程封装为Promise并返回,实现接口调用过程中无权限登录统一处理。这样在接口调用的地方,可以不用单独处理无权限的情况,一定程度上避免用户操作被登录流程打断。