Node中Express中间件详解

最新推荐文章于 2024-05-23 17:42:39 发布
最新推荐文章于 2024-05-23 17:42:39 发布
阅读量722 收藏 14
点赞数 13
分类专栏： Nodejs 文章标签： express 中间件
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_44741577/article/details/136456501
版权

文章目录

一、中间件的概念

  • 现实生活中的例子

在处理污水的时候，一般都要经过三个处理环节

image.png

处理污水的这三个中间处理环节，就可以叫做中间件

二、Express 中间件的调用流程

当一个请求到达Express 的服务器之后，可以连续调用多个中间件，从而对这次请求进行预处理

image.png

三、Express 中间件的格式

Express 的中间件，本质上就是一个 function 处理函数，Express中间件的格式如下:

const mv = function (req, res, next) {};

注意：
中间件函数的形参列表中，必须包合 next 参数。而路由处理函数中只包含 req 和 res。

四、next函数作用

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

image.png

五、定义中间件函数

可以通过如下的方式，定义一个最简单的中间件函数:

const mv = function (req, res, next) {
  console.log("这是一个中间件");
  // 把流转关系转交给下一个中间件或者路由
  next();
};

六、全局生效中间件

客户端发起的任何请求，到达服务器之后，都会触发的中间件，叫做全局生效的中间件

通过调用 app.use(中间件函数)，即可定义一个全局生效的中间件，示例代码如下：

const express = require("express");

const app = express();

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

const mv = function (req, res, next) {
  console.log("这是一个中间件");
  // 把流转关系转交给下一个中间件或者路由
  next();
};
// 全局生效中间件
app.use(mv);

app.get("/user", (req, res) => {
  console.log("调用了/user这个路由");
  res.end("成功");
});

app.listen(80, () => {
  console.log("express server running at http://127.0.0.1");
});

image.png
image.png

6.1. 定义多个全局中间件

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.end("成功");
});

app.listen(80, () => {
  console.log("express server running at http://127.0.0.1");
});

image.png
image.png

七、中间件的作用

多个中间件之间，共享同一份 req 和 res。基于这样的特性，我们可以在上游的中间件中，统一为 req 或 res 对象添加自定义的属性或方法，供下游的中间件或路由进行使用

image.png

7.1. 体验中间件的作用

为req对象挂载自定义属性 从而把时间共享给后面的所有路由

const express = require("express");

const app = express();

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

const mv = function (req, res, next) {
  // 获取请到达服务器的时间
  const time = new Date();
  // 为req对象挂载自定义属性 从而把时间共享给后面的所有路由
  req.startTime = time;
  next();
};
// 全局生效中间件
app.use(mv);

app.get("/user", (req, res) => {
  console.log(req.startTime); //2023-09-10T10:55:44.099Z
  res.end("成功");
});

app.listen(80, () => {
  console.log("express server running at http://127.0.0.1");
});

八、局部生效的中间件

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

8.1. 单个中间件

const express = require("express");

const app = express();

const vm = function (req, res, next) {
  console.log("局部中间件生效了");
  next();
};
app.get("/user", vm, (req, res) => {
  res.end("成功");
});

app.listen(80, () => {
  console.log("express server running at http://127.0.0.1");
});

8.2. 多个中间件

const vm1 = function (req, res, next) {
  console.log("局部中间件一生效了");
  next();
};
const vm2 = function (req, res, next) {
  console.log("局部中间件二生效了");
  next();
};
// app.get("/user", vm1, vm2, (req, res) => {
//   res.end("成功");
// });
app.get("/user", [vm1, vm2], (req, res) => {
  res.end("成功");
});

九、中间件使用注意事项

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

十、中间件的分类

为了方便大家理解和记忆中间件的使用，Express 官方把常见的中间件用法，分成了 5 大类，分别是：

  • 应用级别的中间件
  • 路由级别的中间件
  • 错误级别的中间件
  • Express内置的中间件
  • 第三方的中间件

10.1. 应用级别的中间件（挂载到app身上）

通过 app.use()或app.get() 或 app.post()，绑定到 app 实例上的中间件，叫做应用级别的中间件

