Express中间件

中间件

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

1.中间件的概念

1.中间件调用流程

当一个请求到达Express的服务器之后，可以连续调用多个中间件，从而对这次请求进行预处理

2.Express中间件的格式

中间件，本质上就是一个function处理函数，Express中间件的格式：

app.get('/', function(req, res, next) {
    next();
})

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

3.next函数

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

2.中间件函数

1.定义中间件函数

const express = require('express')
const app = express()

const mw = function(req,res ,next){
    console.log('中间件');
    //把流转关系交给下一个中间件或路由
    next()
}

app.listen(80,()=>{
    console.log('http://127.0.0.1');
})

2.全局生效的中间件

复杂

客户端大气任何请求，到达服务器之后，都会触发的中间件，叫做全局生效的中间件，通过调用app.use(中间件函数名)，就可以定义一个全局生效的中间件

const express = require('express')
const app = express()

const mw = function(req,res ,next){
    console.log('中间件');
    //把流转关系交给下一个中间件或路由
    next()
}

app.listen(80,()=>{
    console.log('http://127.0.0.1');
})

//将mw注册为全局生效的中间件
app.use(mw)

简化

省略定义中间件函数的代码

app.use(function(req, res, next) {
    console.log('中间件');
    //把流转关系交给下一个中间件或路由
    next()
})

3.中间件作用

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

4.定义多个全局中间件

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

//定义中间件复杂方法
const mw = function(req, res, next) {
    console.log('中间件1');
    //把流转关系交给下一个中间件或路由
    next()
}

app.use(mw)

//定义中间件简便方法
app.use((req, res, next) => {
    console.log('中间件2');
    next()
})

5.局部生效的中间件

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

//定义一个局部中间件
const mw1 = (req, res, next) => {
    console.log('局部生效中间件');
    next()
}

//在该路由中，增加参数mw1，就可以在这个路由中，局部使用中间件
app.get('/', mw1, (req, res) => {
    res.send('home page')
})

app.get('/', (req, res) => {
    res.send('user page')
})

6.定义多个局部中间件

下面这两行中对于两个局部中间件的使用都是可以的，两种调用都可以

app.get( ' / ',mw1,mw2，(req,res) => { res.send( ' Home page. ') })
app.get( ' 7 '，[mw1,mw2]，(req,res) => { res.send( ' Home page. ') ))

7.中间件使用注意事项

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

8.中间件分类

1.应用级别的中间件

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

//全局中间件
app.use((req, res, next) => {
    next();
})

//局部中间件
app.get('/', (req, res, next) => {
    res.send('Hpme page');
    next();
})

2.路由级别的中间件

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

const express = require('express')
const app = express()
const router = express.Router()

//路由级别中间件
router.use((req, res, next) => {
    next();
})

app.use('/', router)

3.错误级别的中间件

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

//定义路由
app.get('/', (req, res) => {
    //人为的制造错误
    throw new Error('服务器内部发生了错误！')
    res.send('Home page')//未执行，只要发生错误，立即前往错误级别中间件
})

//定义错误级别的中间件，捕获整个项目的异常错误，从为防止程序的崩溃
app.use((err, req, res, next) => {
    console.log('发生了错误' + err.message);
    res.send('Error:' + err.message)
})

==错误级别中间件一定要注册在所有路由之后！！！ ==

4.Express内置的中间件

Express内置了3个常用的中间件：

1. express.static 快速托管静态资源的内置中间件，例如:HTML文件、图片、CSS样式等(无兼容性)
2. express.json解析JSON格式的请求体数据（有兼容性，仅在4.16.0+版本中可用)
   在服务器中，可以使用req.body这个属性，来接受客户端发送过来的请求
   默认情况下，如果不配置解析表单数据的中间件，则req.body默认等于undefined

 //配置解析application/json格式数据的内置中间件 
app.use(express.json())

app.post('/', (req, res) => {
    console.log(req.body);
    res.send('ok')
})

3. express.urlencoded解析URL-encoded格式的请求体数据（有兼容性，仅在4.16.0+版本中可用)
   在服务器端，可以通过req.body来获取JSON格式的表单数据和url-encoded 格式的数据

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

app.post('/book', (req, res) => {
    console.log(req.body);
    res.send('ok')
})

5.第三方的中间件

由第三方开发出来的中间件，基本使用步骤：

1. 在终端中使用npm i 中间件名字安装中间件
2. 使用require导入中间件
3. 调用app.use()注册并使用中间件

//导入中间件
const parser = require('body-parser')

//使用中间件
app.use(parser.urlencoded({ extended: false }))

app.post('/user', (req, res) => {
    console.log(req.body);
    res.send('ok')
})

Express 内置的express.urlencoded 中间件，就是基于body-parser这个第三方中间件进一步封装出来的。