中间件函数(Middleware Function)在多种编程上下文和框架中都存在,但最常被提及的可能是与Express.js(一个流行的Node.js web框架)相关的中间件。中间件函数是一种用于处理HTTP请求和响应的函数,它们可以在请求被发送到最终的处理程序(如路由处理程序)之前或之后执行特定的任务。
在Express.js中,中间件函数通常有以下特征:
- 接收三个参数:
req
(请求对象),res
(响应对象),以及一个next
函数。 - 异步性:中间件函数可以是同步的,也可以是异步的(使用回调函数、Promises或async/await)。
- 可堆叠:多个中间件函数可以按照特定的顺序堆叠在一起,形成一个中间件堆栈。
- 调用
next()
函数:中间件函数可以调用next()
函数来将控制权传递给堆栈中的下一个中间件函数。如果当前中间件函数没有调用next()
,那么请求-响应周期就会在此处停止。
下面是一个简单的Express.js中间件函数的示例:
const express = require('express');
const app = express();
// 这是一个中间件函数
app.use((req, res, next) => {
console.log('Time:', Date.now());
// 在继续之前,添加一个自定义的请求头
req.requestTime = Date.now();
// 调用 next() 以将控制权传递给下一个中间件
next();
});
// 另一个中间件函数,只处理GET请求
app.use((req, res, next) => {
if (req.method !== 'GET') {
// 如果不是GET请求,停止处理并返回405错误
res.status(405).send('Method Not Allowed: GET');
} else {
// 否则,继续处理
next();
}
});
// 路由处理程序
app.get('/', (req, res) => {
res.send('Hello from Express!');
console.log('Request Time:', req.requestTime);
});
app.listen(3000, () => console.log('Server started on port 3000'));
在这个示例中,我们定义了两个中间件函数和一个路由处理程序。第一个中间件函数简单地记录请求的时间,并在请求对象上添加一个自定义属性。第二个中间件函数检查请求的方法,如果不是GET请求,则返回一个错误;否则,它将控制权传递给下一个中间件(在这种情况下是路由处理程序)。路由处理程序最后发送一个响应。