app.use((req, res, next) => {
  next();
});
app.get("/user", vm1, (req, res) => {
  res.end("成功");
});

10.2. 路由级别的中间件 （挂载到router身上）

const express = require("express");

// 创建路由对象
const router = express.Router();

router.use(function (req, res, next) {
  console.log("Time:" + new Date());
  next();
});

10.3. 错误级别的中间件

作用： 专门用来捕获整个项目中发生的异常错误，从而防止项目异常崩溃的问题
格式： 错误级别中间件的 function 处理函数中，必须有 4 个形参，形参顺序从前到后，分别是(err,req,res, next)

注意： 错误级别的中间件必须注册在所有的路由之后

  • 传统抛错
const express = require("express");

const app = express();

app.get("/user", (req, res) => {
  throw new Error("f服务器内部发生错误"); //抛出一个自定义的错误
  res.end("成功"); //不在执行
});

app.listen(80, () => {
  console.log("express server running at http://127.0.0.1");
});
  • 使用错误中间件
const express = require("express");

const app = express();

app.get("/user", (req, res) => {
  throw new Error("f服务器内部发生错误"); //抛出一个自定义的错误
  res.end("成功"); //不在执行
});
//错误级别的中间件
app.use(function (err, req, res, next) {
  // 在服务器打印错误信息
  console.log("error" + err.message);
  //向客户端响应错误相关内容
  res.end(err.message);
});

app.listen(80, () => {
  console.log("express server running at http://127.0.0.1");
});

十一、Express的内置中间件

自 Express 4.16.0版本开始，Express 内置了3 个常用的中间件，极大的提高了 Express 项目的开发效率和体验

  • express.static 快速托管静态资源的内置中间件，例如: HTML 文件、图片、CSS 样式等(无兼容性)
  • express.json 解析JSON 格式的请求体数据(有兼容性，仅在4.16.0+ 版本中可用)
  • express.urlencoded 解析 URL-encoded 格式的请求体数据(有兼容性，仅在 4.16.0+ 版本中可用)
const express = require("express");

const app = express();
//  配置解析 application/json 格式数据的内置中间件
app.use(express.json());
// 配置解析 application/x-ww-form-urlencoded格式数据的内置中间件
app.use(express.urlencoded({ extended: false }));

app.listen(80, () => {
  console.log("express server running at http://127.0.0.1");
});

11.1. express.urlencoded中间件

const express = require("express");

const app = express();
// 配置解析 application/x-ww-form-urlencoded格式数据的内置中间件
app.use(express.urlencoded({ extended: false }));

app.post("/user", (req, res) => {
  // 在服务器，可以使用 req.body 这个属性，来接收客户端发送过来的请求体数据
  // 默认情况下，如果不配置解析表单数据的中间件，则 req.body 默认等于 undefined
  console.log(req.body);
  res.end("ok");
});
app.listen(80, () => {
  console.log("express server running at http://127.0.0.1");
});

  • 我们利用postman发一个请求体json的post请求
    image.png

  • 打印结果
    image.png

11.3. 第三方的中间件

非 Express 官方内置的，而是由第三方开发出来的中间件，叫做第三方中间件。在项目中，大家可以按需下载并配置第三方中间件，从而提高项目的开发效率

例：在express@4.16.0之前的版本中，经常使用 bodyparser 这个第三方中间件，来解析请求体数据。使用步骤如下:

  • 运行 npm install body-parser 安装中间件
  • 使用 require 导入中间件
  • 用 app.use()注册并使用中间件

注意:Express内置的expressurlencoded 中间件，就是基于 body-parser 这个第三方中间件进一步封装出来的。

const express = require("express");

const app = express();
// 1.导入解析表单数据的中间件 body-parser
const parser = require("body-parser");
// 2. 使用 app.use() 注册中间件
app.use(parser.urlencoded({ extended: false }));

