TypeScript Nest.js中的拦截器（Interceptor） vs 中间件（Middleware） vs 过滤器（Filter）有何区别

在本文中，我们将介绍Nest.js中拦截器、中间件和过滤器的概念、应用场景以及它们的区别。

什么是拦截器（Interceptor）？

拦截器是Nest.js框架中的一个概念，用于在请求处理的前后进行处理。拦截器通过实现NestInterceptor接口并使用@Injectable()注解进行装饰，可以对请求、响应甚至异常进行处理。

拦截器的主要功能是在方法的执行前、执行后或抛出异常时进行操作。例如，我们可以在执行某个方法前打印日志或对返回结果进行处理等。

以下是一个使用拦截器的示例：

@Injectable()
export class LoggingInterceptor implements NestInterceptor {
  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
    console.log('Before...');
    const now = Date.now();

    return next
      .handle()
      .pipe(
        tap(() => console.log(`After... ${Date.now() - now}ms`)),
      );
  }
}

在这个例子中，LoggingInterceptor通过实现NestInterceptor接口，重写intercept方法来拦截请求。intercept方法接收两个参数，context代表请求的上下文对象，next代表执行下一个拦截器或处理程序的回调方法。我们可以在intercept方法中实现我们想要的操作，例如在执行前打印日志，并在执行后计算执行时间。

什么是中间件（Middleware）？

中间件是Nest.js框架中常见的一种概念，用于在请求处理过程中进行干预和处理。中间件可以被应用于全局并作用于所有路由处理程序，也可以单独应用于特定的路由处理程序。

中间件函数的签名与Express中间件非常相似，它接收三个参数：req代表请求对象，res代表响应对象，next代表执行下一个中间件或处理程序的回调方法。

以下是一个使用中间件的示例：

@Injectable()
export class LoggerMiddleware implements MiddlewareInterface {
  use(req: Request, res: Response, next: NextFunction): void {
    console.log('Request...');
    next();
  }
}

在这个例子中，LoggerMiddleware实现了MiddlewareInterface接口，并重写了use方法。在use方法中，我们可以实现我们想要的操作，例如记录请求信息。使用时，我们可以将中间件应用于整个应用程序或特定的路由处理程序。

什么是过滤器（Filter）？

过滤器是Nest.js框架中的一个概念，用于处理异常。和拦截器类似，过滤器也通过实现相应的接口并使用@Catch()和@Injectable()注解进行装饰来进行使用。

过滤器的主要功能是捕获和处理应用程序中的异常。我们可以根据不同的异常类型定义不同的过滤器，以满足特定的业务需求。

以下是一个使用过滤器的示例：

@Catch(HttpException)
export class HttpExceptionFilter implements ExceptionFilter<HttpException> {
  catch(exception: HttpException, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    const response = ctx.getResponse();
    const request = ctx.getRequest();

    const status = exception.getStatus();
    response
      .status(status)
      .json({
        statusCode: status,
        timestamp: new Date().toISOString(),
        path: request.url,
      });
  }
}

在这个例子中，HttpExceptionFilter捕获了HttpException类型的异常，并对异常进行处理。在catch方法中，我们可以根据需要对异常进行处理，并返回自定义的响应。

拦截器 vs 中间件 vs 过滤器 – 区别对比

虽然拦截器、中间件和过滤器都可以在请求处理过程中起到干预和处理的作用，但它们之间有一些明显的区别。

使用场景：拦截器主要用于在执行某个方法前、执行后或抛出异常时进行操作，比如记录日志、修改返回结果等。中间件主要用于在请求处理过程中进行干预和处理，比如验证身份、请求记录等。过滤器主要用于捕获和处理应用程序中的异常，比如将异常转化为可读的格式返回给客户端。
作用范围：拦截器可以被应用于控制器（Controller）和处理程序（Provider），且可以根据不同的模块进行全局应用；中间件可以被应用于全局、控制器或特定的路由处理程序；过滤器作用于特定的异常类型。
执行顺序：拦截器和中间件都可以定义多个并按照顺序执行，而过滤器通常只会捕获匹配的第一个异常。

根据具体的业务需求，我们可以选择使用拦截器、中间件或过滤器来实现我们想要的效果。在使用时，我们需要根据具体的场景和需求综合考虑它们的区别。