【Node.js】中间件

目录

什么是中间件 

定义中间件函数

最简单的中间件函数 

全局生效的中间件

定义多个全局中间件

局部生效的中间件

中间件的分类

应用级别的中间件

路由级别的中间件

错误级别的中间件

Express内置的中间件

第三方的中间件

---

什么是中间件 

中间件（Middleware） ，特指业务流程的中间处理环节

Express中间件的调用流程：

当一个请求处理时，可以连续调用多个中间件，从而对这次请求进行预处理

Express中间件的格式：

本质上就是一个function处理函数，下图为官网的介绍

中间件函数的形参列表中，必须包含next参数，而路由处理函数中只包含req和res

定义中间件函数

最简单的中间件函数 

//常量mw所指向的，就是一个中间件函数
const mw = function(req,res,next){
   console.log('这是一个简单的中间件函数')
  //注意：在当前中间件的业务处理完毕后，必须调用next()函数
  //表示把流转关系转交给下一个中间件或路由
   next()
}

全局生效的中间件

客户端发起的任何请求，到达服务器之后，都会触发的中间件，叫做全局生效的中间件

调用app.use(中间件函数)，即可定义一个全局生效的中间件，实例代码

//常量mw所指向的，就是一个中间件函数
const mw = function(req,res,next){
   console.log('这是一个简单的中间件函数')
   next()
}
 
//全局生效的中间件
app.use(mw)

中间件的作用

多个中间件之间，共享同一份req和res，基于这样的特性，我们可以在上游的中间件，统一为req和res对象添加自定义的属性或方法，供下游的中间件或路由进行使用

app.use((req,res,next)=>{
 
  //获取到请求到达服务器的时间
   const time = Date.now()
  //为req对象，瓜子自定义属性，从而把时间共享给后面的所有路由
   req.startTime = time
   next()
})
 
app.get('/',(req,res)=>{
   res.send('Home page' + req.startTime)
})
 
app.get('/user',(req,res)=>{
   res.send('User page' + req.startTime)
})

定义多个全局中间件

使用app.use()连续定义多个全局中间件。客户端请求到达服务器之后，会按照中间件定义的先后顺序依次调用。

app.use((req,res,next)=>{
   console.log('这是第一个全局中间件')
   next()
})
 
app.use((req,res,next)=>{
   console.log('这是第二个全局中间件')
   next()
})
 
app.use((req,res,next)=>{
   console.log('这是第三个全局中间件')
   next()
})

局部生效的中间件

不使用app.use()定义的中间件，叫做局部生效的中间件

const mw = function(req,res,next){
   console.log('这是一个中间件')
   next()
}
 
//mw这个中间件只在当前路由中生效，叫做局部生效的中间件
app.get('/',mw,function(req,res){
   res.send('Home page')
})
 
//mw这个中间件不会影响下面这个路由
app.get('/user',function(req,res){
   res.send('User page')
})

定义多个局部中间件：下面两种写法完全等价，可以使用多个局部中间件

app.get('/',mw1,mw2,function(req,res){
   res.send('Home page')
})
 
app.get('/',[mw1,mw2],function(req,res){
   res.send('Home page')
})

中间件的注意事项：

1. 一定要在路由之前注册中间件
2. 客户端发送过来的请求，可以连续调用多个中间件进行处理
3. 执行完中间件的业务代码之后，不要忘记调用next()函数
4. 为了防止代码逻辑混乱，调用next()函数后不要再写额外的代码
5. 连续调用多个中间件时，多个中间件之间，共享req和res对象

中间件的分类

1. 应用级别的中间件
2. 路由级别的中间件
3. 错误级别的中间件
4. Express内置的中间件
5. 第三方的中间件

应用级别的中间件

通过app.use()或app.get()或app.post()，绑定到app实例上的中间件，叫做应用级别的中间件。

app.use((req,res,next)=>{
   console.log('这是第一个全局中间件')
   next()
})
 
app.use((req,res,next)=>{
   console.log('这是第二个全局中间件')
   next()
})
 
app.use((req,res,next)=>{
   console.log('这是第三个全局中间件')
   next()
})

路由级别的中间件

绑定到express.Router()实例上的中间件，叫做路由级别的中间件。

var app=express()
var router = express.Router()
 
//路由级别的中间件
router.use(function(req,res,next){
   console.log('Time:',Date.now())
   next()
})
 
app.use('/',router)

错误级别的中间件

作用：专门用来捕获整个项目中发生的异常错误，从而防止项目异常崩溃的问题。

格式：错误级别中间件的function处理函数，必须有四个形参，（err,req,res,next）

app.get('/',function(req,res){
   throw new Error('服务器内部发生错误')
   res.send('Home page')
})
 
app.use(function(err,req,res,next){    //错误级别的中间件
   console.log('发生了错误',+err.message)   //在服务器打印错误消息
   res.send('Error!' + err.message)   //在客户端响应错误相关的内容
})

错误级别的中间件必须注册在所有路由之后！

Express内置的中间件

express.static 快速托管静态资源的内置中间件

express.json 解析JSON格式的请求体数据（有兼容性，仅在4.16.0+版本可用）

express.urlencoded 解析URL-encoded格式的请求体数据（有兼容性，仅在4.16.0+版本可用）

//配置解析 application/json格式数据的内置中间件
app.use(express.json())
 
//配置解析 application/x-www-form-urlencoded 格式数据的内置中间件
app.use(express.urlencoded({ extended:false }))

第三方的中间件

按需下载并配置第三方中间件，从而提高项目的开发效率

在express@4.16.0之前的版本中，经常使用body-parser这个第三方中间件，来解析请求体数据

1. 运行npm install body-parser 安装中间件
2. 使用require导入中间件
3. 调用app.use()注册并使用中间件