Express.js 是一款流行的 Node.js Web 应用程序框架,它允许开发者快速构建 web 应用程序。中间件是 Express.js 中一个重要的概念,它可以在请求到达路由处理器之前或之后执行一些操作。本文将介绍如何在 Express.js 中正确使用中间件,让你的应用更加健壮、可维护、易开发。
什么是中间件?
中间件(middleware)是一种在请求到达路由处理器之前或之后,处理 HTTP 请求和响应的方式。在 Express.js 中,中间件是通过 app.use()
函数来添加的。中间件可以执行各种操作,比如:验证用户登录状态、压缩响应数据、记录日志、判断请求来源等。一个中间件可以终止请求并返回响应,或者将请求传递到下一个中间件。
让我们来看一个非常简单的例子:
app.use((req, res, next) => { console.log('中间件执行了'); next(); }); app.get('/', (req, res) => { res.send('Hello World!'); });
在这个例子中,我们定义了一个中间件函数,并使用 app.use()
函数将它添加到 Express.js 应用程序中。在每个请求到达应用程序时,中间件函数将被执行,并输出一条消息到控制台。然后,请求被传递到下一个中间件或路由处理器。
如何正确使用中间件?
在使用中间件时,需要遵循一些最佳实践,以确保你的应用在扩展和维护方面更具有适应性和可靠性。下面是几个重要的最佳实践:
1. 在正确的位置添加中间件
在应用程序中添加中间件时,要确保它们被添加到正确的位置。考虑以下中间件:身份验证中间件、请求日志记录中间件、错误处理中间件等。这些中间件需要在路由处理器之前添加,以便对请求进行正确的处理。否则,这些中间件可能会通知错误路由处理器或跳过验证而导致安全漏洞。
app.use(express.json()); // 处理请求体 // 路由处理器 app.post('/api/user', (req, res) => { // 处理请求 });
在这个例子中,express.json()
中间件用于解析请求体,应当在路由处理器之前使用。
2. 最小化中间件的复杂性
中间件不应过于复杂,以便轻松理解、维护和重构。中间件应该专注于一个小的任务,并且只做该任务所需的工作。
-- -------------------- ---- ------- -- ----- ------------- ---- ----- -- - -- ------ ----- ---- - --------- -- ------ ----- ---- - ----------------- -- ---- ------- --- -- ---- --------------------------- --------------------------- -------- ---------------------- ---- ----- - ----- ---- - --------- -------------------- ------ ------- - -------- ---------------------- ---- ----- - ----- ---- - ----------------- -------------------- ------ ------- - -- ----- ------------ ----- ---- -- - --------------- --------- ---展开代码
在这个例子中,我们将获取请求路径和会话用户分离为两个简单的中间件函数,以便更好地处理和维护代码。
3. 处理错误的中间件
当应用程序出现错误时,应该把错误信息返回给客户端,或者记录到日志文件中。可以使用 app.use()
函数来定义全局错误处理中间件。
-- -------------------- ---- ------- -- ------- ------------- ---- ---- ----- -- - -- ------------ --------------------------- -- ---------- ------------------------------ --- -- ----- ------------ ----- ---- -- - -- ---- ----- --- --------------- ---展开代码
在这个例子中,我们定义了一个全局错误处理中间件函数来记录错误信息和向客户端返回错误响应。如果路由处理器抛出了一个错误,错误处理中间件将被自动调用。
示例代码
下面是一个简单的 Express.js 应用程序,演示了如何使用中间件来处理身份验证和记录请求日志。
-- -------------------- ---- ------- ----- ------- - ------------------- ----- --- - ---------- -- ------- -------- ------------------- ---- ----- - ----- ----- - ------------------------- -- ------- -- ----- --- -------- - ------ ----------------------------- - ------- - -- --------- -------- ------------------ ---- ----- - ----- ------ - ----------- ----- ---- - --------- ----- ---- - --- ------- -------------------- - --------- ---------- ------- - ------------------------ -- ----- ------------------------ -- ------- ----------------------- -- --------- -- ----- ------------ ----- ---- -- - --------------- --------- --- ---------------- -- -- - -------------------- ---- ----- ---展开代码
在这个例子中,我们定义了两个中间件函数:authMiddleware
和 logMiddleware
。然后,我们使用 app.use()
函数添加这些中间件到应用程序中。authMiddleware
中间件用于验证请求头中的授权令牌是否正确,如果不正确则返回一个 401 响应。logMiddleware
中间件用于记录请求时间、方法和路径。最后,我们定义了一个路由处理器来返回一个 Hello World 字符串。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/67d74a32a941bf7134d28171