# 解析请求体

URL: https://caijiao.org/express/chapter5/1-body-parser
Source: docs/express/chapter5/1-body-parser.md
Description: 本章节介绍如何在 Express 中解析请求体，讲解如何处理不同格式的请求体数据，如 JSON、表单数据等。

在 Web 开发中，客户端向服务器发送的请求通常会包含请求体（Request Body），其中包含了用户提交的数据。Express 提供了多种中间件来解析不同格式的请求体，常见的格式包括 JSON 数据、URL 编码的表单数据以及多部分表单数据。

## 使用中间件解析请求体

### 1. 解析 JSON 数据

客户端可以使用 `application/json` 格式将数据发送到服务器。在 Express 中，我们可以使用 `express.json()` 中间件来解析 JSON 格式的请求体。

#### 1.1 安装并配置 JSON 中间件

```js
const express = require('express');
const app = express();

// 使用 express.json() 中间件解析请求体中的 JSON 数据
app.use(express.json());
````

#### 1.2 处理 POST 请求并解析 JSON 数据

```js
app.post('/json', (req, res) => {
  // 获取请求体中的 JSON 数据
  const { name, age } = req.body;
  res.send(`收到的用户数据：姓名 ${name}，年龄 ${age}`);
});
```

#### 1.3 测试

客户端发送一个 POST 请求，内容为 JSON 格式：

```json
{
  "name": "张三",
  "age": 28
}
```

服务器会解析并返回响应：

```
收到的用户数据：姓名 张三，年龄 28
```

### 2. 解析 URL 编码的表单数据

当用户通过传统的 HTML 表单提交数据时，浏览器会以 `application/x-www-form-urlencoded` 格式发送数据。Express 提供了 `express.urlencoded()` 中间件来解析这种格式的数据。

#### 2.1 安装并配置 URL 编码中间件

```js
// 使用 express.urlencoded() 中间件解析 URL 编码的表单数据
app.use(express.urlencoded({ extended: true }));
```

`extended: true` 选项允许你解析嵌套的对象，推荐使用此配置。

#### 2.2 处理 POST 请求并解析表单数据

```js
app.post('/form', (req, res) => {
  // 获取表单中的数据
  const { username, password } = req.body;
  res.send(`表单提交的数据：用户名 ${username}，密码 ${password}`);
});
```

#### 2.3 测试

客户端通过表单提交：

```html
<form action="/form" method="POST">
  <label for="username">用户名：</label>
  <input type="text" id="username" name="username" required />
  <br />
  <label for="password">密码：</label>
  <input type="password" id="password" name="password" required />
  <br />
  <button type="submit">提交</button>
</form>
```

服务器接收到请求后，会解析并返回：

```
表单提交的数据：用户名 张三，密码 123456
```

### 3. 解析多部分表单数据（文件上传）

如果表单包含文件上传，浏览器会以 `multipart/form-data` 格式提交请求。为了处理这种请求，需要使用第三方中间件，如 `multer`。

#### 3.1 安装 `multer`

```bash
npm install multer
```

#### 3.2 配置 `multer` 处理文件上传

```js
const multer = require('multer');
const upload = multer({ dest: 'uploads/' });

app.post('/upload', upload.single('file'), (req, res) => {
  // 获取上传的文件信息
  const file = req.file;
  res.send(`文件上传成功！文件名：${file.originalname}`);
});
```

#### 3.3 测试

创建一个 HTML 表单，允许用户选择文件并上传：

```html
<form action="/upload" method="POST" enctype="multipart/form-data">
  <label for="file">选择文件：</label>
  <input type="file" id="file" name="file" required />
  <br />
  <button type="submit">上传</button>
</form>
```

### 4. 总结

Express 提供了非常简便的中间件来解析不同格式的请求体，包括：

* `express.json()` 用于解析 JSON 格式的数据；
* `express.urlencoded()` 用于解析 URL 编码的表单数据；
* `multer` 用于处理文件上传的多部分表单数据。

通过正确配置这些中间件，我们可以轻松地处理来自客户端的各种请求体数据，并根据需求进行处理和响应。