一、 中间件(Middleware)
1.特点
中间件是一个在路由处理程序之前被调用的函数。中间件函数可以访问请求和响应对象,以及应用程序请求-响应周期中的next()中间件函数。下一个中间件函数通常由一个名为next的变量表示。
中间件函数可以执行以下任务:
1、执行任何代码。
2、对请求和响应对象进行更改。
3、结束请求-响应周期。
4、调用堆栈中的下一个中间件函数。
如果当前中间件函数没有结束请求-响应周期,它必须调用next()将控制传递给下一个中间件函数。否则,请求将被挂起。
支持依赖注入的方式进行使用
2.1 应用中间件
LoggerMiddleware将被绑定到catscontroller内部定义的所有路由,除了传递给exclude()方法的三个路由。
//logger.middleware.ts
import { Injectable, NestMiddleware } from '@nestjs/common';
import { Request, Response, NextFunction } from 'express';
@Injectable()
export class LoggerMiddleware implements NestMiddleware {
use(req: Request, res: Response, next: NextFunction) {
console.log('Cross Middleware ,Request...');
next();
}
}
//app.module.ts
@Module({
imports: [KeysModule, UsersModule, DatabaseModule, LoggerModule],
controllers: [AppController],
providers: [AppService],
})
export class AppModule implements NestModule {
configure(consumer: MiddlewareConsumer) {
consumer
.apply(LoggerMiddleware)
// 从中间件中排除一些路由
//.exclude(
// { path: 'users', method: RequestMethod.GET },
// { path: 'users', method: RequestMethod.POST },
// 'users/(.*)',
//)
// .forRoutes('users');
// .forRoutes({ path: 'users', method: RequestMethod.GET });
.forRoutes(UsersController);
}
}
测试结果:
二、异常过滤器(Exception filters)
1.特点
Nest有一个内置的异常层,负责处理整个应用程序中所有未处理的异常。当应用程序代码没有处理异常时,该层将捕获异常,然后自动发送适当的用户友好响应。
当异常无法识别时(既不是HttpException也不是继承自HttpException的类),内置异常过滤器会生成以下默认JSON响应:
{
"statusCode": 500,
"message": "Internal server error"
}
相关的HTTP 状态码,可以参考https://seo.juziseo.com/doc/http_code/
2.1 抛出标准的异常
@Get()
findAll() {
// return this.keysService.findAll();
throw new HttpException('Forbideden', HttpStatus.FORBIDDEN);
}
2.2 自定义异常
//forbidden.exception.ts
export class ForBiddenException extends HttpException {
constructor() {
super('Forbidden', HttpStatus.UNAUTHORIZED);
}
}
//keys.controller.ts
@Get()
findAll() {
// return this.keysService.findAll();
// throw new HttpException('Forbideden', HttpStatus.FORBIDDEN);
throw new ForBiddenException();
}
2.3 Http内置的Http异常
BadRequestException
- 客户端发送了一个服务器无法理解的请求。
UnauthorizedException
- 客户端需要进行身份验证才能访问请求的资源。
NotFoundException
- 服务器找不到请求的资源。
ForbiddenException
- 客户端没有权限访问请求的资源。
NotAcceptableException
- 服务器无法根据请求的内容特性完成请求。
RequestTimeoutException
- 客户端请求超时。
ConflictException
- 表示请求与服务器当前状态冲突。
GoneException
- 表示请求的资源不再可用。
HttpVersionNotSupportedException
- 表示服务器不支持请求中使用的 HTTP 版本
PayloadTooLargeException
- 表示请求的负载过大,服务器无法处理。
UnsupportedMediaTypeException
- 表示服务器不支持请求中的媒体类型。
UnprocessableEntityException
- 表示服务器无法处理请求的实体。
InternalServerErrorException
- 表示服务器遇到了意外的情况,无法完成请求。
NotImplementedException
- 表示服务器不支持请求中要求的功能。
ImATeapotException
- 表示服务器是一个茶壶,不支持被要求的操作。
MethodNotAllowedException
- 表示服务器不支持请求中指定的方法。
BadGatewayException
- 表示服务器作为网关或代理时从上游服务器接收到无效响应。
ServiceUnavailableException
- 表示服务器暂时无法处理请求。
GatewayTimeoutException
- 表示服务器作为网关或代理时无法从上游服务器获取响应,超时了。
PreconditionFailedException
- 表示请求头中指定的条件不满足。