基於Element-admin-ui開發後臺管理系統

最近新項目，開始獨立作一個web B端管理系統，從框架搭建到初版項目線上部署，大概花了1月有餘時間。利用這兩天時間好好整理下這中間遇到的一些問題。

• 一  框架選擇

由於項目週期的緣由，所有本身開發的話花費時間週期將加長，通過多個框架對比，最後選擇了Element-admin-ui + vue。

以前有用過element UI，但Element-admin-ui仍是一次使用。

Element-admin-ui官網地址：https://panjiachen.github.io/vue-element-admin-site/zh/guide/

點擊 基礎模板 進入 github，按照步驟克隆下載，這裏就不一一介紹了。

有5篇 文章，請仔細閱讀

• 二 克隆運行

初始版本

• 三 探坑指南
• 1.token的存儲

管理員在登陸帳號後接口會返回一個token，並將其存到請求頭，以後在每一個接口請求時進行token驗證並進行攔截。

進入登陸頁，點登陸時調用接口正常返回可看到

我這邊是已經修改了登陸接口的地址，而後後端返回的數據。

而後將token存入請求頭中，名字請自行定義。而後token攔截的狀態碼需根據接口返回進行更改。

前期不須要攔截的話以下圖，將畫圈部分註釋，再將下面的return註釋打開便可

• 2. 動態路由控制

有個需求，管理員經過帳號登陸，接口返回對應的菜單，而後再添加到路由進行渲染。

Element-admin-ui裏面是經過登陸帳號的類型去判斷，如admin,super_editor等，由前端來控制。如今須要徹底由後端來返回路由進行跳轉，因此裏邊的內容須要改改。

找到\src\store\modules下user.js

這裏是調用登陸接口的地方，而後將登陸成功返回的數據增長到緩存中

// 登陸
    Login({ commit }, userInfo) {
      const username = userInfo.username.trim()
      return new Promise((resolve, reject) => {
        login(username, userInfo.password).then(response => {
          const data = response.data
          setToken(data.token)
          if (data.userInfoBO) { // 驗證返回的userInfoBO是不是一個非空數組
            commit('SET_ROLES', data.userInfoBO)
          } else {
            reject('getInfo: roles must be a non-null array !')
          }
          localStorage.setItem('routerslist', JSON.stringify(data.userMenuBOS)) // 存儲緩存 這裏拿到返回的菜單
          commit('SET_TOKEN', data.token)
          commit('SET_NAME', data.userInfoBO.nickName)
          localStorage.setItem('name', data.userInfoBO.nickName || '')
          commit('SET_AVATAR', data.userInfoBO.headImgUrl)
          resolve(response)
        }).catch(error => {
          reject(error)
        })
      })
    },

第2步，在router文件夾下新建兩個文件並放入內容

_import_development.js

module.exports = file => require('@/views/' + file + '.vue').default // vue-loader at least v13.0.0+

_import_production.js

module.exports = file => () => import('@/views/' + file + '.vue')

第3步，index.js下除了公共路由，其餘路由先註釋

第4步，打開permission.js，增長路由

import router from './router'
const _import = require('./router/_import_' + process.env.NODE_ENV) // 獲取組件的方法
import Layout from '@/views/layout/Layout' // Layout 是架構組件，不在後臺返回，在文件裏單獨引入
import NProgress from 'nprogress' // Progress 進度條
import { getToken } from '@/utils/auth' // 驗權

var getRouter // 用來獲取後臺拿到的路由
const whiteList = ['/login'] // 不重定向白名單
router.beforeEach((to, from, next) => {
  NProgress.start()
  if (getToken()) {
    if (to.path === '/login') {
      next({ path: '/' })
      NProgress.done() // if current page is dashboard will not trigger	afterEach hook, so manually handle it
    }
  } else {
    if (whiteList.indexOf(to.path) !== -1) {
      next()
    } else {
      next('/login')
      NProgress.done()
    }
  }
  if (!getRouter) { // 不加這個判斷，路由會陷入死循環
    if (!getObjArr('routers')) {
      // getRouter = rouerConfig // 後臺拿到路由
      getRouter = JSON.parse(window.localStorage.getItem('routerslist')) // 後臺拿到路由
      if (!getRouter) {
        console.log('沒拿到返回數據')
        return false
      }
      saveObjArr('routers', getRouter) // 存儲路由到localStorage
      routerGo(to, next) // 執行路由跳轉方法
      // axios.get('https://www.easy-mock.com/mock/5a5da330d9b48c260cb42ca8/example/antrouter').then(res => {
      //   console.log(res)
      //   getRouter = res.data.data.router//後臺拿到路由
      //   saveObjArr('routers', getRouter) //存儲路由到localStorage
      //   routerGo(to, next)//執行路由跳轉方法
      // })
    } else { // 從localStorage拿到了路由
      getRouter = getObjArr('routers') // 拿到路由
      routerGo(to, next)
    }
  } else {
    next()
  }
})