app.post("/user", (req, res) => {
  // 在服务器，可以使用 req.body 这个属性，来接收客户端发送过来的请求体数据
  // 默认情况下，如果不配置解析表单数据的中间件，则 req.body 默认等于 undefined
  console.log(req.body);
  res.end("ok");
});
app.listen(80, () => {
  console.log("express server running at http://127.0.0.1");
});

  • 我们利用postman发一个请求体json的post请求
    image.png

  • 打印结果
    image.png

十二、自定义中间件

12.1. 需求描述与实现步骤

自己手动模拟一个类似于 expressurl.encoded 这样的中间件，来解析 POST 提交到服务器的表单数据

实现步骤:

  • 定义中间件
  • 监听 req的 data 事件
  • 监听req的end 事件
  • 使用querystring 模块解析请求体数据
  • 将解析出来的数据对象挂载为 req.body
  • 将自定义中间件封装为模块

12.2. 实现

  • 监听req 的 data 事件

在中间件中，需要监听req 对象的 data 事件，来获取客户端发送到服务器的数据如果数据量比较大，无法一次性发送完毕，则客户端会把数据切割后，分批发送到服务器。所以 data 事件可能会触发多次，每一次触发 data 事件时，获取到数据只是完整数据的一部分，需要手动对接收到的数据进行拼接。

  • 监听req 的 end 事件

当请求体数据接收完毕之后，会自动触发req的end 事件。因此，我们可以在 req的end 事件中，拿到并处理完整的请求体数据。

  • 使用querystring 模块解析请求体数据
    Node.js 内置了一个 querystring 模块，专门用来处理查询字符串。通过这个模块提供的 parse() 函数，可以轻松把查询字符串，解析成对象的格式。

  • 将解析出来的数据对象挂载为 req.body

  • 上游的中间件和下游的中间件及路由之间，共享同一份 req 和 res。因此，我们可以将解析出来的数据，挂载为 req的自定义属性，命名为 req.body，供下游使用。

  • 完整代码

const express = require("express");

const app = express();
// 导入 Node.js 内置的 querystring 模块
const qs = require("querystring");
// 自定义中间件
app.use(function (req, res, next) {
  // 定义中间件具体的业务逻辑
  // 1.定义一个 str 字符串，专门用来存储客户端发送过来的请求体数据
  let str = "";
  // 2.监听 req 的 data 事件
  req.on("data", (chunk) => {
    str += chunk;
  });
  // 3.监听 req 的 end 事件
  req.on("end", () => {
    // 在str中就是完整的请求体数据
    console.log(str); //name=%E5%BC%A0%E4%B8%89&age=14
    // TODO 把字符串格式的请求体数据，解析成对象格式
    const body = qs.parse(str);
    console.log(body); //{ name: '张三', age: '14' }
    // 将解析出来的数据对象挂载为 req.body
    req.body = body;
    next();
  });
});

app.post("/user", (req, res) => {
  // 在服务器，可以使用 req.body 这个属性，来接收客户端发送过来的请求体数据
  // 默认情况下，如果不配置解析表单数据的中间件，则 req.body 默认等于 undefined
  console.log(req.body);  //{ name: '张三', age: '14' }
  res.end("ok"); 
});
app.listen(80, () => {
  console.log("express server running at http://127.0.0.1");
});

12.3. 将自定义中间件封装为一个独立的模块

image.png

  • custom-body-parser.js
// 导入 Node.js 内置的 querystring 模块
const qs = require("querystring");

const bodyParser = function (req, res, next) {
  // 定义中间件具体的业务逻辑
  // 1.定义一个 str 字符串，专门用来存储客户端发送过来的请求体数据
  let str = "";
  // 2.监听 req 的 data 事件
  req.on("data", (chunk) => {
    str += chunk;
  });
  // 3.监听 req 的 end 事件
  req.on("end", () => {
    // 在str中就是完整的请求体数据
    console.log(str); //name=%E5%BC%A0%E4%B8%89&age=14
    // TODO 把字符串格式的请求体数据，解析成对象格式
    const body = qs.parse(str);
    console.log(body); //{ name: '张三', age: '14' }
    // 将解析出来的数据对象挂载为 req.body
    req.body = body;
    next();
  });
};

module.exports = bodyParser;
  • index.js
