admin 发表于 2022-1-13 09:54:02

Node.js---中间件

一、中间件概念
中间件(Middleware ),特指业务流程的中间处理环节。

1、Express 中间件的调用流程
      当一个请求到达 Express 的服务器之后,可以连续调用多个中间件,从而对这次请求进行预处理。如下所示:

2、Express 中间件的格式
      Express 的中间件,本质上就是一个 function 处理函数,Express 中间件的格式如下:
var express = require('express');
var app = express();
app.get('/',(res,req,next)=>{
        next();
        });
app.listen(3000);

注意:中间件函数的形参列表中,必须包含 next 参数。

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

二、Express 中间件的使用
1、定义中间件函数
如下所示:
const express = require('express');
const app = express();
//定义一个最简单的中间件函数
const mw = (req,res,next)=>{
    console.log('这是最简单的中间件函数')
    //把流转关系,转交给下一个中间件或路由
    next();
}
app.listen(80,()=>{
    console.log('http://127.0.0.1')
})

2、全局生效的中间件
      客户端发起的任何请求,到达服务器之后,都会触发的中间件,叫做全局生效的中间件。
      通过调用 app.use(中间件函数),即可定义一个全局生效的中间件,示例代码如下:
const mw = function (req,res,next){
    console.log('这是最简单的中间件函数')
    //把流转关系,转交给下一个中间件或路由
    next()
}
//将mw注册为全局生效的中间件
app.use(mw)

如下:

const express = require('express');
const app = express();
//定义一个最简单的中间件函数
const mw = function (req,res,next){
    console.log('这是最简单的中间件函数')
    //把流转关系,转交给下一个中间件或路由
    next()
}
//将mw注册为全局生效的中间件
app.use(mw)
app.get('/',(req,res)=>{
    res.send('Home page.')
})
app.post('/',(res,req)=>{
    res.send('user page.')
})
app.listen(80,()=>{
    console.log('http://127.0.0.1')
})

先在终端运行:

打开postman,进行测试:
get测试:

发现终端输出:

这是因为当我们向服务器响应请求时,服务器会先将请求交中间件处理,当中间件处理完成后,会调用一次next()函数,将流转关系,转交给下一个中间件或路由。
      post测试方法上同,不在赘述。

3、定义全局中间件的简化形式
如下所示:
app.use(function (req,res,next){
    console.log('这是最简单的中间件函数')
    //把流转关系,转交给下一个中间件或路由
    next()
})

进行测试,发现也可以成功调用。

4、中间件的作用
      多个中间件之间,共享同一份 req 和 res。基于这样的特性,我们可以在上游的中间件中,统一为 req 或 res 对象添加自定义的属性或方法,供下游的中间件或路由进行使用。
      例如:请求到达服务器之后,得到每个路由此次请求的时间。代码如下:
const express = require('express')
const app = express();
app.use((req,res,next)=>{
    //获取到请求到服务器的时间
    const time = Date.now()
    //为req对象挂载自定义属性,从而把时间共享给后面所有的路由
    req.startTime = time;
    next();
})
app.get('/user1',(req,res)=>{
    res.send('Home page'+req.startTime)
})
app.get('/user2',(req,res)=>{
    res.send('User page'+req.startTime)
})
app.listen(80,()=>{
    console.log('http://127.0.0.1')
})

在终端运行:

然后打开postman,进行测试:


测试成功。

5、定义多个全局中间件
      可以使用 app.use() 连续定义多个全局中间件。客户端请求到达服务器之后,会按照中间件定义的先后顺序依次进行调用,示例代码如下:
const express = require('express');
const app = express();
//定义第一个中间件
app.use((req,res,next)=>{
    console.log('这是第一个中间件')
    next();
})
//定义第二个中间件
app.use((req,res,next)=>{
    console.log('这是第二个中间件')
    next()
})
//定义路由
app.get('/user',(req,res)=>{
    res.send('User page.')
})
app.listen(80,()=>{
    console.log('http://127.0.0.1')
})

在终端运行:

打开postman进行测试:

在打开终端,可以看到终端输出:

测试成功。

6、局部生效的中间件
      不使用 app.use() 定义的中间件,叫做局部生效的中间件,示例代码如下:
const express = require('express')
const app = express();
//定义中间件函数
const mw1 = (req,res,next)=>{
    console.log('调用了局部生效的中间件')
    next()
}
//创建路由
app.get('/',mw1,(req,res)=>{
    res.send('Home page')
})
app.get('/user',(req,res)=>{
    res.send('User page')
})
app.listen(80,()=>{
    console.log('http://127.0.0.1')
})

在终端运行:

打开postman进行测试:

在回到终端,发现输出:

再去postman调用第二个路由,如下:

终端并没有输出中间件函数的内容,说明该中间件是局部生效的。测试成功。

7、定义多个局部中间件
可以在路由中,通过如下两种等价的方式,使用多个局部中间件:
//写法1
app.get('/',mv1,mv2,(req,res)=>{res.send('Home page')}
//写法2
app.get('/',,(req,res)=>{res.send('Home page')}

如下:

const express = require('express');
const app = express();
//定义中间件函数
const mv1 = (res,req,next)=>{
    console.log('调用了第一个局部生效的中间件')
    next()
}
const mv2 = (req,res,next)=>{
    console.log('调用了第二个局部生效的中间件')
    next()
}
//定义路由
app.get('/',mv1,mv2,(req,res)=>{
    res.send('Home page')
})
app.get('/user',(req,res)=>{
    res.send('User page')
})
app.listen(80,()=>{
    console.log('http://127.0.0.1')
})

在终端启动服务器:

打开postman进行测试,先开启第一个路由:



再开启第二个路由:

终端无其他输出,说明该中间件是局部生效的。测试成功。
需要注意的是:

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