Vue中实现权限控制的方法示例
一、前言
在广告机项目中,角色的权限管理是卡了挺久的一个难点。首先我们确定的权限控制分为两大部分,其中根据粒的大小分的更细:
1、接口访问的权限控制
2、页面的权限控制
- 菜单中的页面是否能被访问
- 页面中的按钮(增、删、改)的权限控制是否显示
下面我们就看一看是如何实现这些个权限控制的。
二、接口访问的权限控制
接口权限就是对用户的校验。正常来说,在用户登录时服务器需要给前台返回一个token,然后在以后前台每次调用接口时都需要带上这个token,然后服务端获取到这个token后进行比对,如果通过则可以访问。
现有的做法是在登录成功的回调中将后台返回的token直接存储到sessionstorage,然在请求时将token取出放入headers中传给后台,代码如下:
this.$http({ method: 'get', url: 'test/query?id=20', withcredentials: true, headers: { token: sessionstorage.getitem('token'), name: sessionstorage.getitem('name') //应后台需求传的用户名 } }).then(response => { //请求成功后的操作 })
后来在一些文章中发现axios可以在拦截器中直接将token塞入config.headers.authorization中,作为全局传入。下面是代码部分:
//main.js import axios from 'axios' // 实例化axios,并进行超时设置 const service = axios.create({ timeout: 5000 }) // baseurl // axios.defaults.baseurl = 'https://api.github.com'; // http request 拦截器 // 每次请求都为http头增加authorization字段,其内容为token service.interceptors.request.use( config => { if (store.state.user.token) { config.headers.authorization = `token ${store.state.user.token}`; } return config }, err => { return promise.reject(err) } ); export default service
三、页面权限控制
在前面已经说到,页面权限控制又分为两种:
- 1菜单中的页面是否能被访问
- 2页面中的按钮(增、删、改)的权限控制是否显示
这些权限一般是在固定页面进行配置,保存后记录到数据库中。
按钮权限暂且不提,页面访问权限在实现中又可以分为两种方式:
- 1显示所有菜单,当用户访问不在自己权限内的菜单时,提示权限不足
- 2只显示当前用户能访问的权限内菜单,如果用户通过url进行强制访问,则会直接进入404
既然展现出来后不能点,那算几个意思,逗我玩儿呢?所谓眼不见为净,综合考虑后,肯定是方案二比较符合良好的用户体验。
好,我们现在梳理一下大致的页面访问权限的流程:
在这里插入图片描述
在对流程梳理完成后我们开始进行详细的编写。
1、创建路由表
创建路由表实际上没有什么难度,照着vue-router官方文档给的示例直接写就行了。但是因为有部分页面是不需要访问权限的,所以需要将登录、404、维护等页面写到默认的路由中,而将其它的需要权限的页面写到一个变量或者一个文件中,这样可以有效的减轻后续的维护压力。
下面将index.js的代码贴上,异步路由将适量减少,以免占过多篇幅。
// router/index.js import vue from 'vue' import router from 'vue-router' import app from '@/app' import store from '../store/index' vue.use(router); //手动跳转的页面白名单 const whitelist = [ '/' ]; //默认不需要权限的页面 const constantroutermap = [ { path: '/', name: '登录', component: (resolve) => require(['@/components/login'], resolve) }, { path: '/index', name: 'nav.home', component: (resolve) => require(['@/components/index'], resolve) }, { path: '/templatemake', name: '模板制作', component: (resolve) => require(['@/components/template/templatemake'], resolve) }, { path: '/programmack', name: '节目制作', component: (resolve) => require(['@/components/template/programmack'], resolve) }, { path: '/release', name: '节目发布', component: (resolve) => require(['@/components/program/release'], resolve) } ] //注册路由 export const router = new router({ routes: constantroutermap }); //异步路由(需要权限的页面) export const asyncroutermap = [ { path: '/resource', name: 'nav.resource', meta: { permission: [] }, component: (resolve) => require(['@/components/resource/resource'], resolve) }, { path: '/template', name: 'nav.template', meta: { permission: [] }, component: (resolve) => require(['@/components/template/template'], resolve) }, { path: '/generalset', name: 'nav.system', meta: { permission: [] }, component: (resolve) => require(['@/components/systemset/generalset'], resolve) }, { path: '', name: 'nav.log', component: app, children: [ { path: '/userlog', name: 'nav.userlog', meta: { permission: [] }, component: (resolve) => require(['@/components/log/userlog'], resolve), }, { path: '/operatinglog', name: 'nav.systemlog', meta: { permission: [] }, component: (resolve) => require(['@/components/log/operatinglog'], resolve), }, ] } ] ];
注意事项:这里有一个需要非常注意的地方就是 404 页面一定要最后加载,如果放在constantroutermap一同声明了404,后面的所以页面都会被拦截到404,详细的问题见addroutes when you've got a wildcard route for 404s does not work
2、页面访问权限
在开始时我们梳理了一个大致的页面访问权限流程。下面我们先实现最核心的部分
我们首先获取用户权限列表,在这里我们将接触到vuex状态管理,官方文档有详细介绍,这里就不过多描述了,下面请看代码:
// store/index.js import axios from 'axios' import vue from 'vue' import vuex from 'vuex' vue.use(vuex); const axios = axios.create(); const state = { mode: 'login', list: [] }; const getters = {}; const mutations = { setmode: (state, data) => { state.mode = data }, setlist: (state, data) => { state.list = data } }; const actions = { // 获取权限列表 getpermission({commit}) { return new promise((resolve, reject) => { axios({ url: '/privilege/queryprivilege?id=' + sessionstorage.getitem('privid'), methods: 'get', headers: { token: sessionstorage.getitem('token'), name: sessionstorage.getitem('name') } }).then((res) => { // 存储权限列表 commit('setlist', res.data.cust.privileges[0].children); resolve(res.data.cust.privileges[0].children) }).catch(() => { reject() }) }) } }; export default new vuex.store({ state, mutations, actions, getters })
好了,我们现在请求后台拿到了权限数据,并将数据存放到了vuex中,下面我们需要利用返回数据匹配之前写的异步路由表,将匹配结果和静态路由表结合,开成最终的实际路由表。
其中最关键的是利用vue-router2.2.0版本新添加的一个addroutes方法,我们看看官方文档如何解释此方法的:
router.addroutes(routes) 2.2.0+
动态添加更多的路由规则。参数必须是一个符合 routes 选项要求的数组。
那我们现在就可以开始使用addroutes进行路由匹配了。下面看代码:
// router/index.js /** * 根据权限匹配路由 * @param {array} permission 权限列表(菜单列表) * @param {array} asyncrouter 异步路由对象 */ function routermatch(permission, asyncrouter) { return new promise((resolve) => { const routers = []; // 创建路由 function createrouter(permission) { // 根据路径匹配到的router对象添加到routers中即可 permission.foreach((item) => { if (item.children && item.children.length) { createrouter(item.children) } let path = item.path; // 循环异步路由,将符合权限列表的路由加入到routers中 asyncrouter.find((s) => { if (s.path === '') { s.children.find((y) => { if (y.path === path) { y.meta.permission = item.permission; routers.push(s); } }) } if (s.path === path) { s.meta.permission = item.permission; routers.push(s); } }) }) } createrouter(permission) resolve([routers]) }) }
然后我们编写导航钩子
// router/index.js router.beforeeach((to, form, next) => { if (sessionstorage.getitem('token')) { if (to.path === '/') { router.replace('/index') } else { console.log(store.state.list.length); if (store.state.list.length === 0) { //如果没有权限列表,将重新向后台请求一次 store.dispatch('getpermission').then(res => { //调用权限匹配的方法 routermatch(res, asyncroutermap).then(res => { //将匹配出来的权限列表进行addroutes router.addroutes(res[0]); next(to.path) }) }).catch(() => { router.replace('/') }) } else { if (to.matched.length) { next() } else { router.replace('/') } } } } else { if (whitelist.indexof(to.path) >= 0) { next() } else { router.replace('/') } } });
到这里我们已经完成了对页面访问的权限控制,接下来我们来讲解一下操作按扭的权限部分。
四、数据操作权限
是否还记得前面的路由配置中我们多出来的一个代码,下面我们拿出来看看:
//异步路由(需要权限的页面) export const asyncroutermap = [ { path: '/resource', name: 'nav.resource', meta: { permission: [] }, component: (resolve) => require(['@/components/resource/resource'], resolve) }, { path: '/template', name: 'nav.template', meta: { permission: [] }, component: (resolve) => require(['@/components/template/template'], resolve) }, { path: '/generalset', name: 'nav.system', meta: { permission: [] }, component: (resolve) => require(['@/components/systemset/generalset'], resolve) }, { path: '', name: 'nav.log', component: app, children: [ { path: '/userlog', name: 'nav.userlog', meta: { permission: [] }, component: (resolve) => require(['@/components/log/userlog'], resolve), }, { path: '/operatinglog', name: 'nav.systemlog', meta: { permission: [] }, component: (resolve) => require(['@/components/log/operatinglog'], resolve), }, ] } ] ];
为每个路由页面增加meta字段。在routermatch函数中将匹配到的详细权限字段赋值到这里。这样在每个页面的route对象中就会得到这个字段。
asyncrouter.find((s) => { if (s.path === '') { s.children.find((y) => { if (y.path === path) { //赋值 y.meta.permission = item.permission; routers.push(s); } }) } if (s.path === path) { s.meta.permission = item.permission; routers.push(s); } })
接下来我们编写一个vue自定义指令对页面中需要进行鉴权的元素进行判断,比如类似这样的:
<a @click="upload" v-allow="'3'"></a> /* 3代表一个上传权限的id,权限中有3则显示按钮 */
我们直接注册一个全局指令,利用vnode来访问vue的方法。代码如下:
//main.js //按扭权限指令 vue.directive('allow', { inserted: (el, binding, vnode) => { let permissionlist = vnode.context.$route.meta.permission; if (!permissionlist.includes(binding.value)) { el.parentnode.removechild(el) } } })
至此为止,权限控制流程就已经完全结束了
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
上一篇: 为vue项目自动设置请求状态的配置方法
下一篇: vue 插件的方法代码详解