什么是中间件

中间件（Middleware）, 特制业务流程的中间处理环节。
当一个请求到Express服务器之后，可以连续调用多个中间件，从而对着此次请求进行预处理。.
image.png

Express中间件的格式

Express的中间件，本质上就是一个function处理函数，Express中间件的格式如下：
image.png
注意：中间件函数的形参列表中，必须包含next参数。而路由处理函数中只包含req和res。

中间件的概念

next函数的作用

next函数是实现多个中间件连续调用的关键，它表示把流转关系转交给下一个中间件或路由。

定义中间件函数

可以通过如下方式，定义一个最简单的中间件函数：

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

全局生效的中间件函数

客户端发起的任何请求，到达服务器之后，都会触发的中间件，叫做全局生效的中间件。
通过调用app.use(中间件函数)，即可定义一个全局生效的中间件，示例代码如下：

  1. const mw = function(req, res, next){
  2.     console.log('这是一个最简单的中间件函数')
  3.   //注意：在当前中间件的业务处理完毕后，必须调用next()函数
  4.   //表示把流转关系交给下一个中间件或路由
  5.   next()
  6. }
  8. app.use(mw)

中间件的作用

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

定义多个局部中间件

可以在路由中，通过如下两种等价的方式，使用多个局部中间件：

  1. //以下两种写法是“完全等价”的，可根据自己的喜好，选择任意一种方式进行使用
  2. app.get('/', mw1, mw2, (req, res) => { res.send('Home page. ') })
  3. app.get('/', [ mw1, mw2 ], (req, res) => { res.send('Home page.') })

中间件的分类

为了方便大家理解和记忆中间件的使用，Express官方把常见的中间件方法，分成了5大类，分别是：

应用级别的中间件

通过app.get()或app.post()或app.use()，绑定到app实例上的中间件，叫做应用级别的中间件，代码示例如下：

  1. //应用级别的中间件（全局中间件）
  2. app.use((req, res, next) => {
  3.   next()
  4. })
  7. //应用级别的中间件（局部中间件）
  8. app.get('/', mw1, (req, res) => {
  9.     res.send('Home page.')
  10. })

路由级别的中间件

绑定到Express.Router()实例上的中间件，叫做路由级别的中间件，它的用法和应用级别中间件没有任何区别。只不过，应用级别中间件是绑定到app实例上，路由级别中间件绑定到router实例上，代码示例如下：

  1. const express = require('express')
  2. const router = express.Router()
  4. // 路由级别的中间件
  5. router.use((req, res, next) => {
  6.     console.log('Time:', Date.now());
  7.     next()
  8. })

错误级别的中间件

错误级别的中间件的作用：专门用来捕获整个项目发生的异常错误，从而防止项目异常崩溃的问题。
格式：错误级别的中间件的function处理函数在红，必须有4个形参，形参顺序从前到后，
分别是(err, req, res, next)

  1. const Errors = (err, req, res, next) => {
  2.     console.log('发生了错误：'+ err.message);
  3.     res.send('Error!'+ err.message)
  4. }
  5. app.use(Errors)
  7. router.post('/post/post', (req, res)=>{
  8.     throw new Error('请求出错了')
  9.     console.log(req.body);
  10.     res.send(req.body)
  11. })

注意：错误级别的中间件一定要放在路由模块之后，否则无效！

Express内置的中间件

  1. express.static 快速托管静态资源的内置中间件，例如HTML文件、图片、CSS样式等、
  2. express.join 解析JSON格式的请求体数据(有兼容性，仅在4.16.0+版本中使用).
  3. express.urlencoded 解析URL-encoded格式的请求体数据(有兼容性，仅在4.16.0+版本中使用)
    1. //配置解析 application/json 格式数据的内置中间件
    2. app.use(express.json())
    3. //配置解析 application/x-www-form-urlencoded 格式数据的内置中间件
    4. app.use(express.urlencoded({ extended: false }))

    第三方的中间件

    非Express官方内置的，而是由第三方开发出来的中间件，叫做第三方中间件。在项目中，大家可以按需下载并配置第三方中间件，从而提高项目的开发效率。

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

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