48

写在前面

本文只是本人学习过程的一个记录,并不是什么非常严谨的教程,希望和大家一起共同进步。也希望大家能指出我的问题。适合有一定基础,志在全栈的前端初学者学习,从点击按钮提交ajax到获得服务器response,然后更新页面,这其中到底发生了什么?下面我们就来实现一个小demo,以前后端分离的方式独立跑通一个简单的增删改查流程,迈出全栈第一步。

用到的一些技术栈

  • 数据库:mysql mysqlfront(数据库gui工具)
  • 后端:node express mysqljs(node数据库模块)
  • 前端: vue(mvvm框架) elment-ui(快速搭建前端页面) axios(ajax) webpack(构建工具)

后端负责提供接口,操作数据库提供前端所需的数据和状态。
前端负责调用接口,将数据展示给用户,并对用户的一些操作转发给后端处理。
数据库当然是负责存储数据啦,关于数据库,网上很多教程都是使用mongodb,通过mongoose操作mongdb的确比mysql便捷很多,不过实际工作中还是使用mysql的多,技术还是得回归实际应用才能体现出价值。

本demo使用node创建本地服务器,在localhost就能完成全部流程,并不需要线上服务器。虽然功能非常简单,但是用的的模块和工具还是蛮多的,建议大家把注意力放在从前到后的这个流程上,一些工具和库的使用我也不详细介绍了,大家自己google,要成为全栈这点学习能力还是要有的。

项目结构

先上github仓库地址

项目结构

大致介绍下项目结构,前后端在不同的文件夹下面,互不影响。前端使用webpack构建,利用webpack-dev-server开发,前端入口是localhost:8888/dist/index.html。后端使用express框架,利用nodemon自动重启,主机是localhost:9999。使用webpack-dev-server和express分别创建了两个服务器,用同一个端口会冲突,so这里会有跨域问题,不过用devserver可以轻松解决,后面会说到具体解决办法。如果是线上服务器的话放一个里面就行了。

先从前端开始

首先用vue-cli生成项目模板就行了,用webpack-simple就够了,改相关配置方便点。

我们的页面很简单,主要有两个组件list.vue(展示所有数据和相关操作),一个form.vue(新增及修改商品),这么一个页面各位前端估计啪啪几下就搞定了吧,至于你用不用element-ui都无所谓,用的话速度快点颜值高点。大家请无视我项目里使用的pug(jade)模板、饿了么主题文件、登录组件等,这只是为了方便以后扩展。前端index.html用一个空壳就行了。

list
form

配置一下前端路由,/admin下有两个子页面,list和form,默认为list(一般默认是个后台概况页)

export default new Router({
    routes: [
        {
            path: '/admin',
            redirect: '/admin/list',
            name: 'admin',
            component: Admin,
            children: [
                {
                    path: '/admin/list',
                    name: 'list',
                    component: List,
                },
                {
                    path: '/admin/form',
                    name: 'form',
                    component: Form,
                },]
        },
    ]
});

静态部分基本完成了,下面来编写组件中的数据流转逻辑

列表的数据是从后端来的,所以list组件的created钩子里应有一个获取全部数据的ajax。先不急着上,要用ajax的地方很多,那么我们先对ajax方法做一个封装吧。

// pubulic/func.js

import axios from "axios";

export default {
    ajaxGet (api, cb) {
        axios.get(api)
            .then(cb)
            .catch(err => {
                console.log(err);
            })
    },
    ajaxPost (api, post, cb) {
        axios.post(api, post)
            .then(cb)
            .catch(err => {
                console.log(err);
            })
    },
}

这里我们使用的axios模块来进行ajax请求,写法是promise的链式操作,封装一个get和一个post就够用了。

// pubulic/api.js

let host = '/api';

export default {
    goodsList: host + '/goods-list',
    goodsDetail: host + '/goods-detail',
    goodsDelete: host + '/goods-delete',
    goodsAdd: host + '/goods-add',
}

同样在public文件夹下创建一个api.js把所有的接口信息都写在一起,方便后续修改。路径要与后端接口一致。

下面解决跨域问题,配置一下devserver.proxy就能轻松搞定,按照下面的配置,路径以/api开头的请求就会被node服务器转发到9999端口,关于webpack的一些东西可以看看我的另一篇文章关于webpack的一点小心得

// webpack.config.js
// ...

devServer: {
    port: 8888,
    historyApiFallback: true,
    stats: 'minimal',  // 输入精简信息
    overlay: true, // 将错误显示在html之上
    proxy: {
        '/api': {
            target: 'http://localhost:9999',
            secure: false,
            changeOrigin: true,
        }
    }
},

终于要进入组件中写具体的业务逻辑了,我们在created里拿到数据,渲染进表格。虽然后端还没开始呢,但我们期望res.data是一个包含所有商品的数组(如果数据大了还要分页哦),数据之后在后端中处理,实际项目中可以使用mock模拟数据。

