谷粒学院4—讲师管理前端开发


阅读数: 次   

vue-admin-template

1.简介

我们开发讲师管理界面可以通过集成好的前端框架vue-element-admin基础上进行开发。

功能：https://panjiachen.github.io/vue-element-admin-site/zh/guide/#

GitHub地址：https://github.com/PanJiaChen/vue-element-admin

项目在线预览：https://panjiachen.gitee.io/vue-element-admin

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

GitHub地址：https://github.com/PanJiaChen/vue-admin-template

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

我们这次选择功能更精简的vue-admin-template来进行前端页面的开发。

将下载解压好的文件复制到工作区，接着进入cmd

这里由于它并没有自带所需要的依赖，我们需要通过npm下载。但是有些依赖被墙了，我们需要通过淘宝的cnpm进行安装。

1
2
3
4
5
6
7
8
9
10
11
#安装cnpm
npm install -g cnpm --registry=https://registry.npm.taobao.org

#查看是否安装成功
cnpm -v

# 安装依赖
cnpm install

# 启动。执行后，浏览器自动弹出并访问http://localhost:9528/
npm run dev

image-20210117112424911

2.目录结构

1
2
3
4
5
6
7
. 
├── build // 构建脚本
├── config // 全局配置 
├── node_modules // 项目依赖模块
├── src //项目源代码
├── static // 静态资源
└── package.jspon // 项目信息和依赖配置
1
2
3
4
5
6
7
8
9
10
11
12
13
src 
├── api // 各种接口 
├── assets // 图片等资源 
├── components // 各种公共组件，非公共组件在各自view下维护 
├── icons // 各种小图标
├── router // 路由表 
├── store // 存储 
├── styles // 各种样式 
├── utils // 公共工具，非公共工具，在各自view下维护 
├── views // 各种layout页面
├── App.vue //***项目顶层组件*** 
├── main.js //***项目入口文件***
└── permission.js //认证入口

image-20210117112254000

3.改造本地登录接口

系统默认登陆地址不是我们定义的，我们需要改成我们之前写的本地8001端口

image-20210117112748637

进入config/dev.env.js修改基础url

1
2
3
4
5
module.exports = merge(prodEnv, {
  NODE_ENV: '"development"',
  // BASE_API: '"https://easy-mock.com/mock/5950a2419adc231f356a6636/vue-admin"',
  BASE_API: '"http://localhost:8001"',
})

接着我们查看api下的login.js，查看其引用的方法是谁定义的。通过一层一层引用发现vue-admin-template\src\store\modules\user.jsy定义了此方法。

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
28
29
30
31
32
33
34
actions: {
    // 登录
    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)
          commit('SET_TOKEN', data.token)
          resolve()
        }).catch(error => {
          reject(error)
        })
      })
    },

    // 获取用户信息
    GetInfo({ commit, state }) {
      return new Promise((resolve, reject) => {
        getInfo(state.token).then(response => {
          const data = response.data
          if (data.roles && data.roles.length > 0) { // 验证返回的roles是否是一个非空数组
            commit('SET_ROLES', data.roles)
          } else {
            reject('getInfo: roles must be a non-null array !')
          }
          commit('SET_NAME', data.name)
          commit('SET_AVATAR', data.avatar)
          resolve(response)
        }).catch(error => {
          reject(error)
        })
      })
    },

经过分析我们发现进行登陆调用两个方法：login登录和getInfo获得用户信息方法。所以创建两个接口实现用户登录：

  1. login返回token值
  2. getInfo返回 roles、name、avatar

在service_edu模块下创建EduLoginController

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
@RestController
@RequestMapping("/serviceedu/user")
@CrossOrigin
public class EduLoginController {

    @PostMapping("login")
    public R login(){
        return R.ok().data("token","admin");
    }

    @GetMapping("info")
    public R getInfo(){
        return R.ok().data("roles","[admin]").data("name","admin").data("avatar",
                "https://pluto-1300780100.cos.ap-nanjing.myqcloud.com/img/6b1790b161aeec44249833a4a4a8c017d60d247f.jpg@518w.jpg");
    }
}

修改login.js方法的url使之和接口对应

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
export function login(username, password) {
  return request({
    url: '/serviceedu/user/login',
    method: 'post',
    data: {
      username,
      password
    }
  })
}

export function getInfo(token) {
  return request({
    url: '/serviceedu/user/info',
    method: 'get',
    params: { token }
  })
}

4.解决跨域问题

测试登陆，发现报错

image-20210117114237663

这是由于跨域而导致的问题，所谓跨域：

  • 访问协议
  • ip地址
  • 端口号

这三个有一个不一致就是跨域问题。我们采用CORS解决方案，在《品优购13—跨域解决方案与提交订单》中介绍过。在接口中添加注解@CrossOrigin即可解决（上面代码已添加）

接着测试发现成功进入

image-20210117114159665

02-改造登录到本地接口

讲师管理页面开发

1.添加路由

