Skip to content

Nest 内置了很多装饰器,大多数功能都是通过装饰器来使用的。

但当这些装饰器都不满足需求的时候,能不能自己开发呢?

装饰器比较多的时候,能不能把多个装饰器合并成一个呢?

自然是可以的。

很多内置装饰器我们都可以自己实现。

我们来试试看:

nest new custom-decorator -p npm

创建个 nest 项目。

执行

nest g decorator aaa --flat

创建个 decorator。

这个装饰器就是自定义的装饰器。

之前我们是这样用的 @SetMetadata

然后加个 Guard 取出来做一些判断:

nest g guard aaa --flat --no-spec

guard 里使用 reflector 来取 metadata:

javascript
import { CanActivate, ExecutionContext, Inject, Injectable } from '@nestjs/common';
import { Reflector } from '@nestjs/core';
import { Observable } from 'rxjs';

@Injectable()
export class AaaGuard implements CanActivate {
  @Inject(Reflector)
  private reflector: Reflector;

  canActivate(
    context: ExecutionContext,
  ): boolean | Promise<boolean> | Observable<boolean> {

    console.log(this.reflector.get('aaa', context.getHandler()));

    return true;
  }
}

加到路由上:

把服务跑起来:

npm run start:dev

然后访问 http://localhost:3000 可以看到打印的 metadata

但是不同 metadata 有不同的业务场景,有的是用于权限的,有的是用于其他场景的。

但现在都用 @SetMetadata 来设置太原始了。

这时候就可以这样封装一层:

装饰器就可以简化成这样:

还有,有没有觉得现在装饰器太多了,能不能合并成一个呢?

当然也是可以的。

这样写:

javascript
import { applyDecorators, Get, UseGuards } from '@nestjs/common';
import { Aaa } from './aaa.decorator';
import { AaaGuard } from './aaa.guard';

export function Bbb(path, role) {
  return applyDecorators(
    Get(path),
    Aaa(role),
    UseGuards(AaaGuard)
  )
}

在自定义装饰器里通过 applyDecorators 调用其他装饰器。

这三个 handler 的装饰器都是一样的效果。

这就是自定义方法装饰器。

此外,也可以自定义参数装饰器:

javascript
import { createParamDecorator, ExecutionContext } from '@nestjs/common';

export const Ccc = createParamDecorator(
  (data: string, ctx: ExecutionContext) => {
    return 'ccc';
  },
);

先用用看:

大家猜这个 c 参数的值是啥?

没错,就是 ccc,也就是说参数装饰器的返回值就是参数的值。

回过头来看看这个装饰器:

data 很明显就是传入的参数,而 ExecutionContext 前面用过,可以取出 request、response 对象。

这样那些内置的 @Param、@Query、@Ip、@Headers 等装饰器,我们是不是能自己实现了呢?

我们来试试看:

javascript
import { createParamDecorator, ExecutionContext } from '@nestjs/common';
import { Request } from 'express';

export const MyHeaders = createParamDecorator(
  (key: string, ctx: ExecutionContext) => {
    const request: Request = ctx.switchToHttp().getRequest();
    return key ? request.headers[key.toLowerCase()] : request.headers;
  },
);

通过 ExecutionContext 取出 request 对象,然后调用 getHeader 方法取到 key 对应的请求头返回。

效果如下:

分别通过内置的 @Headers 装饰器和我们自己实现的 @MyHeaders 装饰器来取请求头,结果是一样的。

再来实现下 @Query 装饰器:

javascript
export const MyQuery = createParamDecorator(
    (key: string, ctx: ExecutionContext) => {
        const request: Request = ctx.switchToHttp().getRequest();
        return request.query[key];
    },
);

用一下试试看:

和内置的 Query 用起来一毛一样!

同理,其他内置参数装饰器我们也能自己实现。

而且这些装饰器和内置装饰器一样,可以使用 Pipe 做参数验证和转换:

知道了如何自定义方法和参数的装饰器,那 class 的装饰器呢?

其实这个和方法装饰器的定义方式一样:

比如单个装饰器:

可以看到自定义装饰器生效了:

也可以通过 applyDecorators 组合多个装饰器:

在 guard 里加一条打印:

浏览器访问下:

可以看到 metadata 也设置成功了:

案例代码在小册仓库

总结

内置装饰器不够用的时候,或者想把多个装饰器合并成一个的时候,都可以自定义装饰器。

方法的装饰器就是传入参数,调用下别的装饰器就好了,比如对 @SetMetadata 的封装。

如果组合多个方法装饰器,可以使用 applyDecorators api。

class 装饰器和方法装饰器一样。

还可以通过 createParamDecorator 来创建参数装饰器,它能拿到 ExecutionContext,进而拿到 reqeust、response,可以实现很多内置装饰器的功能,比如 @Query、@Headers 等装饰器。

通过自定义方法和参数的装饰器,可以让 Nest 代码更加的灵活。