const express = require("express");

const app = express();
// 引入自定义中间件
const customBodyParser = require("./custom-body-parser");
// 自定义中间件
app.use(customBodyParser);

app.post("/user", (req, res) => {
  // 在服务器，可以使用 req.body 这个属性，来接收客户端发送过来的请求体数据
  // 默认情况下，如果不配置解析表单数据的中间件，则 req.body 默认等于 undefined
  console.log(req.body); //{ name: '张三', age: '14' }
  res.end("ok");
});
app.listen(80, () => {
  console.log("express server running at http://127.0.0.1");
});
const express = require("express");

const app = express();
// 引入自定义中间件
const customBodyParser = require("./custom-body-parser");
// 自定义中间件
app.use(customBodyParser);

app.post("/user", (req, res) => {
  // 在服务器，可以使用 req.body 这个属性，来接收客户端发送过来的请求体数据
  // 默认情况下，如果不配置解析表单数据的中间件，则 req.body 默认等于 undefined
  console.log(req.body); //{ name: '张三', age: '14' }
  res.end("ok");
});
app.listen(80, () => {
  console.log("express server running at http://127.0.0.1");
});
扶苏1002
关注
  • 13
    点赞
  • 踩
  • 14
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
node中koa中间件机制详解
08-29
在Node.js环境中，Koa是一个由Express团队开发的现代Web应用程序框架，它提供了一种更加优雅的方式来构建服务器端应用。Koa的核心特性之一是它的中间件机制，这使得开发者能够轻松地组织和管理应用程序的不同部分。...
Node.js express框架里的中间件和ejs模板
XUYIGE的博客
04-28 188
express框架里提供的中间件 应用层中间件、路由器级中间件、错误处理中间件、内置中间件、第三方中间件。 应用层中间件：app.use() 放到路由之前 路由器级中间件：router.use() 错误处理中间件：四个参数（err,req,res,next) 多一个err参数区分标识 内置中间件：express.static提供静态资产例如HTML文件图像等 express.json使用JSON...
Express中间件
世界和我们都不该止步于此
04-07 3729
目录 一.了解中间件 二.定义中间件 1.定义一个局部生效的中间件 2.定义一个全局生效的中间件 3.定义多个中间件遇到的问题 4.中间件有什么作用？ 5.总结 三.中间件的分类 1.应用级别中间件 2.路由级别中间件 3.错误级别中间件 4.Express内置中间件 5.第三方中间件 一.了解中间件 中间件（Middleware）是一个概念 用来特指业务流程的中间处理环节 在我们的Express服务器中，也是这样的道理，当客户端请求到达Express服务器后...
Express 的中间件
最新发布
weijia_kmy的博客
05-23 506
使用 express 处理请求的时候，一般都在后面添加个回调，每个回调都包含req、res和next。关于中间件的调用，它永远先调用第一个匹配的中间件，调用完成后，看有没有next()去连接下一个中间件，没有的话就挂起，有就一直执行下去。如果当前中间件函数没有结束请求-响应周期，它必须调用 next() 将控制传递给下一个中间件函数。
Express的中间件,保证让你看的明明白白
军火库
01-05 941
/ 常量 mw 所指向的，就是一个中间件函数const mw = function (req, res, next) {console.log("我是一个中间件')// 注意: 在当前中间件的业务处理完毕后，必须调用 next() 函数// 表示把流转关系转交给下一个中间件或路由next()}我么可以使用 app.use()连续定义多个全局中间件。就像之前定义多个静态服务一样。客户端请求到达服务器之后，会按照中间件定义的先后顺序依次进行调用。
express框架中间件
m0_62785037的博客
07-06 1453
express框架全局中间件和路由中间件的解释与说明
5、express路由和express中间件
weixin_48137421的博客
04-10 1854
自定义一个中间件，来实现客户端的请求和服务器端的映射关系。
node.js 中间件express-session使用详解
10-19
主要给大家介绍了node.js中间件express-session使用的相关资料，文中介绍的非常详细，对大家具有一定的参考学习价值，需要的朋友们下面来一起看看吧。
express的中间件cookieParser详解
09-04
`cookieParser`是Express中间件之一，专门用于解析客户端（通常是一个Web浏览器）通过HTTP头部发送的cookie信息。本文将深入讲解`cookieParser`中间件的使用方法以及它如何与Express应用程序协同工作。 首先，让...
express的中间件bodyParser详解
09-04
在Node.js环境中，Express框架是构建web应用的常用工具，而`bodyParser`是Express早期版本中的一个中间件，主要用于解析HTTP请求体（body）中的数据。中间件是一种功能层，它可以在请求到达应用程序之前对其进行处理...
【Nodejs】深入理解Express框架之如何使用各类中间件_04
青春木鱼的博客
05-10 1419
中间件为路由服务的，用于拦截对路由的请求，也可以作出响应。在nodejs中，中间件主要是指封装所有Http请求细节处理的方法，是从Http请求发起到响应结束过程中的处理方法。中间件的行为比较类似Java中过滤器的工作原理，就是在进入具体的业务处理之前，先让过滤器处理。中间件分为5大类，应用级中间件、路由级中间件、内置中间件、第三方中间件、错误处理中间件
express常用的中间件详细介绍
邪小新的博客
05-24 9285
Express是一个自身功能极简，完全是有路由和中间件构成的一个web开发框架：本质上说，一个express的应用就是在调用各种中间件。 中间件的功能： 执行任何代码。 修改请求和响应对象。 终结请求-响应循环。 调用堆栈中的下一个中间件。 重点 如果在post，get请求过程中的回调函数没有next()参数，那么就匹配上第一个路由，就不会往下匹配了。如果想往下匹配的话，就需要写next(); ...
【express】中间件
liuqinhou的博客
03-18 359
console.log('这是最简单的中间件函数');// 把流转关系转交给下一个中间件或路由next()可以使用app.use()连续定义多个全局中间件。客户请求到达服务器之后，会按照中间件定义的先后顺序依次进行调用console.log('调用了第一个中间件');next()})console.log('调用了第二个中间件');next()})})当请求http://127.0.0.1/时如上两种写法是等价的。
Node.js -- Express中间件
gghhb12的博客
04-19 617
/ 常量 mw 所指向的，就是一个中间件函数 const mw = function(req , res , next) {console . log('这是一个最简单的中间件函数') // 注意: 在当前中间的业务处理完毕后，必须调用 next() 函数 // 表示把流转关系转交给下一个中间件或路由 next() }可以使用app.use()连续定义多个全局中间件，客户端请求到达服务器后，会按照中间件定义的先后顺序依次进行调用。
《web开发： （Node.js）Express 中间件》
yexiangCSDN的专栏
01-21 202
一、Express 中间件 1. 什么是中间件 中间件（Middleware ），特指业务流程的中间处理环节。 2. 现实生活中的例子 在处理污水的时候，一般都要经过三个处理环节，从而保证处理过后的废水，达到排放标准。 处理污水的这三个中间处理环节，就可以叫做中间件。 3. Express 中间件 3.1 中间件的概念 3. Express 中间件的调用流程 当一个请求到达 Express 的服务器之后，可以连续调用多个中间件，从而对这次请求进行预处理。 3. Express 中间件 3.
Express 中的错误处理中间件
lio-zero 的博客
02-19 892
Express 的错误处理中间件可帮助您处理错误，而无需重复同样的工作。假设您直接在 Express 路由处理程序中处理错误： app.put('/user/:id', async (req, res) => { let user try { user = await User.findOneAndUpdate({ _id: req.params.id }, req.body...
Node.js 知识整理之第三篇（Express中间件）
霖霂晗的专栏
09-06 309
Node.js Express中间件
node中express是模块还是路由
05-10
Express是一个Node.js的Web框架，它是一个模块。它提供了一些简单易用的API，帮助开发者快速构建Web应用程序。在Express中，路由是指将URL和HTTP请求处理器绑定起来的机制。Express提供了一系列API用于创建和管理路由。通过使用Express的路由机制，开发者可以非常方便地实现RESTful API等Web应用程序。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值