修改src\router\index.js

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
   path: '/teacher',
   component: Layout,
   redirect: '/teacher/table',//默认是/teacher/table显示
   name: '讲师管理',
   meta: { title: '讲师管理', icon: 'example' },
   children: [
     {
       path: 'table',
       name: '讲师列表',
       component: () => import('@/views/edu/teacher/list'),
       meta: { title: '讲师列表', icon: 'table' }
     },
     {
       path: 'save',
       name: '讲师添加',
       component: () => import('@/views/edu/teacher/save'),
       meta: { title: '讲师添加', icon: 'tree' }
     }
 },

image-20210117115122298

创建页面list.vue和save.vue

03-前端框架开发过程介绍

2.讲师列表实现

2.1定义api

创建文件 src/api/edu/teacher.js

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
import request from '@/utils/request'

const teacher_baseurl = '/serviceedu/teacher'

export default{
    //1 讲师列表(条件分页)
    getTeacherListPage(current,limit,teacherQuery){
        return request({
            url: `${teacher_baseurl}/pageCondition/${current}/${limit}`,
            method: 'post',
            //teacherQuery条件对象，后端使用的是RequestBody，表示要json数据
            //data表示把对象转成json数据传递到接口
            data: teacherQuery
        })
    },
}

2.2表格渲染

src/views/edu/teacher/list.vue

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
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
<template>
  <div class="app-container">
          <!--查询表单-->
    <el-form :inline="true" class="demo-form-inline">
      <el-form-item>
        <el-input v-model="teacherQuery.name" placeholder="讲师名"/>
      </el-form-item>

      <el-form-item>
        <el-select v-model="teacherQuery.level" clearable placeholder="讲师头衔">
          <el-option :value="1" label="高级讲师"/>
          <el-option :value="2" label="首席讲师"/>
        </el-select>
      </el-form-item>

      <el-form-item label="添加时间">
        <el-date-picker
          v-model="teacherQuery.begin"
          type="datetime"
          placeholder="选择开始时间"
          value-format="yyyy-MM-dd HH:mm:ss"
          default-time="00:00:00"
        />
      </el-form-item>
      <el-form-item>
        <el-date-picker
          v-model="teacherQuery.end"
          type="datetime"
          placeholder="选择截止时间"
          value-format="yyyy-MM-dd HH:mm:ss"
          default-time="00:00:00"
        />
      </el-form-item>

      <el-button type="primary" icon="el-icon-search" @click="getList()">查询</el-button>
      <el-button type="default" @click="resetData()">清空</el-button>
    </el-form>

    <!-- 表格 -->
    <el-table
      v-loading="listLoading"
      :data="list"
      element-loading-text="数据加载中"
      border
      fit
      highlight-current-row>

      <el-table-column
        label="序号"
        width="70"
        align="center">
        <template slot-scope="scope">
          {{ (page - 1) * limit + scope.$index + 1 }}
        </template>
      </el-table-column>

      <el-table-column prop="name" label="名称" width="80" />

      <el-table-column label="头衔" width="80">
        <template slot-scope="scope">
          {{ scope.row.level===1?'高级讲师':'首席讲师' }}
        </template>
      </el-table-column>

      <el-table-column prop="intro" label="资历" />

      <el-table-column prop="gmtCreate" label="添加时间" width="160"/>

      <el-table-column prop="sort" label="排序" width="60" />

      <el-table-column label="操作" width="200" align="center">
        <template slot-scope="scope">
          <router-link :to="'/teacher/edit/'+scope.row.id">
            <el-button type="primary" size="mini" icon="el-icon-edit">修改</el-button>
          </router-link>
          <el-button type="danger" size="mini" icon="el-icon-delete" @click="removeDataById(scope.row.id)">删除</el-button>
        </template>
      </el-table-column>
    </el-table>

    <!-- 分页 -->
    <el-pagination
      :current-page="page"
      :page-size="limit"
      :total="total"
      style="padding: 30px 0; text-align: center;"
      layout="total, prev, pager, next, jumper"
      @current-change="getList"
    />

  </div>
</template>

2.3查询和分页

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
28
29
30
31
32
33
34
<script>
//引入teacher.js文件
import teacher from '@/api/edu/teacher'

export default {
    data(){//定义变量和初始值
        return {
            list:null,//查询之后返回的讲师列表
            page:1,//当前页
            limit:10,//每页数量
            total:0,//总数量
            teacherQuery:{}//条件封装对象
        }
    },
    created(){//页面渲染之前调用
        this.getList()
    },
    methods: {//定义方法
        //分页查询
        getList(page =1){//page默认为1
            this.page = page
            teacher.getTeacherListPage(this.page,this.limit,this.teacherQuery)
                .then(res => {//请求成功
                    this.total=res.data.total
                    this.list = res.data.rows
                })
        },
        resetData(){//清空查询条件
            this.teacherQuery = {}
            this.getList()
        }
    } 
}
</script>

04-讲师列表前端开发

05-讲师列表前端开发（分页和条件查询）

3.讲师删除

（1）定义api

1
2
3
4
5
6
7
//删除讲师
removeById(id){
    return request({
        url: `${teacher_baseurl}/delete/${id}`,
        method: 'delete'
    })
},

