Epxress.js 快速入门

Express 是 Node.js 的 web 开发框架。它是 unopinionated 意思是框架本身只提供最小 web 应用开发 API，不限制应用设计模式（比如 MVC，MVP)、代码规范以及功能的选择（例如是否有视图层生成 html 页面）。

创建 Express 项目

要创建 Express 项目，只需要初始化一个 Node.js 项目然后添加 express 依赖：

yarn add express

或

npm install express

启动 express 项目

然后用 VS Code 打开项目，新建一个 app.js 文件，编写启动 express 的代码：

// 1. 首先引入 express 库：
const express = require('express');
// 2. 创建 express 的实例，代表服务器
const app = express();
// 3. 设置监听端口
const port = 3000;

// 4. 调用 app.listen 来启动 server 并监听指定端口，启动成功后打印出 log
app.listen(port, () => console.log(`Express server listening at http://localhost:${port}`));

编写完毕之后，使用命令：

node app.js

来启动 express 服务。启动成功后可以看到日志，其中 localhost 代表本机地址：

Express server listening at http://localhost:3000

现在它还不能做任何事情，如果使用浏览器访问这个网址会显示：

Cannot GET /

创建 GET 服务

这是因为我们还没有处理 url 路由和 http 请求。接下来我们创建一个简单的处理 GET 请求的代码：

// 1. 调用 app 中的 get 方法
// 第一个参数是请求的路径，这里处理根路径的请求，
// 第二个参数是处理请求的回调函数，参数分别为请求和响应对象
app.get('/', (req, res) => {
  // 在回调函数里，调用响应对象的 send 方法，发送响应给客户端
  res.send('Hello World!');
});

重启一下 express 服务，然后打开浏览器，访问：

http://lcoalhost:3000

这一次可以看到 Hello World 字样。

创建 POST 服务

POST 是用来创建新的资源，一般都会带有请求体，目前大部分应用都使用 JSON 格式，为了让 Express 能够解析 JSON 格式的请求体，我们需要添加 express.json()中间件到 app 中。中间件是自定义的，用来扩展 express 功能，它可以在处理请求前，或者发送响应前做一些特定的操作，比如 log。

app.use(express.json());

添加之后，使用 app.post()方法创建 post 服务：

app.post('/', (req, res) => {
  console.log('收到请求体：', req.body);
  res.status(201).send();
});

我们在这里同样处理根路径的请求，然后打印出请求体，最后使用 res 对象中的 status 方法设置响应状态码，201 代表资源创建成功，再调用 send 发送响应。重启 express 服务以使代码生效。

我们可以使用 postman 来测试 HTTP 请求，可以到它的官网下载：

https://www.postman.com/downloads/

安装完成并打开后，在输入框中输入 url:

http://localhost:3000

左边选择 POST，然后设置请求体，选择 body->选择 raw->选择 JSON(application/json)，再在下边的输入框中编写一条示例的 JSON 数据：

{
  "name": "jehan"
}

点击 send，稍等一下就能看到返回的 201 状态码。回到命令行，也可以看到打印出了请求体中的 JSON 数据。

创建 PUT 服务

PUT 是用来更新服务器上的资源的，一般需要知道已经存在的资源的唯一标识，一般是数据库中的 id。客户端发送 put 请求时，在 url 中提供标识参数，然后在 express 中解析出来，根据它去更新服务器的资源。这里使用 app 中的 put 方法来创建 put 请求：

// 路径后面的:id 的意思是，根路径后边的值都会作为请求的参数
// 并且赋给名为 id 的变量，（如：http://localhost:3000/3, id 的值就为 3）
app.put('/:id', (req, res) => {
  // 打印一下请求参数的值，req.params.id
  console.log('收到请求参数，id 为：', req.params.id);
  // 再打印一下请求体
  console.log('收到请求体：', req.body);

  // 返回响应，默认是 200
  res.send();
});

重启服务，在 postman 中测试请求，选择 put，url 可以假设为：

http://localhost:3000/3

然后请求体填写示例 JSON:

{
  "name": "John"
}

点击，send，之后可以看到返回了 200，再回到命令行可以看到打印出了 3 和 json 对象

创建 DELETE 服务

DELETE 用于删除服务器中的资源，跟 PUT 一样，也需要标识。

// 这里我们用 app.delete 方法，最后返回 204 状态码，代表已删除
app.delete('/:id', (req, res) => {
  console.log('收到请求参数，id 为：', req.params.id);

  res.status(204).send();
});

重启服务，使用 postman 测试一下，复制选项卡，选择 delete，去掉 body，点击 send，可以看到返回了 204 状态码，express 命令行也打印出了请求参数 3。

子路由

对于一个真实的 express 项目，一般都会包括多组 API，比如文章、产品、订单等，然后分布在子路由中处理。这里我们以文章示例，创建一个 /post 子路由。

在项目根目录下创建一个 routes 文件夹，然后在里边新建一个 post.js 文件，在里边我们导入 express 然后创建一个 Router()实例，用于处理子路由：

var express = require('express');

var route = express.Router();

接下来把 app.js 中的四个请求处理代码复制过来：

app.get('/', (req, res) => {
  res.send('Hello World!');
});

app.post('/', (req, res) => {
  console.log('收到请求体：', req.body);

  res.status(201).send();
});

app.put('/:id', (req, res) => {
  console.log('收到请求参数，id 为：', req.params.id);

  console.log('收到请求体：', req.body);

  res.send();
});

app.delete('/:id', (req, res) => {
  console.log('收到请求参数，id 为：', req.params.id);

  res.status(204).send();
});

把 app 改成 route，然后把日志文字稍微改一下，GET 请求中返回示例数据，再在 post 和 put 请求中，把创建或更新后的资源返回给客户端，以便后续使用：

route.get('/', (req, res) => {
  res.send({
    id: 1,
    title: 'express 入门教程'
  });
});

route.post('/', (req, res) => {
  console.log('保存文章：', req.body);

  // 保存文章到数据库

  res.status(201).send({ id: 2, ...req.body });
});

route.put('/:id', (req, res) => {
  console.log('收到请求参数，文章 id 为：', req.params.id);
  console.log('收到请求体，新的文章内容为：', req.body);

  // 更新数据库文章

  res.send({ id: req.params.id, ...req.body });
});

route.delete('/:id', (req, res) => {
  console.log('收到请求参数，文章 id 为：', req.params.id);

  // 删除数据库文章

  res.status(204).send();
});

然后导出子路由变量：

module.exports = route;

最后，在 app.js 中导入它，并挂载到"/post"子路由下：

const post = require('./routes/post');

app.use('/post', post);

重启服务， 这里测试一下 POST 请求，剩下的大家可以自行测试。打开 postman，在 url 中输入：

http://localhost:3000/post

选择 POST 请求，在请求体中添加测试数据：

{
  "title": "node.js 教程"
}

点击 send 可以看到返回了新添加的数据和 201 状态码。

最佳实践

因为项目中可能包含多个子路由，为了不使 app.js 文件过于庞大，我们可以在 routes 下新建一个 index.js，用于统一处理路由的挂载，由它引入子路由，然后导出一个函数，接收 app 对象，挂载子路由：

const post = require('./post');

module.exports = (app) => {
  app.use('/post', post);
};

后面只需要在 app.js 中引入 routes 文件夹，然后调用这个函数即可：

const routes = require('./routes');
routes(app);