Body-Parser:一个格式化请求体数据的 Express 三方库
2024-02-29 14:43:45 软件 155观看
摘要body-parser 是 Express 中用于格式化请求体数据的一个三方库。以下是一个 body-parser 的常用使用案例。const express = require('express')const bodyParser = require('body-parser')const app = express()// par

body-parser 是 Express 中用于格式化请求体数据的一个三方库。sPQ28资讯网——每日最新资讯28at.com

以下是一个 body-parser 的常用使用案例。sPQ28资讯网——每日最新资讯28at.com

const express = require('express')const bodyParser = require('body-parser')const app = express()// parse application/x-www-form-urlencodedapp.use(bodyParser.urlencoded({ extended: false }))// parse application/jsonapp.use(bodyParser.json())app.use(function (req, res) {  res.setHeader('Content-Type', 'text/plain')  res.write('you posted:/n')  res.end(JSON.stringify(req.body, null, 2))})

以上代码设置的含义是:项目中所有 Content-Type 是 "application/x-www-form-urlencoded" 或 "application/json" 请求数据都会经过 body-parser 中间件的处理,并设置到 req.body 属性上。sPQ28资讯网——每日最新资讯28at.com

下面就来详细介绍 body-parser 的安装和使用。sPQ28资讯网——每日最新资讯28at.com

安装

$ npm install body-parser

使用也比较简单。sPQ28资讯网——每日最新资讯28at.com

const bodyParser = require('body-parser')

我们是通过调用 bodyParser 对象的方法来获取不同 Content-Type 的数据处理能力的。下面就来介绍。sPQ28资讯网——每日最新资讯28at.com

API

bodyParser 上一共提供了 4 个方法来使用,分别对应 4 种不同类型的请求体数据。sPQ28资讯网——每日最新资讯28at.com

  1. bodyParser.json([options])
  2. bodyParser.urlencoded([options])
  3. bodyParser.text([options])
  4. bodyParser.raw([options])

其中前 2 种是我们最常使用的。接下来分别介绍。sPQ28资讯网——每日最新资讯28at.com

bodyParser.json([options])

返回能解析 json 数据的中间件,默认匹配 Content-Type 值为 "application/json"(可以通过 options.type 进行控制)。接受任何 Unicode  编码的请求体数据,而且还支持 gzip 和 deflate 压缩算法的自动解压。sPQ28资讯网——每日最新资讯28at.com

解析好的请求体数据会放在 req.body 属性上,无请求体数据则返回一个空对象({})。sPQ28资讯网——每日最新资讯28at.com

Options 选项

这是一个可选参数,不传入则使用默认选项。其他 3 个方法与此类似,在此讲 1 遍后,如果没有特殊情况,后面就不再赘述了。sPQ28资讯网——每日最新资讯28at.com

  • type:默认值是 "application/json",表示这个中间件默认匹配的 Content-Type 是 "application/json",这个字段除了接收字符串,还支持接收对象和数组。你也可以自定义,比如设置成 "*/json"(内部是使用 type-is[1] 做匹配的)
  • inflate:是否开启自动解压请求体数据的能力,默认为 true(目前支持 支持 gzip 和 deflate 2 中压缩算法)
  • limit:控制最大请求正文大小,否则报错。默认值是 '100kb'(内部传递给 bytes[2] 库将其解析成字节数进行判断处理)
  • reviver:body-parser 内部默认使用 JSON.parse() 方法将字符串格式化成对象设置到 req.body 上。这个参数就是传递给 JSON.parse() 方法的第 2 个参数,用来自定义解析行为。搞不清楚的同学可以看一下 MDN 上 JSON.parse() 的使用文档[3]
  • strict:默认为 true,用来控制内部 JSON.parse() 所接收的字符串是否只能是对象和数组。设置成 false 时表示可以接受任意类型的字符串数据

bodyParser.urlencoded([options])

默认处理 Content-Type 值为 "application/x-www-form-urlencoded" 的请求体数据。sPQ28资讯网——每日最新资讯28at.com

.urlencoded() 中间件还提供了一个布尔参数 urlencoded,用来决定使用哪一个查询解析库来处理请求参数。sPQ28资讯网——每日最新资讯28at.com

  • urlencoded为 false 时,内部使用 querystring 库解析
  • urlencoded为 true 时,内部使用 qs 库解析

qs 与 querystring 的区别在于:querystring 只能解析简单 key-value 对,qs 则支持嵌套对象的 key-value 对的解析,后者功能会更加强大。sPQ28资讯网——每日最新资讯28at.com