（2）定义methods，使用MessageBox 弹框组件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
//逻辑删除
removeDataById(id){
    this.$confirm('此操作将永久删除该文件, 是否继续?', '提示', {
        confirmButtonText: '确定',
        cancelButtonText: '取消',
        type: 'warning'
    }).then(() => {
        teacher.removeById(id).then(() => {
            this.$message({
                type: 'success',
                message: '删除成功!'
            })
            this.getList()
        })
    })
}

06-讲师删除功能前端实现

4.讲师添加和更新

4.1定义api

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
//添加讲师
    save(teacher){
        return request({
            url: `${teacher_baseurl}/add`,
            method: 'post',
            data: teacher
        })
    },
    //根据id查询讲师
    getInfoById(id){
        return request({
            url: `${teacher_baseurl}/getById/${id}`,
            method: 'get'
        })
    },
    //根据id修改讲师
    updateById(teacher){
        return request({
            url: `${teacher_baseurl}/update`,
            method: 'post',
            data: teacher
        })
    }

4.2初始化组件

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
28
29
30
31
32
33
34
<template>
  <div class="app-container">
    <el-form label-width="120px">
      <el-form-item label="讲师名称">
        <el-input v-model="teacher.name"/>
      </el-form-item>
      <el-form-item label="讲师排序">
        <el-input-number v-model="teacher.sort" controls-position="right" min="0"/>
      </el-form-item>
      <el-form-item label="讲师头衔">
        <el-select v-model="teacher.level" clearable placeholder="请选择">
          <!--
            数据类型一定要和取出的json中的一致，否则没法回填
            因此，这里value使用动态绑定的值，保证其数据类型是number
          -->
          <el-option :value="1" label="高级讲师"/>
          <el-option :value="2" label="首席讲师"/>
        </el-select>
      </el-form-item>
      <el-form-item label="讲师资历">
        <el-input v-model="teacher.career"/>
      </el-form-item>
      <el-form-item label="讲师简介">
        <el-input v-model="teacher.intro" :rows="10" type="textarea"/>
      </el-form-item>

      <!-- 讲师头像：TODO -->

      <el-form-item>
        <el-button :disabled="saveBtnDisabled" type="primary" @click="saveOrUpdate">保存</el-button>
      </el-form-item>
    </el-form>
  </div>
</template>

4.3更新路由

由于我们添加和更新都在一个页面，所以我们需要更新一下路由

修改按钮：

1
2
3
<router-link :to="'/teacher/edit/'+scope.row.id">
    <el-button type="primary" size="mini" icon="el-icon-edit">修改</el-button>
</router-link>

路由：

1
2
3
4
5
6
7
{
        path: 'edit/:id',//:id表示带参数
        name: 'EduTeacherEdit',
        component: () => import('@/views/edu/teacher/save'),//指向同一个页面
        meta: { title: '编辑讲师', noCache: true },
        hidden: true
      }

4.4完善方法

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
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
<script>
import teacherApi from '@/api/edu/teacher'

export default {
    data() {
        return {
            teacher: {},
            saveBtnDisabled: false // 保存按钮是否禁用,
        }
    },
    created(){
        this.init()
    },
    methods: {
        init(){
            //根据参数判断是添加还是修改
            if (this.$route.params && this.$route.params.id) {
                const id = this.$route.params.id
                this.getTeacher(id)
            }else{//添加需要把teacher值清空
                this.teacher = {}
            }
        },

        saveOrUpdate() {
            this.saveBtnDisabled = true
            if(!this.teacher.id){
                this.saveData()
            }else{
                this.update()
            }
        },

        // 保存
        saveData() {
            teacherApi.save(this.teacher).then(() => {
                this.$message.success("添加成功！")
                //回到列表页面 跳转路由
                this.$router.push({path:'/teacher/table'})
            })
        },
        update(){
            teacherApi.updateById(this.teacher).then(()=>{
                this.$message.success("修改成功！")
                //回到列表页面 跳转路由
                this.$router.push({path:'/teacher/table'})
            })
        },

        //根据id查询
        getTeacher(id){
            teacherApi.getInfoById(id).then((res)=>{
                this.teacher = res.data.item
            }).catch(()=>{
                this.$message.error("获取数据失败")
            })
        }

  }
}
</script>

08-讲师修改功能前端实现

4.5存在问题

vue-router导航切换 时，如果两个路由都渲染同个组件，组件会重（chong）用,

组件的生命周期钩子（created）不会再被调用, 使得组件的一些数据无法根据 path的改变得到更新

因此：

1、我们可以在watch中监听路由的变化，当路由变化时，重新调用created中的内容

2、在init方法中我们判断路由的变化，如果是修改路由，则从api获取表单数据，如果是新增路由，则重新初始化表单数据

1
2
3
4
5
6
watch: {//监听
    $route(to, from) {//当路由发生改变时调用此方法
        console.log('watch $route')
        this.init()
    }
},

10-路由切换问题

赏

谢谢你请我吃糖果

支付宝
微信

扫一扫，分享到微信

微信分享二维码

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置： 

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

很惭愧<br><br>只做了一点微小的工作<br>谢谢大家