Vue前端模板框架--vue-admin-template

Posted 深夜无法入眠的程序猿

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Vue前端模板框架--vue-admin-template相关的知识,希望对你有一定的参考价值。

一、简介

vue-admin-template是基于vue-element-admin的一套后台管理系统基础模板(最少精简版),可作为模板进行二次开发。

GitHub地址:GitHub - PanJiaChen/vue-admin-template: a vue2.0 minimal admin template

建议:你可以在 vue-admin-template 的基础上进行二次开发,把 vue-element-admin当做工具箱,想要什么功能或者组件就去 vue-element-admin 那里复制过来。

二、使用

修改项目名称 vue-admin-template 改为 “自己定义的项目名称”
解压压缩包
进入目录
cd  “自己的项目名称下”
安装依赖
npm install
启动。执行后,浏览器自动弹出并访问http://localhost:9528/
npm run dev

三、源码目录结构

|-dist 生产环境打包生成的打包项目
|-mock 产生模拟数据
|-public 包含会被自动打包到项目根路径的文件夹
    |-index.html 唯一的页面
|-src
    |-api 包含接口请求函数模块
        |-table.js  表格列表mock数据接口的请求函数
        |-user.js  用户登陆相关mock数据接口的请求函数
    |-assets 组件中需要使用的公用资源
        |-404_images 404页面的图片
    |-components 非路由组件
        |-SvgIcon svg图标组件
        |-Breadcrumb 面包屑组件(头部水平方向的层级组件)
        |-Hamburger 用来点击切换左侧菜单导航的图标组件
    |-icons
        |-svg 包含一些svg图片文件
        |-index.js 全局注册SvgIcon组件,加载所有svg图片并暴露所有svg文件名的数组
    |-layout
        |-components 组成整体布局的一些子组件
        |-mixin 组件中可复用的代码
        |-index.vue 后台管理的整体界面布局组件
    |-router
        |-index.js 路由器
    |-store
        |-modules
            |-app.js 管理应用相关数据
            |-settings.js 管理设置相关数据
            |-user.js 管理后台登陆用户相关数据
        |-getters.js 提供子模块相关数据的getters计算属性
        |-index.js vuex的store
    |-styles
        |-xxx.scss 项目组件需要使用的一些样式(使用scss)
    |-utils 一些工具函数
        |-auth.js 操作登陆用户的token cookie
        |-get-page-title.js 得到要显示的网页title
        |-request.js axios二次封装的模块
        |-validate.js 检验相关工具函数
        |-index.js 日期和请求参数处理相关工具函数
    |-views 路由组件文件夹
        |-dashboard 首页
        |-login 登陆
    |-App.vue 应用根组件
    |-main.js 入口js
    |-permission.js 使用全局守卫实现路由权限控制的模块
    |-settings.js 包含应用设置信息的模块
|-.env.development 指定了开发环境的代理服务器前缀路径
|-.env.production 指定了生产环境的代理服务器前缀路径
|-.eslintignore eslint的忽略配置
|-.eslintrc.js eslint的检查配置
|-.gitignore git的忽略配置
|-.npmrc 指定npm的淘宝镜像和sass的下载地址
|-babel.config.js babel的配置
|-jsconfig.json 用于vscode引入路径提示的配置
|-package.json 当前项目包信息
|-package-lock.json 当前项目依赖的第三方包的精确信息
|-vue.config.js webpack相关配置(如: 代理服务器)

四、 修改登录功能

因为该模板使用的是mock数据,没有连接到后端系统。

所以当我们想要连接到自己写的后端系统时,需要对vue-admin-template进行改造。

 1、因为浏览器对Ajax请求具有限制问题,一下三个地方不同,就会产生跨域问题。

跨域问题的原因:访问协议、地址IP、端口号

前端地址:http://localhost:9258

后端地址:http://localhost:8800

解决方法:

第一种方法:

.env.development文件内,将

                VUE_APP_BASE_API = '/dev-api'
改为         VUE_APP_BASE_API = 'http://localhost:8800'

 

第二种方法:

在vue.config.js文件内

        注释掉mock接口配置

        配置代理转发请求到目标接口

// before: require('./mock/mock-server.js')
proxy: 
  '/dev-api':  // 匹配所有以 '/dev-api'开头的请求路径
    target: 'http://localhost:8800',
    changeOrigin: true, // 支持跨域
    pathRewrite:  // 重写路径: 去掉路径中开头的'/dev-api'
      '^/dev-api': ''
    
  

2、 修改src/utils/request.js的请求状态码

由于前端访问后端的数据,会传递一个状态码,后端返回数据的状态码可能是200,但是前端默认是20000,这时候需要把两者改为一样的即可,默认修改前端状态码的判断条件即可。

import axios from 'axios'
import  MessageBox, Message  from 'element-ui'
import store from '@/store'
import  getToken  from '@/utils/auth'

// create an axios instance
const service = axios.create(
  baseURL: process.env.VUE_APP_BASE_API, // url = base url + request url
  timeout: 5000 // request timeout
)

// request interceptor
service.interceptors.request.use(
  config => 
    if (store.getters.token) 
      config.headers['X-Token'] = getToken()
    
    return config
  ,
  error => 
    console.log(error) // for debug
    return Promise.reject(error)
  
)

// response interceptor
service.interceptors.response.use(
  response => 
    const res = response.data
    // if the custom code is not 20000, it is judged as an error.
    if (res.code !== 200) 
      Message(
        message: res.message || 'Error',
        type: 'error',
        duration: 5 * 1000
      )

      // 50008: Illegal token; 50012: Other clients logged in; 50014: Token expired;
      if (res.code === 50008 || res.code === 50012 || res.code === 50014) 
        // to re-login
        MessageBox.confirm('You have been logged out, you can cancel to stay on this page, or log in again', 'Confirm logout', 
          confirmButtonText: 'Re-Login',
          cancelButtonText: 'Cancel',
          type: 'warning'
        ).then(() => 
          store.dispatch('user/resetToken').then(() => 
            location.reload()
          )
        )
      
      return Promise.reject(new Error(res.message || 'Error'))
     else 
      return res
    
  ,
  error => 
    console.log('err' + error) // for debug
    Message(
      message: error.message,
      type: 'error',
      duration: 5 * 1000
    )
    return Promise.reject(error)
  
)

export default service

3、修改前端接口路径

src/api/user.js 中的 url 地址改为自己后端的发送地址。

import request from '@/utils/request'

export function login(data) 
  return request(
    url: '/admin/system/index/login',
    method: 'post',
    data
  )


export function getInfo(token) 
  return request(
    url: '/admin/system/index/info',
    method: 'get',
    params:  token 
  )


export function logout() 
  return request(
    url: '/admin/system/index/logout',
    method: 'post'
  )

4、修改后端的登录请求

@RestController
@RequestMapping("/admin/system/index")
public class IndexController 

    //login
    //"code":20000,"data":"token":"admin-token"
    @PostMapping("/login")
    public Result login(@RequestBody LoginVo loginVo) 
        Map<String, Object> map = new HashMap<>();
        map.put("token ", "admin-token-a");
        return Result.ok(map);
    

    //info
//    "code":20000,"data":"roles":["admin"],
//        "introduction":"I am a super administrator",
//                "avatar":"https://wpimg.wallstcn.com/f778738c-e4f8-4870-b634-56703b4acafe.gif",
//                "name":"Super Admin"
    @GetMapping("/info")
    public Result info(HttpServletRequest request)  
        Map<String, Object> map = new HashMap<>();
        map.put("roles", "[admin]");
        map.put("introduction", "管理员");
        map.put("avatar", "https://wpimg.wallstcn.com/f778738c-e4f8-4870-b634-56703b4acafe.gif");
        map.put("name", "Super Admin");
        return Result.ok(map);
    

5、添加登录失败的接口

vue端:

// user logout
  logout( commit, state ) 
    return new Promise((resolve, reject) => 
      logout(state.token).then(() => 
        removeToken() // must remove  token  first
        resetRouter()
        commit('RESET_STATE')
        resolve()
      ).catch(error => 
        reject(error)
      )
    )
