Express.js 中间件 - 详细学习指南

阅读时长 9 分钟读完

Express.js 是一个功能强大、灵活而又快速的 Web 应用程序框架,它使得构建 Web 应用程序变得更加简单。Express.js 中的中间件(Middleware)是它的核心概念之一。中间件是一种可以被插入到 HTTP 请求的处理中的函数,它负责在请求到达最终处理程序之前执行一些操作。本文将为您介绍 Express.js 中间件的详细使用方法和注意事项。

Express.js 中间件简介

在 Express.js 中,每个中间件都是一个函数,它接收三个参数:request(请求对象)、response(响应对象)和 next(函数)。通常情况下,中间件首先对请求进行某些处理,然后调用 next 函数将请求传递给下一个中间件或最终处理程序。

-- -------------------- ---- -------
-- ---------- ---------- ---
----- ------- - -------------------
----- --- - ----------

-- --------------
----- ---------------- - ------------- ---- ----- -
  ----------------------------- -------------
  -------
--

-------------------------- -- ---------

-- ------
------------ ------------- ---- -
  ---------------- ---------
---

-----------------

上面的示例代码展示了一个简单的中间件,它用于设置响应头的 content-type 为 text/html。使用 app.use 将该中间件应用到全局,从而在所有路由中生效。当请求进来的时候,该中间件先进行处理,然后将请求交给最终处理程序处理。

Express.js 中间件的分类

Express.js 中的中间件可以被分为四种类型:应用级中间件、路由级中间件、内置中间件和第三方中间件。

应用级中间件

应用级中间件是应用程序的全局中间件。它们绑定到 app 对象上,可以在应用程序中的任何路由处理之前执行。

例如,我们想要在请求到达应用程序的任何路由之前进行身份验证,可以使用一个应用级中间件来处理。

-- -------------------- ---- -------
-- -------------------
----- ------- - -------------------
----- --- - ----------

----- -------------- - ------------- ---- ----- -
  ----- --------------- - ----------------------
  -- ----------------- -
    -------
  - ---- -
    ------------------------------------
  -
--

------------------------ -- ------

-- ------
------------ ------------- ---- -
  ---------------- ---------
---

-----------------

上面的示例代码中,我们使用了一个应用级中间件 authentication,在请求到达最终处理程序之前进行身份验证。如果未通过验证,则返回 401 状态码。

路由级中间件

路由级中间件与应用程序级别的中间件相似,但是它们是针对特定路由的中间件。这种中间件可以帮助您定义路由级别的行为。

-- -------------------- ---- -------
-- -------------
----- ------- - -------------------
----- --- - ----------

----- ------ - -----------------

-- ------
------------------------ ---- ----- -
  -------------------- ------------
  -------
---

-- ------
--------------- ------------- ---- -
  ---------------- ---------
---

--------------- -------- -- --- --- ----

-----------------

上面的示例代码中,我们定义了一个路由级中间件来记录请求处理程序之前的时间。我们将该中间件应用于 /api 路径,因此在访问 /api 路径时,中间件将首先执行,然后才显示 Hello World。

内置中间件

内置中间件是 Express.js 提供的内部中间件。这些中间件已经在 Express.js 框架中预先安装,并且可以随时使用。您可以使用内置中间件来处理特定类型的请求,例如静态文件。

-- -------------------- ---- -------
-- ------------
----- ------- - -------------------
----- ---- - ----------------
----- --- - ----------

-- -- ---------- ----------
------------------------------------------- ------------

-----------------

上面的示例代码中,我们使用了 Express.js 内置的静态文件中间件,该中间件可以提供从指定目录中提供静态文件的能力。我们可以通过使用 app.use() 添加静态文件的目录。

第三方中间件

第三方中间件是其他人开发并共享的中间件。它们没有预安装在 Express.js 中,但您可以在应用程序中使用它们来添加特定功能。

例如,我们可以使用 cors 中间件来允许特定来源的请求。

-- -------------------- ---- -------
-- -------------
----- ------- - -------------------
----- ---- - ----------------
----- --- - ----------

-- -- ---- ---
--------------
  ------- ------------------------ -- ---------
  --------------------- --- -- -----------
----

-- ------
------------ ------------- ---- -
  ---------------- ---------
---

-----------------

上面的示例代码中,我们使用了 cors 中间件来允许来自 http://localhost:8080 的请求。使用 app.use 添加该中间件到应用程序中。

Express.js 中间件的使用方法

Express.js 中间件具有易于使用的 API,使您可以轻松地添加中间件到应用程序或路由中。

应用级中间件

在应用程序中使用中间件时,使用 app.use() 或 app.all() 函数。

-- -------------------- ---- -------
-- -----------------
----- ------- - -------------------
----- --- - ----------

-- ----------
--------------------- ---- ----- -
  -------------------- ------------
  -------
---

-- ------
------------ ------------- ---- -
  ---------------- ---------
---

-----------------

上面的示例代码中,我们在应用程序中添加了一个应用程序级别的中间件。使用 app.use() 添加该中间件到应用程序中。

路由级中间件

在路由中使用中间件时,使用 express.Router() 函数来创建一个新的路由对象。

-- -------------------- ---- -------
-- ---------------
----- ------- - -------------------
----- --- - ----------

----- ------ - -----------------

-- --------
------------------------ ---- ----- -
  -------------------- ------------
  -------
---

-- ------
--------------- ------------- ---- -
  ---------------- ---------
---

--------------- -------- -- --- --- ----

-----------------

上面的示例代码中,我们创建了一个新的路由对象并向其中添加了一个路由级别的中间件。将该路由应用于 /api/ 路径,以改变其默认行为。

中间件堆叠

Express.js 允许您在需要时对多个中间件进行堆叠,从而组合它们的功能。

-- -------------------- ---- -------
-- -----------
----- ------- - -------------------
----- --- - ----------

----- ------ - ------------- ---- ----- -
  -------------------- ------------
  -------
--

----- -------------- - ------------- ---- ----- -
  ----- --------------- - ----------------------
  -- ----------------- -
    -------
  - ---- -
    -------------------------------------
  -
--

--------------- ---------------- -- -----

-- ------
------------ ------------- ---- -
  ---------------- ---------
---

-----------------

上面的示例代码中,我们将两个中间件 logger 和 authentication 堆叠起来,并使用 app.use() 添加到路由器中。在运行的时候,中间件将按顺序执行。

Express.js 中间件的工作流程

当请求到达应用程序时,Express.js 将请求路由到适当的路由处理程序。在请求处理程序之前,中间件将按顺序被执行。中间件的执行顺序是 app.use() 或 router.use() 中定义的顺序。

在执行 Express.js 中间件时,每个中间件将检查请求是否满足特定条件。如果请求符合特定条件,则中间件将执行下一步操作;否则,中间件可能会发送响应,或直接终止处理程序的进程。因此,您应该小心在中间件中使用响应方法。

总结

在 Express.js 中使用中间件是添加自定义行为和功能的最佳方式。在本文中,我们介绍了 Express.js 中间件的四种类型,并提供了示例代码和指导。使用中间件可以使我们修改和验证请求(和响应),从而加强我们应用的安全和可靠性。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/64ca3c645ad90b6d041a2bf9

纠错
反馈