Vue.js 学习笔记之三：与服务器的数据交互

显而易见的，之前的02_toDoList存在着一个很致命的缺陷。那就是它的数据只存在于浏览器端，一但用户关闭或重新载入页面，他之前加入到程序中的数据就会全部丢失，一切又恢复到程序的初始状态。要想解决这个问题，就需要 Web 应用的前端在适当的时间将获得的输入数据存储到后端服务器上，然后在需要时再从服务器上获取这些数据。这部分笔记将记录如何利用 Vue.js 框架来完成 Web 应用程序的前端与后端之间的交互。这一次，我同样会通过构建一个"留言本"应用来贯穿整个学习过程。

首先需要在code目录下依次执行npm install express body-parser knex和npm install sqlite3@<指定的版本>命令，安装接下来创建 Web 服务所需要的后端组件（需要注意的是，这里安装的sqlite3要根据knex安装后的提示选择对应的版本）。接下来，在code目录下创建一个名为03_Message的目录，并在该目录下执行npm init -y命令，将其初始化成一个 Node.js 项目。在这里，之所以将服务端所需要的组件安装在项目目录的上一级目录中，是因为我接下来还需要在项目目录中安装前端组件，并将其开放给浏览器端访问，所以前后端所需要的组件最好分开存放。

现在，我要基于 Express 框架来创建一个 Web 服务了。具体做法就是在code/03_Message目录下创建一个名为index.js的服务器端脚本文件，并在其中输入如下代码：

const path = require('path');
const express = require('express')
const bodyParser = require('body-parser');
const knex = require('knex');
const port = 8080;

// 创建服务器实例
const app = express();

// 配置 public 目录，将其开放给浏览器端
app.use('/', express.static(path.join(__dirname, 'public')));
// 配置 node_modules 目录，将其开放给浏览器端
app.use('/node_modules', express.static(path.join(__dirname, 'node_modules')));

//配置 body-parser 中间件，以便获取 POST 请求数据。
app.use(bodyParser.urlencoded({ extended : false}));
app.use(bodyParser.json());

// 创建数据库连接对象：
const appDB = knex({
    client: 'sqlite3', // 设置要连接的数据类型
    connection: {      // 设置数据库的链接参数
        filename: path.join(__dirname, 'data/database.sqlite')
    },
    debug: true,       // 设置是否开启 debug 模式，true 表示开启
    pool: {            // 设置数据库连接池的大小，默认为{min: 2, max: 10}
        min: 2,
        max: 7
    },
    useNullAsDefault: true
});

appDB.schema.hasTable('notes')  // 查看数据库中是否已经存在 notes 表
.then(function(exists) {
    if(exists == false) { // 如果 notes 表不存在就创建它
        appDB.schema.createTable('notes', function(table) {
            // 创建 notes 表：
            table.increments('uid').primary();// 将 uid 设置为自动增长的字段，并将其设为主键。
            table.string('userName');         // 将 userName 设置为字符串类型的字段。
            table.string('noteMessage');      // 将 notes 设置为字符串类型的字段。
    });
  }
})
.then(function() {
    // 请求路由
    // 设置网站首页
    app.get('/', function(req, res) {
        res.redirect('/index.htm');
    });

    // 响应前端获取数据的 GET 请求
    app.get('/data/get', function(req, res) {
        appDB('notes').select('*')
        .then(function(data) {
            console.log(data);
            res.status(200).send(data);
        }).catch(function() {
            res.status(404).send('找不到相关数据');
        });
    });

    // 响应前端删除数据的 POST 请求
    app.post('/data/delete', function(req, res) {
        appDB('notes').delete()
        .where('uid', '=', req.body['uid'])
        .catch(function() {
            res.status(404).send('删除数据失败');
        });
        res.send(200);
    });

    // 响应前端添加数据的 POST 请求
    app.post('/data/add', function(req, res) {
        console.log('post data');
        appDB('notes').insert(
            {
                userName : req.body['userName'],
                noteMessage : req.body['noteMessage']
            }
        ).catch(function() {
            res.status(404).send('添加数据失败');
        });
        res.send(200);
    });

    // 监听 8080 端口
    app.listen(port, function(){
        console.log(`访问 http://localhost:${port}/，按 Ctrl+C 终止服务！`);
    });
})
.catch(function() {
    // 断开数据库连接，并销毁 appDB 对象
    appDB.destroy();
});

由于 Vue.js 框架的特点，前端需要后端提供的服务除了获取指定的 HTML 和 JavaScript 文件之外，主要就是对数据库的增删改查操作了，所以在上面这个服务中，除了将public、node_modules目录整体开放给浏览器端访问之外，主要提供了一个基于 GET 请求的数据查询服务，和两个基于 POST 请求的数据添加与删除操作。

接下来，我可以开始前端部分的构建了。首先需要在code/03_Message目录下执行npm install vue axios命令，安装接下来所要用到的前端组件（该命令会自动生成一个node_modules目录，正如上面所说，该目录会被服务端脚本整体开放给浏览器端）。然后，继续在同一目录下创建public目录，并在其中创建一个名为index.htm的文件，其代码如下：

