node.js中express中间件body-parser的介绍与用法详解

下面是本攻略的完整内容，包括介绍、用法以及代码示例。

介绍

在 Node.js 的 Web 开发中，处理请求参数是非常常见的操作。其中，body-parser 是一个非常常用的中间件，它用来解析 HTTP 请求体中的参数，并挂载到 request 对象上供后续中间件或路由处理。

body-parser 中间件支持多种格式的请求体数据，包括 JSON、urlencoded 等格式，也支持不同的编码方式，如 utf-8、gbk 等。这使得 body-parser 可以应对多种场景，非常灵活。

用法

安装 body-parser 中间件：

npm install --save body-parser

使用：

const express = require('express');
const bodyParser = require('body-parser');

const app = express();

app.use(bodyParser.json()); // 解析 application/json 格式的请求体数据
app.use(bodyParser.urlencoded({ extended: true })); // 解析 application/x-www-form-urlencoded 格式的请求体数据

app.post('/api/login', (req, res) => {
  const {username, password} = req.body;
  // ...
})

上述代码中，我们首先引入了 express 和 body-parser 两个模块，然后创建了一个应用。接着，我们使用了 app.use() 方法挂载了两个 body-parser 中间件，分别用于解析 JSON 和 urlencoded 格式的请求体数据。

在路由处理函数中，我们可以通过 req.body 获取请求体数据。

除了使用 app.use() 挂载 body-parser 中间件之外，也可以在具体的路由函数中单独使用 body-parser：

const express = require('express');
const bodyParser = require('body-parser');

const app = express();

app.post('/api/login', bodyParser.json(), (req, res) => {
  const {username, password} = req.body;
  // ...
})

上述代码中，我们将 body-parser.json() 作为路由处理函数的参数传入，这个路由处理函数仅在处理 POST /api/login 请求时生效。

示例

下面，我们来看两个常见的使用场景及相应的代码示例。

解析 JSON 格式的请求体数据

假设我们有这样一个场景：客户端向服务器发送一个 POST 请求，请求体是一个 JSON 数据，包含了用户名和密码，我们需要在服务器上对其进行处理。

客户端发送的请求：

POST /api/login HTTP/1.1
Content-Type: application/json

{
  "username": "admin",
  "password": "123456"
}

服务器端代码：

const express = require('express');
const bodyParser = require('body-parser');

const app = express();

app.use(bodyParser.json());

app.post('/api/login', (req, res) => {
  const {username, password} = req.body;
  // 根据用户名和密码验证用户
  // ...
})

在上述代码中，我们使用了 app.use(bodyParser.json()) 来挂载解析 JSON 格式请求体数据的中间件，在路由处理函数中使用 req.body 获取了请求体中的数据。

解析 urlencoded 格式的请求体数据

假设我们有这样一个场景，客户端向服务器发送一个 POST 请求，请求体是一个 urlencoded 数据，包含了用户名和密码，我们需要在服务器上对其进行处理。

客户端发送的请求：

POST /api/login HTTP/1.1
Content-Type: application/x-www-form-urlencoded

username=admin&password=123456

服务器端代码：

const express = require('express');
const bodyParser = require('body-parser');

const app = express();

app.use(bodyParser.urlencoded({ extended: true }));

app.post('/api/login', (req, res) => {
  const {username, password} = req.body;
  // 根据用户名和密码验证用户
  // ...
})

在上述代码中，我们使用了 app.use(bodyParser.urlencoded({ extended: true })) 来挂载解析 urlencoded 格式请求体数据的中间件，在路由处理函数中使用 req.body 获取了请求体中的数据。

总结

body-parser 是一个非常常用的中间件，它可以帮助我们解析 HTTP 请求体中的参数，并挂载到 request 对象上供后续中间件或路由处理。本攻略介绍了 body-parser 的用法及两个常见场景下的代码示例，希望能对你理解和实践 body-parser 有所帮助。