Express 中间件分类
一、 按功能用途分类
1. 应用级中间件
这类中间件应用于整个 Express 应用程序,会对每个进入应用的请求进行处理。通过 `app.use()` 方法挂载,可用于执行一些全局性的任务,像日志记录、请求预处理、设置响应头这类操作。
const express = require("express");
const app = express();
// 记录请求日志的应用级中间件
app.use((req, res, next) => {
console.log(`Received ${req.method} request for ${req.url}`);
next();
});
app.get("/", (req, res) => {
res.send("Hello, World!");
});
app.listen(3000, () => {
console.log("Server running on port 3000");
});
2. 路由级中间件
它与特定的路由相关联,只会处理匹配该路由的请求。可以使用 `express.Router()` 创建路由实例,再在上面挂载中间件。
const express = require("express");
const app = express();
const router = express.Router();
// 路由级中间件
router.use((req, res, next) => {
console.log("This is a router-level middleware");
next();
});
router.get("/", (req, res) => {
res.send("Hello from the router!");
});
app.use("/router", router);
app.listen(3000, () => {
console.log("Server running on port 3000");
});
3. 错误处理中间件
专门用来捕获和处理应用程序里的错误。错误处理中间件有四个参数 `(err, req, res, next)`,在调用 `next(err)` 传递错误时会被触发。
const express = require("express");
const app = express();
app.get("/", (req, res, next) => {
const err = new Error("Something went wrong");
next(err);
});
// 错误处理中间件
app.use((err, req, res, next) => {
console.error(err);
res.status(500).send("Internal Server Error");
});
app.listen(3000, () => {
console.log("Server running on port 3000");
});
4. 内置中间件
Express 自身提供了一些内置中间件,能够实现常见的功能。例如 `express.static()` 可用于提供静态文件服务,`express.json()` 用于解析 JSON 格式的请求体,`express.urlencoded()` 用于解析 `x-www-form-urlencoded` 格式的请求体。
const express = require("express");
const app = express();
// 使用 express.static 提供静态文件服务
app.use(express.static("public"));
// 使用 express.json 解析 JSON 请求体
app.use(express.json());
app.post("/data", (req, res) => {
console.log(req.body);
res.send("Data received");
});
app.listen(3000, () => {
console.log("Server running on port 3000");
});
5. 第三方中间件
由社区开发和维护,能为 Express 应用增添额外的功能。比如 `body-parser` 用于解析请求体,`morgan` 用于记录请求日志,`cookie-parser` 用于解析 Cookie。
const express = require("express");
const app = express();
const morgan = require("morgan");
const bodyParser = require("body-parser");
// 使用 morgan 记录请求日志
app.use(morgan("dev"));
// 使用 body-parser 解析请求体
app.use(bodyParser.json());
app.post("/submit", (req, res) => {
console.log(req.body);
res.send("Form submitted successfully");
});
app.listen(3000, () => {
console.log("Server running on port 3000");
});
二、按执行顺序分类
1. 前置中间件
在路由处理函数之前执行,主要用于对请求进行预处理,像验证请求参数、解析请求体、进行身份验证这类操作。
2. 后置中间件
在路由处理函数之后执行,一般用于对响应进行处理,比如设置响应头、格式化响应数据等。
三、按是否异步分类
1. 同步中间件
同步执行代码,不会使用异步操作(如 `Promise`、`async/await`)。当中间件执行完其逻辑后,会立即调用 `next()` 函数将控制权传递给下一个中间件或路由处理函数。
2. 异步中间件
包含异步操作,例如数据库查询、文件读取、网络请求等。在异步中间件里,需要使用 `async/await` 或者回调函数来处理异步操作,确保在异步操作完成后再调用 `next()` 函数。
const express = require("express");
const app = express();
// 异步中间件示例
app.use(async (req, res, next) => {
try {
// 模拟异步操作
await new Promise((resolve) => setTimeout(resolve, 1000));
console.log("Async middleware executed");
next();
} catch (err) {
next(err);
}
});
app.get("/", (req, res) => {
res.send("Hello, World!");
});
app.listen(3000, () => {
console.log("Server running on port 3000");
});