export function logout() 
  return request(
    url: '/admin/system/index/logout',
    method: 'post'
  )

后端接口:

 @PostMapping("/logout")
    public Result logout() 
        return Result.ok();
    

另一种退出登录的方式是:

修改logout,直接退出,不发送请求。

// user logout
  logout( commit, state ) 
    return new Promise((resolve, reject) => 
        removeToken() // must remove  token  first
        resetRouter()
        commit('RESET_STATE')
        resolve()
 
    )

五、帮助

如果感觉对您有帮助,麻烦您给我一个小小的关注,这是经久不衰的动力。

前端框架VUE----计算属性和侦听器

模板内的表达式非常便利,但是设计它们的初衷是用于简单运算的。在模板中放入太多的逻辑会让模板过重且难以维护。例如:

<div>
    {{ message.split(‘‘).reverse().join(‘‘) }}
</div>

在这个地方,模板不再是简单的声明式逻辑。你必须看一段时间才能意识到,这里是想要显示变量 message 的翻转字符串。当你想要在模板中多次引用此处的翻转字符串时,就会更加难以处理。

所以,对于任何复杂逻辑,你都应当使用计算属性。

<div id = ‘com‘>
        <h3>{{msg}}</h3>
        <p>{{currentMsg}}</p>
        <button @click=‘clickHandler‘>更改</button>
</div>
    var com = new Vue({
            el:‘#com‘,
            data:{
                msg:‘学习computed‘
            },
            methods:{
                clickHandler(){

                    this.msg = ‘我更改了数据‘

                }

            },
            computed:{
                currentMsg(){
                    // computed方法中默认只有getter

                    return this.msg
                 }


                
            }

        })

当我点击按钮的时候更改了当前的数据,同时h3和p标签中数据也随时改变。

为什么会这样呢?

因为Vue知道com.currentMsg依赖与com.msg,因此当com.msg发生改变时,所有依赖com.currentMsg的绑定也会更新。而且最妙的是我们已经以声明的方式创建了这种依赖关系。:计算属性的getter函数是没有副作用的,这使它更易于测试和理解。

 

同样的上面操作,我们不用computed声明的计算属性方法,而仅仅通过methods中声明的方法也能完成上面的效果,那么为什么又要使用computed方法呢?

因为计算属性是基于它们的依赖进行缓存的。计算属性只有在它的相关依赖发生改变时才会重新求值。这就意味着只要msg还没有发生变化,多次访问currentMsg计算属性会立刻返回之前计算的结果,而不比再次执行函数。同样的。每当触发重新渲染时,调用方法将总会执行函数。

 

我们为什么需要缓存?假设我们有一个性能开销比较大的的计算属性 A,它需要遍历一个巨大的数组并做大量的计算。然后我们可能有其他的计算属性依赖于 A 。如果没有缓存,我们将不可避免的多次执行 A 的 getter!如果你不希望有缓存,请用方法来替代。

 

计算属性的getter

计算属性默认只有getter,不过在需要时你也可以提供一个setter。

  var com = new Vue({
            el:‘#com‘,
            data:{
                msg:‘学习computed‘
            },
            methods:{
                clickHandler(){

                    this.currentMsg = ‘我更改了数据‘

                }

            },
            computed:{
                currentMsg:{
                   set : function(newValue){
                      this.msg = newValue;
                   },
                   get : function(){
                     return this.msg;
                   }
                 }


                
            }

        })                            

当点击按钮的时候,会触发computed中的setter方法,从而将newValue的值,赋值给msg。因为计算属性方法的getter方法因为跟msg有依赖关系,从而会相应的发生改变。

 

以上是关于Vue前端模板框架--vue-admin-template的主要内容,如果未能解决你的问题,请参考以下文章

前端开发框架都有哪些?

前端啥框架更好用?

代码中怎么看出使用了vue框架

前端框架vue

MVC与vue2概要模板数据绑定与综合示例

Vue后台管理系统模板