nodejs使用Express框架写后端接口的全过程

时间：2022-11-22 10:57:28|栏目：NodeJS|点击：次

路由和接口

路由（Routing）是由一个URL（或者叫路径标识）和一个特定的HTTP方法（GET、POST等）组成的，涉及到应用如何处理响应客户端请求。每一个路由都可以有一个或多个处理器函数，当匹配到路由时，这些个函数将被执行。

// 引入express
const express = require('express')
//创建express实例存入变量app ，调用express
const app = express()
// 定义路由
//METHOD：是一个http请求方法；PATH：请求路径；HANDLER：是当路由匹配到时需要执行的处理函数
app.METHOD(PATH, HANDLER)

接口传参

我们使用ajax请求向服务器接口传参，按http协议的规定，每个都有三个部分：

请求行：保存了请求方式，地址，可以以查询字符串的格式附加一部分数据。
请求头：它可以附加很多信息，其中content-type用来约定请求体中保存的数据格式。

?? ? content-type常见有三种取值：

请求体：本次请求携带的参数。至于这些参数到了后端应该如何解析出来，由请求头中的content-type来决定。

GET接口

express框架会自动帮我们收集get类型的接口从url地址中传递的查询字符串参数，并自动保存在req对象的query属性中，我们直接获取即可。

app.get('/get',(req,res) => {
  // 输出请求参数
  console.log(req.query)
  //结束本次响应并返回内容
  res.send('hello world！')
})

POST接口-普通键值对

具体来说当请求头的content-type为x-www-form-urlencoded时，表示上传的普通简单键值对。

// 使用中间件获取普通键值对参数
app.use(express.urlencoded())
app.post('/add',(req,res) => {
  // 输出请求参数
  //app.use(....)之后，在res中就会多出一个属性res.body,里面存放着键值对参数
  console.log(req.body)
  //结束本次响应并返回内容
  res.send("hello world!")
})

POST接口-JSON

在post传递参数时，如果要传入的参数比较复杂（多级嵌套），例如表单数据，则可以使用json格式上传。

// 使用中间件获取JSON参数
app.use(express.json())
app.post('/post-json',(req,res) => {
  // 输出请求参数
  console.log(req.body)
  //结束本次响应并返回内容
  res.send("hello world!")
})

POST接口-form-data文件上传

如果post涉及文件上传操作，则需要在服务器端额外使用第三方multer这个包（不属于express）来获取上传的信息。

// 引入包
const multer = require('multer')
// 配置 上传的文件会保存到unloads这个文件夹下
const upload = multer({dest:'unloads/'})
//upload.single表示单文件上传，cover表示本次上传的数据
app.post('/post-file',upload.single('cover'),(req,res) => {
  // req.file记录了上传文件的信息
  console.log(req.file)
  //结束本次响应并返回内容
  res.send({message:"ok"})
})