Options 选项

  • urlencoded:以上已介绍过。默认为 true(即使用 qs 解析参数),不过已被弃。官方推荐显式传入一个值,这就需要你了解 qs 和 querystring 之间的区别
  • parameterLimit:控制 URL 编码数据中允许的最大参数数量,默认是 1000。多于这个值,会向客户端返回 413 响应码

bodyParser.text([options])

默认处理 Content-Type 值为 "text/plain" 的请求体数据。sPQ28资讯网——每日最新资讯28at.com

Options 选项

  • defaultCharset:如果请求头中的 Content-Type 头中没有指定字符集,则使用这个字段所指定的文本内容的默认字符集。默认为 "utf-8"。

bodyParser.raw([options])

默认处理 Content-Type 值为 "application/octet-stream" 的请求体数据。sPQ28资讯网——每日最新资讯28at.com

不支持 multipart/form-data

body-parser 并不支持处理 Content-Type 是 "multipart/form-data" 的请求体数据。如果你有这方面的需求,可以参照下面的库进行选择。sPQ28资讯网——每日最新资讯28at.com

  • busboy[4] 和 connect-busboy[5]
  • multiparty[6] 和 connect-multiparty[7]
  • formidable[8]
  • multer[9]

express 已内置 body-parser

express 从 v4.17.0 开始[10],已全面内置了 body-parser 功能,你直接可以通过 express().json() / express().raw()/express().text()/ express().urlencoded() 4 个 API。sPQ28资讯网——每日最新资讯28at.com

在内部,这 4 方法其实是 body-parser 借着 express 暴露出来[11]的。也就是说项目中你无需安装 body-parser 依赖了。sPQ28资讯网——每日最新资讯28at.com

const bodyParser = require('body-parser')/** * Expose middleware */exports.json = bodyParser.jsonexports.query = require('./middleware/query');exports.raw = bodyParser.rawexports.text = bodyParser.textexports.urlencoded = bodyParser.urlencoded

总结

本文介绍了 Express 中用于解析请求体数据的中间件 body-parser。 其实 Express 在 v4.17.0 中已完整内置了 body-parser 的能力,你可以通过 express() 上的 .json()/.urlencoded()/.text()/.raw() 方法访问到。sPQ28资讯网——每日最新资讯28at.com

就介绍到这里了,希望本文对你有所帮助,感谢阅读,再见。sPQ28资讯网——每日最新资讯28at.com

参考资料

[1]type-is: https://www.npmjs.org/package/type-is#readmesPQ28资讯网——每日最新资讯28at.com

[2]bytes: https://www.npmjs.com/package/bytessPQ28资讯网——每日最新资讯28at.com

[3]MDN 上 JSON.parse() 的使用文档: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse#Example.3A_Using_the_reviver_parametersPQ28资讯网——每日最新资讯28at.com

[4]busboy: https://www.npmjs.org/package/busboy#readmesPQ28资讯网——每日最新资讯28at.com

[5]connect-busboy: https://www.npmjs.org/package/connect-busboy#readmesPQ28资讯网——每日最新资讯28at.com

[6]multiparty: https://www.npmjs.org/package/multiparty#readmesPQ28资讯网——每日最新资讯28at.com

[7]connect-multiparty: https://www.npmjs.org/package/connect-multiparty#readmesPQ28资讯网——每日最新资讯28at.com

[8]formidable: https://www.npmjs.org/package/formidable#readmesPQ28资讯网——每日最新资讯28at.com

[9]multer: https://www.npmjs.org/package/multer#readmesPQ28资讯网——每日最新资讯28at.com

[10]从 v4.17.0 开始: https://expressjs.com/en/4x/api.html#express.jsonsPQ28资讯网——每日最新资讯28at.com

[11]body-parser 借着 express 暴露出来: https://github.com/expressjs/express/blob/4.18.2/lib/express.js#L78sPQ28资讯网——每日最新资讯28at.com

本文链接:http://www.28at.com/showinfo-26-75357-0.htmlBody-Parser:一个格式化请求体数据的 Express 三方库

声明:本网页内容旨在传播知识,不代表本站观点,若有侵权等问题请及时与本网联系,我们将在第一时间删除处理。

显示全文

上一篇:详解渗透测试和漏洞扫描的开源自动化解决方案

下一篇:如何在Rust中操作JSON,你学会了吗?

最新热点