function routerGo(to, next) {
  getRouter = filterAsyncRouter(getRouter) // 過濾路由
  router.addRoutes(getRouter) // 動態添加路由
  global.antRouter = getRouter // 將路由數據傳遞給全局變量，作側邊欄菜單渲染工做
  next({ ...to, replace: true })
}

function saveObjArr(name, data) { // localStorage 存儲數組對象的方法
  localStorage.setItem(name, JSON.stringify(data))
}

function getObjArr(name) { // localStorage 獲取數組對象的方法
  return JSON.parse(window.localStorage.getItem(name))
}

// 遞歸操做
function filterAsyncRouter(asyncRouterMap) { // 遍歷後臺傳來的路由字符串，轉換爲組件對象
  const accessedRouters = asyncRouterMap.filter(route => {
    if (route.component) {
      if (route.component === 'Layout') { // Layout組件特殊處理
        route.component = Layout
      } else {
        route.component = _import(route.component)
      }
    }
    if (route.children && route.children.length) {
      route.children = filterAsyncRouter(route.children)
    }
    return true
  })

  return accessedRouters
}

第5步，打開\src\views\layout\components\Sidebar\index.vue，這個文件是控制左菜單展現,而後修改return，從新運行便可。

補充一下：當有一個超級管理的帳戶和一個普通帳戶，當登陸超級管理後返回菜單，而後非正常狀態退出（好比強制清除token，不清除緩存），這樣退出再登陸普通帳戶後管理頁面展現的菜單仍是超級管理的菜單。緣由是由於沒有清除緩存。

解決方式：

打開permission.js，在回到登陸頁時刪除localStorage

• 3.vue 前端經過接口下載excel表格

由於是管理端，會有各類表格，其中一定須要導出功能，element表格自帶選擇功能，加入方式請自行查看文檔。

那怎麼經過點擊導出選中下載表格呢？

 

剛開始我考慮的是用window.open，但這樣的話就不會經過token驗證和攔截了。因此這種方式不行

點導出後後端返回的是二進制流，後面想着用提交form表單的形式來提交，試了雖然能導出文件，但裏邊內容沒法展現出來，也只能pass。

 

後面通過同事提醒找到了Blob方法。實現方式以下：

第1步：接口的請求增長responseType: 'arraybuffer'

// 根據ID下載配送表
export function getDeliveryExport(params) {
  return request({
    url: '/manage/health/delivery/export?ids=' + params,
    responseType: 'arraybuffer',
    method: 'get'
  })
}

第2步，導出選中

// 導出選中
    addexport() {
      if (this.multipleSelection.length <= 0) {
        this.$message({
          showClose: true,
          message: '未選中數據',
          type: 'error'
        })
        return
      }
      for (let i = 0; i < this.multipleSelection.length; i++) {
        this.ids.push(this.multipleSelection[i].id)
      }
      console.log('導出', JSON.stringify(this.ids))
      getDeliveryExport(this.ids).then(
        function(response) {
          const filename = decodeURI(response.headers['content-disposition'].split(';')[1].split('=')[1]) || '分揀表.xlsx' // 獲取後端返回存在請求頭裏邊的表單名字
          this.fileDownload(response.data, filename)
        }.bind(this)
      ).catch(
        function(error) {
          this.$message({
            showClose: true,
            message: error,
            type: 'error'
          })
        }.bind(this)
      )
    },
    fileDownload(data, fileName) {
      const blob = new Blob([data], {
        type: 'application/octet-stream'
      })
      const filename = fileName || 'filename.xls'
      if (typeof window.navigator.msSaveBlob !== 'undefined') {
        window.navigator.msSaveBlob(blob, filename)
      } else {
        var blobURL = window.URL.createObjectURL(blob)
        var tempLink = document.createElement('a')
        tempLink.style.display = 'none'
        tempLink.href = blobURL
        tempLink.setAttribute('download', filename)
        if (typeof tempLink.download === 'undefined') {
          tempLink.setAttribute('target', '_blank')
        }
        document.body.appendChild(tempLink)
        tempLink.click()
        document.body.removeChild(tempLink)
        window.URL.revokeObjectURL(blobURL)
      }
    },

第3步，選中導出，完成