Express 中间件分类

发布于:2025-02-16 ⋅ 阅读:(76) ⋅ 点赞:(0)

一、 按功能用途分类

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");

});


网站公告

今日签到

点亮在社区的每一天
去签到