express教程 express路由 express中间件 express静态资源 express mongodb

express中间件

栏目： express 发布时间：2024-12-13

在Express框架中，中间件（Middleware）是一个非常重要的概念，它允许你在请求被路由处理函数处理之前或之后执行代码。中间件的功能非常强大，可以用于日志记录、请求和响应的修改、身份验证、错误处理等。以下是一篇详细的Express中间件教程。

##一、中间件的基本概念

什么是中间件：中间件是一个函数，它可以访问请求对象（req）、响应对象（res）和管道中的下一个中间件函数（next）。每个中间件函数都可以对请求和响应对象进行操作，并决定是否将控制权传递给下一个中间件函数。
中间件的执行顺序： Express应用中的中间件函数是按照它们被添加到应用中的顺序执行的。每个中间件函数都有机会执行代码、修改请求和响应对象，然后决定是否调用next()函数来将控制权传递给下一个中间件函数。

##二、定义和使用中间件

定义中间件函数：中间件函数通常具有三个参数：请求对象（req）、响应对象（res）和下一个中间件函数（next）。

const myMiddleware = (req, res, next) => {
    // 在这里可以执行任何代码
    console.log('Request received');
    // 调用next()函数将控制权传递给下一个中间件函数
    next();
};

使用中间件：使用app.use()方法将中间件函数添加到Express应用中。

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

app.use(myMiddleware);

app.get('/', (req, res) => {
    res.send('Hello, World!');
});

const port = 3000;
app.listen(port, () => {
    console.log(`Server is running on port ${port}`);
});

##三、中间件的种类

应用级中间件：使用app.use()或app.METHOD()（如app.get、app.post等）添加的中间件函数是应用级中间件。它们会对所有请求起作用，除非你在中间件函数内部进行了条件判断并调用了next()或发送了响应。

路由级中间件：你可以为特定的路由或路由组定义中间件。这些中间件只会对匹配到该路由或路由组的请求起作用。

const router = express.Router();

router.use((req, res, next) => {
    console.log('Route-specific middleware');
    next();
});

router.get('/example', (req, res) => {
    res.send('This is an example route');
});

app.use('/specific-route', router);

错误处理中间件：错误处理中间件具有四个参数，而不是通常的三个：(err, req, res, next)。它们没有next()函数，因为它们是终端中间件，用于处理错误并发送响应。
```
app.use((err, req, res, next) => {
    console.error(err.stack);
    res.status(500).send('Something broke!');
});
```
内置中间件： Express提供了一些内置的中间件，如express.json()和express.urlencoded()，用于解析请求体中的JSON和URL编码的数据。
```
app.use(express.json());
app.use(express.urlencoded({ extended: true }));
```
第三方中间件：你还可以使用许多第三方中间件来扩展Express应用的功能，如body-parser（虽然现在已经被express.json()和express.urlencoded()取代）、cookie-parser、morgan（用于日志记录）等。

##四、中间件的执行流程

请求到达服务器：当客户端发送请求到服务器时，Express应用会按照中间件函数的添加顺序依次执行它们。
中间件函数执行：每个中间件函数都有机会执行代码、修改请求和响应对象，并决定是否调用next()函数来将控制权传递给下一个中间件函数。
路由处理函数执行：当所有匹配的中间件函数都执行完毕后（即它们都调用了next()函数），请求会被传递给匹配的路由处理函数。
响应发送：路由处理函数负责发送响应给客户端。一旦响应被发送，请求-响应循环就结束了，后续的中间件函数（如果有的话）将不会被执行。
错误处理：如果在请求处理过程中发生错误，并且该错误没有被捕获和处理，那么它将传播到错误处理中间件（如果有定义的话）。

##五、最佳实践

组织代码：将中间件函数组织在单独的模块中，并在主应用文件中引入它们，以保持代码的清晰和可维护性。
错误处理：始终为Express应用添加错误处理中间件，以捕获和处理在请求处理过程中发生的错误。
使用路由级中间件：对于只适用于特定路由或路由组的中间件，使用路由级中间件而不是应用级中间件，以减少不必要的性能开销。
理解中间件的作用域：清楚每个中间件函数的作用域（即它会对哪些请求起作用），以避免不必要的代码执行和潜在的副作用。

通过以上步骤和最佳实践，你应该已经对Express中间件有了深入的了解，并能够使用它来创建功能丰富的Web应用。

本文地址：https://www.tides.cn/p_express-middleware

express中间件

推荐阅读