删除操作把要删除的商品id post至指定接口,然后在回调里判断返回的状态,这个status应该是约定好的,我就设为201是成功好了。后端返回成功后,前端数据中对应的元素也要删掉,更新视图。

// list.vue

import func from '../../public/func';
import api from '../../public/api';
// ...省略代码若干行

methods: {
    // 删除
    handleDelete(row) {
        func.ajaxPost(api.goodsDelete, {id: row.Id}, res => {
            if (res.status === 201) {
                let index = this.tableData.indexOf(row);
                this.tableData.splice(index, 1);
                this.$message.success('删除成功');
            }
        });
    },

    // 修改
    handleEdit (row) {
        this.$router.push({name: 'form', query: {id: row.Id}});
    },
},

created () {
    func.ajaxGet(api.goodsList, res => {
        this.tableData = res.data;
    });
},

list页的修改操作就是路由跳转到form页了,同时把id以query形式传过去。在form的created钩子里判断,如果有query.id的话就说明是在修改商品,没有的话就是添加,这样就可以复用这个form组件咯。不爱偷懒的程序员不是好程序员。这个修改操作也可以用vuex把商品数据传递过来,不过页面刷新就没有了,还是用ajax稳妥。

// form.vue

// ...省略代码若干行

created () {
    let id = this.$route.query.id;
    console.log(id);
    if (id) {
        func.ajaxPost(api.goodsDetail, {id}, res => {
            this.form = res.data;
        });
    }
},

其他的一些操作不具体说了,都挺简单的,让我们进入久违的后端吧。

创建数据库

来到后端第一步就是创建一个数据库,这里我用的是phpstudy附带的,当然你也可以自己装,毕竟这个附带的还是老旧的5.5版本。sql语句我玩不来啊就用phpstudy附带的mysqlfront这个gui工具来撸了。建一个叫vue-admin的库,然后一张goods的表,只有id,name,price,create_time这四个字段,简单明了。
mysql

编写后端接口

终于玩到node了,首先全局安装nodemon帮我们自动重启,然后装好express等包,新手不推荐使用express-generator创建项目。看到这里请大家先去预习一下mysqljs这个模块。

我们把数据库的配置写在单独的文件中,抽离配置文件是一个好习惯。然后在控制器中使用mysql.createPool(db)创建连接池。

// db.js

module.exports = {
    host: 'localhost',
    port: 3306,
    user: 'root',
    password: 'root',
    database: 'vue-admin'
};

// controls/goods.js

let pool = mysql.createPool(db);

下面编写增删改查等路由接口,与前端的api.js中的路径保持一致,get还是post根据情况而定,回调函数不写在这里写进控制器goods.js中。在入口文件中use router,这时候我们的接口路径就是/api/goods-list

// router.js

router.get('/goods-list', goods.getGoodsList);
router.post('/goods-detail', goods.getOneGoods);
router.post('/goods-add', goods.addGoods);
router.post('/goods-delete', goods.deleteGoods);

module.exports = router;

// app.js

let router = require('./routes/router');
app.use('/api', router);

控制器中同样是增删改查四个方法,首先我们把一些可复用的sql语句封装起来。这是mysqljs中的语法,?就是变量,双??是表名或字段名,单?则为value。insert和update就不封装了,涉及到具体字段,直接写好了。

// sql.js

module.exports = {
    queryAll: 'SELECT * FROM ??',
    queryById: 'SELECT * FROM ?? WHERE id=?',
    del: 'DELETE FROM ?? WHERE id=?',
};

控制器里拿一个方法出来说一下吧,完整的代码都在github。使用pool.getConnection方法从连接池建立连接,SELECT * FROM goods获取goods表中所有数据,res.json将数据以json格式传给前端。读取操作完成后调用release()释放连接。rows及前端拿到的res的数据格式大家可以console看一下,都是数组类型。

// 获取商品列表
    getGoodsList (req, res) {
    pool.getConnection((err, conn) => {
        conn.query(sql.queryAll, 'goods', (err, rows) => {
            if (err) throw err;

            rows = formatDate(rows);
            res.json(rows);

            conn.release();
        });
    });
},

// formatDate函数利用moment.js将数据库中的时间戳格式转化为年月日的格式
function formatDate(rows) {
    return rows.map(row => {
        let date = moment(row.create_time).format('YYYY-MM-DD');
        return Object.assign({}, row, {create_time: date});
    });
}

写后端接口的时候还跑去前端提交请求比较蛋疼,这里推荐大家使用postman这个工具来测试接口,提高效率。postman可以以chrome插件的形式安装,十分方便。

postman

后端接口跑通后,前后端协调修改一下,从前端调用接口,到后端从数据库中读取数据,最后返回给前端,整个流程至此就跑通了。

全栈之路修远兮

我们只是完成了一个web应用最最基本的功能,新手可能一脸懵逼,大牛可能一脸蔑视,全栈之路还远着呢。接下来需要去增加登录等模块,更复杂的业务逻辑,还有安全方面的考虑,让程序健壮起来,大家一起加油吧。


无风
670 声望63 粉丝