express---中间件

中间件的概念

什么是中间件

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

Express 中间件的格式

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

next 函数的作用

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

定义中间件函数

定义一个最简单的中间件函数

const express = require('express')

// 创建web服务器
const app = express()

// 定义一个简单的中间件函数
const mw = (req, res, next) => {
    console.log('简单中间件');
    // 流转关系 交给下一个中间件
    next()
}

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

app.get('/', (req, res) => {
    res.send('get请求成功 /')
})

app.get('/user', (req, res) => {
    res.send('get请求成功 user')
})

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

定义全局中间件的简化形式

定义全局中间件也可以将中间件函数直接挂载到 app.use() 上面

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

// 定义全局中间件的简化形式
app.use((req, res, next) => {
  console.log('定义全局中间件的简化形式')

  next()
})

app.get('/', (req, res) => {
  console.log('调用了 / 这个路由')
  
  res.send('Home page')
})

app.get('/user', (req, res) => {
  console.log('调用了 /user 这个路由')
  res.send('User page')
})

app.listen(3000, () => {
  console.log('running……')
})

中间件的作用

多个中间件之间，共享同一份 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('/', (req, res) => {
  res.send('Home page' + req.startTime)
})

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

app.listen(3000, () => {
  console.log('running……')
})

定义多个全局中间件

可以使用 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(3000, () => {
  console.log('running……')
})

局部生效的中间件

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

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

// 定义中间件函数 mv1
const mv1 = (req, res, next) => {
  console.log('这是中间件函数')

  next()
}

// mv1 这个中间件只在 "当前路由中生效"，这种用法属于 "局部生效的中间件"
app.get('/', mv1, (req, res) => {
  res.send('Home Page')
})

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

app.listen(3000, () => {
  console.log('running……')
})

定义多个局部中间件

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

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

// 定义中间件函数 mv1
const mv1 = (req, res, next) => {
  console.log('这是第一个中间件函数')

  next()
}

// 定义中间件函数 mv2
const mv2 = (req, res, next) => {
  console.log('这是第二个中间件函数')

  next()
}

// mv1、mv2 这个中间件只在 "当前路由中生效"，这种用法属于 "局部生效的中间件"
app.get('/', mv1, mv2, (req, res) => {
  res.send('Home Page')
})

// 也可以使用数组的形式绑定两个中间件
app.get('/user', [mv1, mv2], (req, res) => {
  res.send('Home Page')
})

app.listen(3000, () => {
  console.log('running……')
})

中间件的5个使用注意事项

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