其中 service、controller 很好理解。（学过后端的都知道，不赘述）

那么 provider 是 nestjs 的一个新概念。
它可以通过 provider 对一些可复用的功能代码如：service、controller、pipe、middleware、guard 等等进行复用，那么通过 provider 对功能代码进行注册后其子模块（module）即可使用这些功能代码。

关于 imports

但是你还是得通过 import 去声明后才能直接使用（好听点就是让代码更直观，难听点就是个坑，明明子模块都能用了，凭什么还要我再引入一次？？？）。

PS ：需要注意一点的是 class-validator 的验证过程是一直验证下去，即使发生异常也不会停下来，所以返回的异常信息至少>=1。尽管官方 issues 区有多人反馈，还是未能解决这个问题（吐了）。所以你需要自行在 pipe 中控制只返回一个 message 即可。（如果你想让你的返回体结构统一的话就这么做）

个人觉得和 koa2 的中间件（middleware）相比，由于 koa2 自身有 “洋葱模型” 中间件来回都会调用，而 express 却是单向的，那我觉得 filter 是弥补 express 的中间件不能往回调用的填坑操作。

如何设置路由全局前缀（prefix）?

如何做类型判断？以及优雅的类型转换？

貌似 class-validator 不能做到遇到一个 Error 就停止校验，而是一直执行下去

dto 的类型设置好像没有对 request 有限制？

嵌套的 dto 该怎么写？

常用的标注信息：

1，给 controller 打 tag（标签），即对接口进行分类。

在 controller 类 上加 @ApiTags(“你的标签”)

2，给 api 接口添加说明

在 controller 的方法上 @ApiOperation({ summary: “这个 api 是干嘛的？” })

3，给接口添加默认参数

Query

@ApiQuery({ name: "id", description: "接口描述", example: "你的默认值" }) // 注意 example 是 any 类型

Param （即路由参数如：user/{id}）

@ApiParam({ name: "id", description: "id 路由", example: 1 })

Body

  @ApiBody({
    schema: {
      example: {
        account: "JJLao",
        password: "123456"
  })

Header 注意：如果在同一个 header 下使用 @ApiSecurity() 的优先级比 @ApiHeader() 要高

// 注意：这里不可以直接使用 defalut 而是通过 schema 的方式区设置默认值（貌似官方不管了）
@ApiHeader({ name: "token", description: "令牌", schema: { default: 12580 } })

如何自动带鉴权 token ? （有坑，但问题不大）

在 main.ts 配置

// swagger 相关配置
  const docOptions = new DocumentBuilder()
    .setTitle("Nest practise")
    .setDescription("Nest.js 练习用 api")
    .setVersion("1.0")
    // 关键点在这里。 第一个 token 是标题，第二个 token 是 header 的 key
    .addSecurity("token", { type: "apiKey", name: "token", in: "header" })
    .build();
  const document = SwaggerModule.createDocument(app, docOptions);
  SwaggerModule.setup("api-docs", app, document);

然后就需要在各个 controller 的类上添加

@ApiSecurity("token")

即可，代表该 controller 自动添加 token 。（吐了吐了，官方也不管了，虽然问题不大，但是少了点灵活性。）