2024-08-09发表2024-08-10更新软件开发 / Node.js6 分钟读完 (大约895个字)0次访问

27 中间件的定义

中间件的概念与使用

在Node.js中，尤其是使用Express框架时，中间件是一个非常重要的概念。中间件是一个函数，它有权访问请求对象（req）、响应对象（res）和应用程序的请求-响应周期中的下一个中间件函数。中间件可以用来执行多种任务，如请求的解析、用户认证、错误处理等。

一个中间件函数的基本签名是：

function(req, res, next) {
  // 执行某些操作
  next(); // 调用下一个中间件
}

next是一个函数，在中间件中调用它可以将控制权传递给下一个中间件。如果不调用next，请求将会挂起，客户端将不会收到响应。

中间件的使用

在Express应用程序中，您可以使用app.use()来注册中间件。例如，创建一个简单的日志中间件，打印每个请求的时间戳和请求路径：

const express = require('express');
const app = express();

// 日志中间件
app.use((req, res, next) => {
  console.log(`请求时间: ${new Date()}`);
  console.log(`请求路径: ${req.path}`);
  next(); // 继续处理请求
});

// 示例路由
app.get('/', (req, res) => {
  res.send('欢迎来到首页!');
});

// 启动服务器
app.listen(3000, () => {
  console.log('服务器正在运行在 http://localhost:3000');
});

在上述示例中，无论请求的路径是什么，都会先执行日志中间件，输出请求的时间和路径。

中间件的种类

中间件可以分为几类：

应用级中间件：绑定到app对象，处理特定的请求。
路由级中间件：绑定到特定的路由处理，可以用来做特定路由的处理。
内置中间件：Express提供的内置中间件，比如express.json()，用于解析JSON数据。
第三方中间件：使用npm安装的中间件，比如morgan、body-parser等。

应用级中间件示例

下面的示例使用应用级中间件来验证用户身份：

const express = require('express');
const app = express();

// 用户身份验证中间件
const authMiddleware = (req, res, next) => {
  const isAuthenticated = false; // 假设从某种方式获取用户认证状态
  if (!isAuthenticated) {
    return res.status(403).send('无访问权限');
  }
  next(); // 通过认证，继续处理请求
};

// 使用中间件保护路由
app.use('/protected', authMiddleware);

app.get('/protected', (req, res) => {
  res.send('这是一个保护路由');
});

// 启动服务器
app.listen(3000, () => {
  console.log('服务器正在运行在 http://localhost:3000');
});

在上面的代码中，只有通过身份验证的请求才能访问/protected路由。

错误处理中间件

此外，还可以使用中间件来处理错误。错误处理中间件的定义需要包含四个参数：

1
2
3

function(err, req, res, next) {
  // 错误处理逻辑
}

下面是一个简单的错误处理中间件示例：

app.use((err, req, res, next) => {
  console.error(err.stack);
  res.status(500).send('服务器发生错误!');
});

// 示例路由故意抛出错误
app.get('/error', (req, res) => {
  throw new Error('这是一个错误');
});