<!DOCTYPE html>
<html lang="zh-cn">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <script defer="defer" src="/node_modules/vue/dist/vue.js"></script>
    <script defer="defer" src="/node_modules/axios/dist/axios.js"></script>
    <script defer="defer" src="/js/main.js"></script>
    <title>留言本</title>
</head>
<body>
    <div id="app">
        <h1>留言本</h1>
        <div id="showNote" v-for="note in notes">
            <span>{{ note.userName }} 说：{{ note.noteMessage }} </span>
            <input type="button" value="删除" @click="remove(note.uid)">
        </div>
        <div id="addMessage">
            <h2>请留言：</h2>
            <label :for="userName">用户名：</label>
            <input type="text" v-model="userName">
            <br>
            <label :for="Message">写留言：</label>
            <input type="text" v-model="Message"></input>
            <input type="button" value="添加留言" @click="addNew">
        </div>
    </div>
</body>
</html>

这个页面主要被分为了两个部分，第一部分会根据notes中的数据使用v-for指令迭代显示已被添加到数据库中的留言，并提供了一个删除按钮以便删除指定的留言（使用v-on指令绑定单击事件处理函数）。第二部分则是一个用于添加留言的输入界面，这里使用了v-model指令来获取需要用户输入的userName和Message数据。现在，我需要来创建相应的 Vue 对象实例了，为此，我会在刚才创建的public目录下再创建一个js目录，并在其中创建名为main.js的自定义前端脚本文件，其代码如下：

// 程序名称： Message
// 实现目标：
//   1. 学习 axios 库的使用
//   2. 掌握如何与服务器进行数据交互

const app = new Vue({
    el: '#app',
    data:{
        userName: '',
        Message: '',
        notes: []
    },
    created: function() {
        that = this;
        axios.get('/data/get')
        .then(function(res) {
            that.notes = res.data;
        })
        .catch(function(err) {
            console.error(err);
        });
    },
    methods:{
        addNew: function() {
            if(this.userName !== '' && this.Message !== '') {
                that = this;
                axios.post('/data/add', {
                    userName: that.userName,
                    noteMessage: that.Message
                }).catch(function(err) {
                    console.error(err);
                });
                this.Message = '';
                this.userName = '';
                axios.get('/data/get')
                .then(function(res) {
                    that.notes = res.data;
                })
                .catch(function(err) {
                    console.error(err);
                });
            }
        },
        remove: function(id) {
            if(uid > 0) {
                that = this;
                axios.post('/data/delete', {
                    uid : id
                }).catch(function(err) {
                    console.error(err);
                });
                axios.get('/data/get')
                .then(function(res) {
                    that.notes = res.data;
                })
                .catch(function(err) {
                    console.error(err);
                });
            }
        }
    }
});

这个 Vue 实例与我们之前创建的大同小异，主要由以下四个成员组成：

el成员：用于以 CSS 选择器的方式指定 Vue 实例所对应的元素容器，在这里，我指定的是<div id="app">元素。
data成员：用于设置页面中绑定的数据，这里设置了以下三个数据变量：
- notes：这是一个数组变量，用于存放已被添加的留言记录。
- userName：这是一个字符串变量，用于获取"用户名"数据。
- Message：这是一个字符串变量，用于获取"留言"数据。
created成员：用于在程序载入时做初始化操作，在这里，我从服务端读取了已被添加的留言记录，并将其加载到notes变量中。
methods成员：用于定义页面中绑定的事件处理函数，这里定义了以下两个事件处理函数：
- addNew：用于添加新的留言记录，并同步更新notes中的数据。
- remove：用于删除指定的留言记录，并同步更新notes中的数据。

通常情况下，我们在 Vue.js 框架中会选择使用 axios 这样的第三方组件来处理发送请求和接收响应数据的工作，引入该组件的方式与引入 Vue.js 框架的方式是一样的，可以像上面一样先下载到本地，然后使用<script>标签引入，也可以使用 CDN 的方式直接使用<script>标签引入，像这样：

<!-- 开发环境版本，包含了有帮助的命令行警告 -->
<script src="https://unpkg.com/axios/dist/axios.js"></script>
<!-- 或者 -->
<!-- 生产环境版本，优化了文件大小和载入速度 -->
<script src="https://unpkg.com/axios/dist/axios.min.js"></script>

需要注意的是，该引用标签在 HTML 页面中的位置必须要在自定义 JavaScript 脚本文件（即main.js）的引用标签之前。当然，我在上述代码中只展示了axios.get和axios.post这两个最常用方法的基本用法，由于该组件支持返回 Promise 对象，所以我们可以采用then方法调用链来处理响应数据和异常状况。关于 axios 组件更多的使用方法，可以参考相关文档（http://www.axios-js.com/zh-cn/docs/）。

owlman

Vue.js 学习笔记之三：与服务器的数据交互