Express.js 是一个基于 Node.js 平台构建的 Web 应用程序框架，它提供了一系列强大的功能，包括路由。路由是指将请求的 URL 映射到相应的处理函数。Express.js 提供了很多实现路由的方式，例如使用路由模块。在本文中，我们将探讨如何使用 Express.js 路由模块的最佳实践，并包含一些示例代码。
路由模块
在 Express.js 中，路由模块是通过调用 express.Router() 方法创建的。路由模块是一个独立的路由系统，可以在主应用程序中用作中间件。通过将不同的路由器组合起来，可以构建复杂的路由结构。以下是一个创建路由模块的示例代码：
-- -------------------- ---- ------- ----- ------- - ------------------- ----- ------ - ----------------- --------------- ------------- ---- - --------------- --- -------------------- ------------- ---- - ----------------- --- -------------- - -------
在路由模块中使用 get() 方法来定义和处理 HTTP GET 请求。上述示例代码定义了两个路由：/ 和 /about。当客户端请求这些路由时，将分别返回 "首页" 和 "关于我们"。
最佳实践
1. 模块化路由
在应用程序中，将所有的路由处理函数都放在一个文件中会使代码难以维护。因此，建议将路由处理函数分组，并将它们放在不同的路由器模块中。这样做，除了可以使代码结构更为清晰，同时也便于扩展和修改。以下是一个示例代码片段：
-- -------------------- ---- ------- -- -------------- ----- ------- - ------------------- ----- ------ - ----------------- --------------- ------------- ---- - ----------------- --- ------------------ ------------- ---- - ------------ ------------------- --- -------------- - ------- -- --------------- ----- ------- - ------------------- ----- ------ - ----------------- --------------- ------------- ---- - --------------- --- ------------------- ------------------- -------------- - ------- -- ------ ----- ------- - ------------------- ----- --- - ---------- ----- ------ - -------------------- ------------ -------- ---------------- ---------- - -------------------------- ---
在上述示例中，我们将不同的路由处理函数放在两个不同的路由器模块中。routes/user.js 定义了 '/user' 和 '/user/:id' 两个路由。
routes/index.js 定义了根路由 '/ 和子路由 /user。注意，我们使用了 router.use() 方法将用户路由器模块包含在主路由器模块中。
app.js 文件使用 express.Router() 和主路由器模块初始化应用程序。
2. 处理错误
当路由器模块中的处理函数出现错误时，应该始终使用 next(err) 方法将错误传递到 Express.js 内置的错误处理程序中。此外，还可以使用 try-catch 语句来捕获路由处理函数中的错误。
以下是一个处理错误的示例代码：
-- -------------------- ---- -------
----- ------- - -------------------
----- ------ - -----------------
--------------- ------------- ---- ----- -
--- -
----- ----- - -----------
----------------
- ---------- -
----------
-
---
-------------- - -------上述代码通过 try-catch 语句捕获了 getUsers() 函数中的错误，并使用 next(err) 将其传递给错误处理程序。
3. 使用中间件
中间件是 Express.js 最重要的概念之一。它们被用于处理 HTTP 请求和响应的过程中。使用中间件来创建一个可重用的处理程序。
以下是使用中间件的示例代码：
-- -------------------- ---- ------- ----- ------- - ------------------- ----- ------ - ----------------- ------------------------ ---- ----- - --------------------- ---------------- ------------ ------- --- --------------- ------------- ---- - ----------------- --- -------------- - -------
上述示例代码中，中间件函数在处理任何 HTTP 请求前都会执行。在本例中，我们只是简单地记录请求的原始 URL 和请求的 HTTP 方法。
4. 使用异步处理程序
路由处理程序中可能会包含一些异步行为，例如从数据库中获取数据。为了避免阻塞应用程序的进程，建议将异步函数转换为 Promise。同时，还需要在路由处理程序中使用 async/await 支持异步处理程序。
以下是一个使用异步处理程序的示例代码：
-- -------------------- ---- -------
----- ------- - -------------------
----- ------ - -----------------
----- -- - -----------------
--------------- ----- ------------- ---- ----- -
--- -
----- ----- - ----- --------------
----------------
- ---------- -
----------
-
---
-------------- - -------在上述示例代码中，我们通过调用 await db.getUsers() 获取了数据库中的用户列表。同时，我们使用了 try-catch 语句来捕获异步函数中的错误。
结论
在本文中，我们探讨了 Express.js 路由模块的最佳实践。我们特别强调了模块化路由、处理错误、使用中间件和使用异步处理程序。这些最佳实践可以帮助您构建更加清晰、可维护的路由结构，同时还可以提高应用程序的性能和稳定性。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/670a56fad91dce0dc8809500