Express做后端服务详细步骤，从零到一_express脚手架

一、全局安装脚手架

npm install -g express-generator
1

二、生成项目

1.生成项目

express myapp
1

PS: 此命令会在你所在的当前目录下生成一个名为myapp的express项目

然后进入该项目并安包：

cd myapp
npm i
1
2

然后启动项目：

npm start
1

然后在浏览器中打开 http://localhost:3000/ 网址就可以看到这个应用了。

2.目录结构介绍

通过脚手架创建的应用一般都有如下目录结构：

我们一个一个文件先暂时了解一下其作用：

3.拓展：配置文件热更新（避免改一次文件重启一次服务）

步骤1：安装nodemon

全局安装nodemon

npm install -g nodemon
1

或者进到项目目录里安装到项目中

npm install nodemon --save
1

步骤2：创建nodemon.json文件

然后在项目根目录下创建nodemon.json文件
文件内容：

{
    "restartable": "rs",
    "ignore": [
        ".git",
        ".svn",
        "node_modules/**/node_modules"
    ],
    "verbose": true,
    "execMap": {
        "js": "node --harmony"
    },
    "watch": [],
    "env": {
        "NODE_ENV": "development"
    },
    "ext": "ejs js json"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

步骤3：更改启动命令

然后我们更改package.json中的启动命令：

找到scripts下的start、把node换成nodemon

{
  "scripts": {
    "start": "nodemon ./bin/www"
  }
}
1
2
3
4
5

步骤4：上述步骤全部成功之后重启服务验证

关闭当前服务后我们从新npm start启动服务，启动服务成功后我们修改一个接口的返回内容保存后到界面上试一下是否接口返回值变了，如果变了说明热更新配置成功，如果没变请按照步骤一从新确认一下是否全部操作成功并且保存文件了。

三、做具体需求

1.需求描述

比如我们现在有一个用户发送消息给我们，然后我们存到数据库中的一个需求，我们现在来一起实践一下。

2.前端发送请求(这里笔者是react代码用的window.fetch进行的简单请求)

// 请求方法
export const saveUserInfo = (params) => {
    return fetch('http://localhost:3000/users/sendDemand', {
        method: 'POST',
        body: JSON.stringify(params),
        headers: {
            'Content-Type': 'application/json',
        }
    }).then(res => res.json()).catch(err => err);
}
1
2
3
4
5
6
7
8
9
10

PS: params可按照自己具体需求传，笔者这里的params是：

{
 "userName": "1",
 "email": "2",
 "phone": "3",
 "userDesc": "4"
}
1
2
3
4
5
6

3.后端跨域配置（不配置的话前端本地服务与后端本地服务由于同源策略的问题是无法通信的）

请看：配置指定IP地址允许跨域访问

4.搭建数据库

由于内容过多，请访问：
本地安装Mysql并配置
Navicat for MySQL的使用

5.express连接mysql数据库

①安装依赖：

// 必装项：连接mysql服务的
npm i mysql -S
// 选装项：如果你需要校验请求参数的话就安express-validator
npm i express-validator -S
// 选装项：如果你需要获取用户的详细IP信息的话就安express-ip
npm i express-ip -S
1
2
3
4
5
6

②准备工作代码编写

如果你安装了express-ip，请在app.js中增加：

const expressip = require('express-ip');

app.use(expressip().getIpInfoMiddleware);
1
2
3

在根目录创建db文件夹，然后创建connection.js文件
文件内容如下：

//引入mysql
const mysql = require("mysql");

// 连接数据库的信息
const db = {
    host: 'localhost', //数据库地址,上线了之后替换你的服务器IP地址即可
    port: '3306',//端口号
    user: 'root',//用户名
    password: '',//填写你的数据库root账户的密码
    database: 'official_website'//要访问的数据库名称
};

// 封装数据库连接方法
const connectionDB = (sql, params, cb) => {
    // 创建数据库连接
    const connection = mysql.createConnection(db);
    // 连接数据库
    connection.connect((err, conn) => {
        if (err) {
            console.log("数据库连接失败");
            return;
        }
        console.log("数据库连接成功");
        connection.query(sql, params, cb)
    })
}

module.exports = connectionDB;
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

③实际业务代码编写

const DB = require('../db/connection');
const { body, validationResult } = require('express-validator');
var express = require('express');
var router = express.Router();

/* 接收用户需求接口 */
router.post(
  '/sendDemand',
  body('userName').notEmpty().withMessage('用户名不能为空'),
  body('phone').notEmpty().withMessage('手机号不能为空'),
  body('demand').notEmpty().withMessage('需求描述不能为空'),
  function (req, res, next) {
    // 校验参数
    const errors = validationResult(req);
    if (!errors.isEmpty()) {
      return res.status(400).json({ errMsg: errors.array()[0]?.msg });
    }
    // END-校验参数
    // 解构参数并执行SQL
    const { userName, phone, email, demand } = req.body;
    DB(
      'insert into user_demand(name, phone, email, demand, ip_info) values(?, ?, ?, ?, ?)',
      [userName, phone, email, demand, JSON.stringify(req.ipInfo)],
      function (err, result) {
        if (err) {
          console.log('[SELECT ERROR]：');
          res.status(500).json({ msg: err.message });
        } else {
          res.send({
            code: 200,
            msg: '发送成功~我们会尽快联系您！',
          });
        }
      }
    );
    // END-解构参数并执行SQL
  });

module.exports = router;
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

6.串联自测功能

当前端的参数后端服务都接收到了且存到数据库了就证明没问题了~

全部完成~~