说起Nestjs的异常过滤器,不能不提.Net的全局过滤器Filter,功能那是相当的强悍,用理论话说叫AOP 面向切面编程,可谓方便了太多需要异常处理的场景。说回Nestjs的异常过滤器,实现类似的功能,采用相似的处理方式,只不过一个面向C#,一个面向Nodejs,很荣幸的我,在两个框架都找到了类似的东西。
面向切面编程AOP,是一种类似于编程规范的东东,同门师兄弟有叫面向接口编程、SOLID原则等等。
Nestjs的异常处理
默认异常处理
Nestjs内置了默认的全局异常过滤器,处理能够转换成Httpexception的异常。
如果是Httpexception或其子类异常,那么会返回该异常的JSON格式:
{"exceptionCode":40005,"message":"自定义异常","path":"/"}
如果不是Httpexception或其子类异常,那么会返回:
{"statusCode":500,"message":"Internal server error"}
由于Nestjs采用了内置的默认异常处理,因此不会出现由于出现未捕获的异常导致程序崩溃。
自定义异常过滤器处理
由于内置异常处理返回值格式无法调整,因此自定义异常就显得又为正常。自定义异常可以使返回异常信息自定义,且可以增加自定义异常编码,方便客户端人员根据异常编码进行不同的展示。
如何自定义异常?
不重复造轮子是程序员的自我约束,首先我们新建我们自己的异常基类:
import { HttpException } from "@nestjs/common"; /** * 定义基础异常类 * * @export * @class BaseException * @extends {HttpException} */ export class BaseException extends HttpException { /** * Creates an instance of BaseException. * @param {number} exceptionCode 自定义异常编号 * @param {string} errorMessage 提示信息 * @param {number} statusCode 状态码 * @memberof BaseException */ constructor(public exceptionCode: number, public errorMessage: string, public statusCode: number) { super({ exceptionCode: exceptionCode, errorMessage: errorMessage }, statusCode); } /** * 获取自定义异常代码 * * @return {*} * @memberof BaseException */ getExceptionCode(): number { return this.exceptionCode; } getErrorMessage(): string { return this.errorMessage; } getStatusCode(): number { return this.statusCode; } }
然后我们新建一个未授权异常类型,其中增加了自定义异常代码:
import { HttpStatus } from "@nestjs/common"; import { BaseException } from "./base.exception"; export class UnCauhtException extends BaseException { constructor() { super(40000, "系统运行异常,请联系管理员!", HttpStatus.FORBIDDEN); } }
建立好了自定义异常,那么我们就需要处理未授权异常,首先新建自定义异常处理基类,请注意 此处我们使用的事Express:
import { ArgumentsHost, ExceptionFilter, HttpException } from "@nestjs/common"; import { HttpArgumentsHost } from "@nestjs/common/interfaces"; import { BaseException } from "src/exceptions/base.exception"; import { Response, Request } from "express"; /** * 异常基础类过滤器 * * @export * @class BaseExceptionFilter * @implements {ExceptionFilter<BaseException>} */ export abstract class BaseExceptionFilter implements ExceptionFilter<BaseException> { /** * 异常类捕获 * * @abstract * @param {BaseException} exception * @param {ArgumentsHost} host * @memberof BaseExceptionFilter */ abstract catch(exception: BaseException, host: ArgumentsHost); /** * 获取http请求上下文参数 * * @protected * @param {ArgumentsHost} host * @return {*} * @memberof BaseExceptionFilter */ protected getHttpContext(host: ArgumentsHost) { return host.switchToHttp(); } /** * 获取http 响应参数 * * @protected * @param {HttpArgumentsHost} httpContext * @return {*} * @memberof BaseExceptionFilter */ protected getResponse(httpContext: HttpArgumentsHost): Response { return httpContext.getResponse<Response>(); } /** * 获取http请求参数 * * @protected * @param {HttpArgumentsHost} httpContext * @return {*} * @memberof BaseExceptionFilter */ protected getRequest(httpContext: HttpArgumentsHost): Request { return httpContext.getRequest<Request>(); } /** * 写入异常信息到客户端 * * @param {ArgumentsHost} host * @param {BaseException} exception * @memberof BaseExceptionFilter */ protected writeToClient(host: ArgumentsHost, exception: BaseException) { const ctx = this.getHttpContext(host); if(exception instanceof BaseException){ this.getResponse(ctx).status(exception.statusCode).json({ exceptionCode: exception.getExceptionCode(), message: exception.getErrorMessage(), path: this.getRequest(ctx).url }); }else { const httpException=exception ; this.getResponse(ctx).status(500).json({ message: "未处理的异常", path: this.getRequest(ctx).url }); } } }
新建未授权异常处理:
import { ArgumentsHost, Catch } from "@nestjs/common"; import { AuthException } from "src/exceptions/auth.exception"; import { BaseException } from "src/exceptions/base.exception"; import { BaseExceptionFilter } from "./base.exception.filter"; @Catch(AuthException) export class AuthExceptionFilter extends BaseExceptionFilter { constructor(){ super(); console.log("授权异常构造函数初始化"+new Date().toISOString()); } catch(exception: AuthException, host: ArgumentsHost) { exception.exceptionCode=40002; console.log("授权异常执行"+new Date().toISOString()); this.writeToClient(host,exception); } }
针对未授权异常处理类,进行几点说明:
- 增加了Catch注解,只捕获Authexception的异常,其他类型的异常此类不进行处理
- 继承自定义异常处理类Baseexceptionfilter
应用范围
异常处理类可应用于method、controller、全局,甚至同一个Controller可以定义多个自定义异常类
import { Controller, ForbiddenException, Get, HttpException, HttpStatus, UseFilters } from '@nestjs/common'; import { AppService } from './app.service'; import { AuthException } from './exceptions/auth.exception'; import { BusinessException } from './exceptions/business.exception'; import { UnCauhtException } from './exceptions/uncauht.exception'; import { AuthExceptionFilter } from './filters/auth.exception.filter'; import { BusinessExceptionFilter } from './filters/business.exception.filter'; /** * 带有单个路由的基本控制器示例ff */ @UseFilters(AuthExceptionFilter,BusinessExceptionFilter) @Controller() export class AppController { constructor(private readonly appService: AppService) {} @Get() getHello(): string { //throw new Error("666"); throw new BusinessException("自定义异常",HttpStatus.OK); throw new AuthException(); throw new HttpException("自定义异常",HttpStatus.FORBIDDEN); return this.appService.getHello(); } @Get("name") getName():string { return "guozhiqi"; } }
几点说明:
- 我们使用Usefilters注解进行异常过滤器的添加
- 我们在Appcontroller中定义了两种不同类型的自定义异常处理类
- 也就是我们Appcontroller中抛出的异常,只要是我们定义的这两种,那么都可以被正常处理。
几点疑问
Usefitlers中我们自定义的异常处理类会初始化几次?
答案:我们通过类型注册到Appcontroller的自定义异常类只会在程序初始化的时候初始化一次。也就是说程序启动之后,每个
controller、每个method定义了哪些异常处理类都已经确定。
如果我们捕获到异常,但不进行任何处理,会发生什么?
答案:如果我们的异常处理方法什么也不做,那么恭喜你,会成功的将浏览器请求hang死,因为异常未处理,那么浏览器会一直得不到响应。
多个异常之间的处理顺序如何?
答案:如果多个异常处理均可以捕获到该异常,那么只有第一个有效,也就是说异常处理类和 中间件不同,异常处理类只能其中一个处理,而中间件需要都进行处理。
Nestjs的@Usefilters 像谁?
首先从JS角度来看,像Angular,如果往后端看,最像Spring。
Nestjs的异常处理并不复杂,复杂的是需要我们针对不同类型的异常进行处理,提取异常的共性。
参考文档:docs.nestjs.cn
RTX 5090要首发 性能要翻倍!三星展示GDDR7显存
三星在GTC上展示了专为下一代游戏GPU设计的GDDR7内存。
首次推出的GDDR7内存模块密度为16GB,每个模块容量为2GB。其速度预设为32 Gbps(PAM3),但也可以降至28 Gbps,以提高产量和初始阶段的整体性能和成本效益。
据三星表示,GDDR7内存的能效将提高20%,同时工作电压仅为1.1V,低于标准的1.2V。通过采用更新的封装材料和优化的电路设计,使得在高速运行时的发热量降低,GDDR7的热阻比GDDR6降低了70%。
更新日志
- 三国志8重制版恶名怎么消除 恶名影响与消除方法介绍
- 模拟之声慢刻CD《柏林之声5》2019[原抓WAV+CUE]
- AlexandraSoumm-Parisestunefte(2024)[24Bit-96kHz]FLAC
- 李嘉《国语转调1》[天王唱片][WAV整轨]
- 不是哥们 这都能跑?网友展示用720显卡跑《黑神话》
- 玩家自制《黑神话:悟空》亢金星君3D动画 现代妆容绝美
- 大佬的审美冲击!《GTA6》环境设计师展示最新作品
- 纪晓君.2001-野火·春风【魔岩】【WAV+CUE】
- 汪峰.2005-怒放的生命【创盟音乐】【WAV+CUE】
- 群星.1995-坠入情网【宝丽金】【WAV+CUE】
- 群星《谁杀死了Hi-Fi音乐》涂鸦精品 [WAV+CUE][1G]
- 群星1998《宝丽金最精彩98》香港首版[WAV+CUE][1G]
- 汪峰《也许我可以无视死亡》星文[WAV+CUE][1G]
- 李嘉-1991《国语转调2》[天王唱片][WAV整轨]
- 蔡琴2008《金声回忆录101》6CD[环星唱片][WAV整轨]