前言
顾名思义,拦截器可以在执行应用程序之前或之后插入额外的逻辑,拦截器是AOP
编程思想的体现,它可以做以下事情:
- 在方法执行之前/之后绑定额外的逻辑
- 转换函数返回的结果
- 转换函数抛出的异常
- 扩展基本功能行为
- 根据特定条件完全覆盖函数(例如,出于缓存目的)
Nest
中的拦截器
在Nest
中,拦截器需要实现NestInterceptor
类的intercept
方法,它接受两个参数,一个是拦截器执行上下文ExecutionContext
,它里面添加了一些方法用于获取更多关于拦截器的详细信息,如获取当前是由哪个类
或者方法
调用拦截器;第二个参数是CallHandler
,也叫应用处理程序,例如在controller
中的路由处理方法findOne
,我们来验证一下上面两点:
这里我自定义一个耗时统计拦截器(后面再讲),用于拦截PersonController
这个控制器,它会拦截这里的所有方法,通过ExecutionContext
获取拦截器装饰的类
或方法
:
而TimeoutInterceptor
里面会统计方法耗时并且打印是哪个路由方法触发了拦截器
在前端先后发送两个请求调用接口
来看看结果
当然,我们也可以知道是哪个类绑定了拦截器,通过getClass
方法获取
所以,由此我们可以知道拦截器可以绑定一个控制器作用域、方法作用域,其实还有一个就是全局作用域,即在全局绑定的拦截器,是应用到所有的路由方法中,比如全局绑定响应拦截器,那么就可以统一返回前端的数据结构:
自定义拦截器
这里我们自定义了一个统计方法耗时的拦截器
从上面的自定义拦截器中,我们可以看到通过返回next.handle()
可以让路由处理方法可以继续执行,同时这里涉及到一系列方式对数据进行操作,如tap
、timeout
、map
、filter
等,它们来自Rxjs
库。
Rxjs
是一个组织异步的库,它里面有很多操作方法,使用它可以很方便来操作一些逻辑,角色譬如lodash
。
有人会说,这些方法自己都可以实现啦,的确是的,但是不得不说Rxjs
里面提供了太多的方法,用的越多效率越高。
那这样会不会提高心智负担呢?答案是基本上不会,因为实际上常用到的方法也就那么几个,如tap
、map
、timeout
、catchError
、filter
这几个。
总结
拦截器需要实现NestInterceptor
类的intercept
方法,而在Nest
中,可以便利的使用Rxjs
里面的操作方法来实现自定义拦截器功能。
拦截器是有控制范围的,它可以在控制器作用域、方法作用域和全局作用域中使用拦截器,控制器作用域只能控制某个拦截器里面的路由处理函数,而全局拦截器可以拦截所有控制器的路由处理函数,例如异常拦截器 或响应拦截器会挂在全局进行统一控制。