后台管理系统的项目小结

| vue , admin

后台管理系统的项目小结
写起来却触及到不少知识点，关于vue全家桶什么的都用到了
实现功能或者一些想记录的点

  • 登录（axios实例和拦截器）
  • 动态侧边栏和面包屑(this.$router.options.routes,meta路由元的使用)
  • iconfont的使用
  • 页面布局和可复用组件
  • element-ui,js-cookie,一些工具方法的使用
  • vuex模块化和抽离api接口
  • es6/7和webpack的一些语法

实现思路

登录:获取用户表单信息，提交后给后端接口验证，如果匹配则返回一个token,使用cookie存储，再根据token去拉取用户信息接口获取信息，这里的具体操作主要看后端接口如何书写，登录成功后，跳转至主页面。

这里使用自定义配置创建axios实例：axios.create（[config]），指定的配置将与实例配置合并：axios＃get（url [，config]），这里会配置基本路径和超时时间。还使用了axios拦截器,这里使用request拦截器是为了在每个请求头塞入token,好让后端对请求进行权限验证（根据业务而定），response拦截器，当服务端返回特殊的状态码，做统一处理。

其中有一个导航守卫，有组件需要登录才能展示，这个练习项目中，是先登录才能展示其他页面，不登录无法展示页面，所以有一个全局的导航守卫。这里注册一个全局前置守卫,当一个导航触发时，全局前置守卫按照创建顺序调用。守卫是异步解析执行，此时导航在所有守卫 resolve 完之前一直处于 等待中。

每个守卫方法接收三个参数：

1
2
3
router.beforeEach((to, from, next) => {
  // ...
})
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
router.beforeEach((to,from,next)=>{
	if(getToken()){
		if(to.path==='/login'){
			next({path:'/'})
		}else{
			if(store.getters.roles.length===0){  //判断当前用户是否已拉取完user_info信息
				store.dispatch('GetInfo').then(res=>{//拉取user_info
					next()
				}).catch(()=>{
					store.dispatch('FedLogOut').then(()=>{
						Message.error('验证失败，请重新登录')
						next({path:'/login'})
					})
				})
			}else{
				next()
			}
		}
	}else{
		if(whiteList.indexOf(to.path)!==-1){
			next()
		}else{
			next('/login')

		}
	}
})

具体实现思路，当用户点击提交按钮，对表单信息格式验证，如果通过则触发vuex的actions里面login方法，在回调中跳转至主页面。actions的login方法的主要操作是调用api接口,处理数据，login里面是设置cookie(‘Token’,token)和改变state的token,因为是调用的api接口，所以在api里面的login接口，是主要书写接口的。

api文件的login接口

1
2
3
4
import axios from '@/utils/request'  //request中，创建了axios实例和拦截器的书写
export const login=(username, password)=>{
 return axios.post('/user/login',{username,password})
}

actions的login方法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
Login({commit},userInfo){  //负责接口处理
			 const username=userInfo.name.trim()
			return new Promise((resolve,reject)=>{
				login(username,userInfo.password).then(res=>{
					const data=res.data  //接收值
					setToken(data.token) //设置cookie
					commit('SET_TOKEN',data.token)   //设置state的token
					console.log(data)
					resolve()
				}).catch(error=>{
					reject(error)
				})
			})
		}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
//添加请求拦截器
axios.interceptors.request.use（function（config）{
     //在发送请求之前做某事
     return config;
   }，function（error）{
     //请求错误时做些事
     return Promise.reject（error）;
   }）;
//添加响应拦截器
axios.interceptors.response.use（function（response）{
     //对响应数据做些事
     return response;
   }，function（error）{
     //请求错误时做些事
     return Promise.reject（error）;
   }）;

2.动态侧边栏和面包屑
根据路由里面的配置，动态生成导航，router里面配置了meta,写了导航标题和小图标。在导航组件中遍历this.$router.options.routes ，这个可以获取到路由的信息，遍历时会有一些条件判断，根据需要来遍历，展示相应的导航。

3.vuex模块化和api接口
对于一些大型项目可以把vuex进行模块划分，调用模块里的方法需要带上模块名，而getters却是不区分模块的，所以getters的命名不能重复。api文件里面主要是抽离出来的api接口，最好组件名和接口文件命名相同，便于查找。

4.代理跨域proxy
在本地开发环境中一般会在proxytable里面进行设置，但是在生产环境中还是需要解决跨域的问题，所以在config/dev.env.js和config/prod.env.js都设置一下
dev.env.js

1
2
3
4
5
6
7
8
9
'use strict'
const merge = require('webpack-merge')
const prodEnv = require('./prod.env')

module.exports = merge(prodEnv, {
  NODE_ENV: '"development"',
  BASE_API: '"https://www.xxx.com"',
})

prod.env.js

1
2
3
4
5
6
'use strict'
module.exports = {
  NODE_ENV: '"production"',
  BASE_API: "https://www.xxx.com",
}

这里单独写了一个js文件来处理请求

1
2
3
4
5
6
7
// 创建axios实例
const service = axios.create({
  baseURL: process.env.BASE_API, // api的base_url,是开发环境还是生产环境会自动寻找路径
  timeout: 15000 // 请求超时时间
})
export default service

在main.js中引入,全局注册

1
2
import axios from './api/index.js'
Vue.prototype.$axios=axios

使用

1
2
3
this.$axios.get('api/v1/topic/'+this.id)
	.then(res=>{
})

项目过程中的记录

1 子组件和一些可复用组件
2 slot
3 :routes=”[child]” :key=”child.path”
4 matched=[{path:’/dashboard’,meta:{title:Dashboard}}].concat(matched)
5 filter
6 有header+main+sidebar，怎么在 main中点击 Header组件里的menu,去触发 SideBar的效果呢。这需要用到组件中的通信，并且不是父子组件，
参考方法 1可以使用this.$root.$emit和this.$root.$on试试,event bus 2vuex,因为项目里使用了vuex,所以应该是从vuex找方法了
7 路由懒加载和权限验证和进度条和中英文切换
8 require.context
9 promise
10 easy-mock.js
11 支持无限嵌套路由，所有侧边栏这块使用了递归组件
12 api模块和views组件命名一一对应