Express 是一个基于 Node.js 平台,快速、开放、极简的 web 开发框架
Expresss 是一个第三方模块(在npm上可以下载),在使用它之前要先去下载它,在下载包之前要先创建项目,并通过npm init 创建package.json文件。
1、get接口参数 req.query属性
express框架会自动收集get方式从url地址中传递的查询字符串参数,并自动保存在req对象的query
属性中。我们直接来获取即可。
const express = require('express');
const app = express();
app.get('/get', function(req, res) {
// 直接返回对象
console.log(req.query);
res.send({ name: 'abc' });
});
app.listen('8088', () => {
console.log('8088');
});
1.1、post接口与get请求不同
表示的操作不同:get一般用来做查询,post一般用来添加;
传参不同:get的参数只能在请求行中通过查询字符串来传递, post一般是通过请求体(它也可以通过请求行来传递)来传递的。
2、post接口参数-
post一般是通过请求体来传递的,根据传递的参数的格式不同,分成三种情况来说
- 传递普通键值对
- 传递json
- 传递form表单(涉及文件上传)
2.1、普通键值对参数-express.urlencoded()
用express.urlencoded()来获取请求体的参数 ,具体来说当content-type为x-www-form-urlencoded时,表示上传的普通简单键值对
// 1. 使用中间件
app.use(express.urlencoded());
app.post("/add",function(req,res){
//2. 可以通过req.body来获取post传递的键值对
res.json(req.body)
})
2.2、json格式的参数-express.json()
使用express.json()来获取请求体中传递的json数据。
在post传递参数时,如果要传入的参数比较复杂(多级嵌套),则可以使用json格式上传。
app.use(express.json());
// 会自动加入req.body属性,这个属性中就包含了post请求所传入的参数
// 用来处理JSON格式的数据
app.post('/postJSON',(req,res)=>{
// 后端收到post传参
console.log(req.body);
res.send('/postJSON')
})
2.3、form-data文件上传-multer包
multer包
Multer 是一个 node.js 中间件,用于处理 multipart/form-data
类型的表单数据,它主要用于上传文件。
涉及文件上传操作,则需要在服务器端额外使用第三方multer
这个包(不属于express)来获取上传的信息。使用npm install multer安装后使用
使用multer包
1. 引入包
const multer = require('multer');
2. 配置
const upload = multer({dest:'uploads/'}) // 上传的文件会保存在这个目录下
// uploads表示一个目录名,你也可以设置成其它的
//如果当前目录下没有uploads,它会自动创建uploads这个文件夹
3. 使用
// 这个路由使用第二个参数 .upload.single表示单文件上传, 'cover' 表示要上传的文件在本次上次数据中的键名。对应于前端页面上的:
// <input type="file" name='cover'/>
app.post("/postfile", upload.single('cover'), function(req,res){
// req.file 记录了文件上传的信息
// req.body 记录了其它普通参数(非文件)的信息
// 其它操作
})
3、理解接口传参
3.1请求报文:行,头,体
我们一般使用ajax技术请求接口,按http协议的约定,每个请求都有三个部分:
- 请求行: 保存了请求方式,地址,可以以查询字符串的格式附加小部分数据。
- 请求头:它可以附加很多信息,其中content-type用来约定请求体中保存的数据格式。
content-type常见有三种取值:
content-type的值 | 表示请求体的数据格式 | 示例 |
application/x-www-form-urlencode | 普通键值对象 | a=2&c=1 |
application/json | json对象 | {a:1,b:{c:1}} |
multipart/form-data | 上传文件 | file |
请求体: 本次请求携带的参数。至于这些参数到了后端应该如何解析出来,由请求头中的content-type来决定。
4、总结
传参方式 | 前端 content-type | 后端框架express |
请求行 | get方式 | req.query |
请求体 | application/x-www-form-urlencode | app.use(express.urlencoded()); req.body |
请求体 | application/json | app.use(express.json()); req.body |
请求体 | multipart/form-data | 1. 引入包 const multer = require('multer'); 2. 配置app.post('/apiname', upload.single(), req.body) |