Dynamic Module

动态模块的使用场景：对于静态模块绑定，消费模块通常不能对宿主模块中定义的provider进行配置。但是有时我们需要根据不同的使用场景来获得不同的结果。这个很像插件的概念，一个通用的工具，通常需要消费者进行一定配置才能使用。例如：配置模块的使用，根据不同的运行环境，通过对配置模块进行配置，实现多环境的使用，比如数据库的连接。

以ConfigModule为例，来看看如何定义一个动态模块。

通常，我们会从根目录下的.env文件中获取配置，但是有时我们会把这个文件放在根目录下的config文件中，所以要实现的功能是能够自定义env文件的访问目录。
- configModule是一个class，包含一个静态方法，通常我们命名为register或forRoot
- register方法接受参数，这个例子中是env文件的路径。
- 动态模块通常是被import的，所以regiser方法必须返回一个module。
- 一个静态模块通常包含：imports，controllers，providers和exports这几个属性，动态模块返回的模块中这几个属性是可选的，但是必须包含一个module属性,这个属性必须和定义的动态模块的name相同。
@Module()装饰器传入参数的import属性，不仅可以是一个module的name（静态模块的使用），还可以是一个返回动态模块的函数调用（动态模块的使用）。

动态模块自己也可以引入其他模块。在register返回值中的import属性中可引入其他的module。

  import {DynamicModule, Module} from '@nestjs/common'
  import ConfigService from './config.service.ts'

  @Module({})
  export class ConfigModule {
    static register():DynamicModule {
      return {
        module: ConfigModule,
        // imports: [], // 如果依赖其他模块，可以在这里引入。
        providers: [ConfigService],
        exports: [ConfigService]
      }
    }
  }

动态模块真正提供通用逻辑的是其中的可注入的service，就像我们通常定义的模块一样，定义一个service，作为provider导出去。

那么，为了实现根据参数定制化逻辑，register方法接受option参数，那么如何把option传给service呢？

使用依赖注入，我们把option参数作为一个provider，绑定到Nest IoC容器，Nest把它注入到ConfigService中。回顾一下自定义provider中，可以使用多种方法，来定义不同数据类型的provider。

  import {DynamicModule, Module} from '@nestjs/common'
  import ConfigService from './config.service.ts'

  @Module({})
  export class ConfigModule {
    static register(options: Record<string, any>):DynamicModule {
      return {
        module: ConfigModule,
        // imports: [], // 如果依赖其他模块，可以在这里引入。
        providers: [
          {
            provide: 'CONFIG_OPTIONS',
            useValue: options
          },
          ConfigService
        ],
        exports: [ConfigService]
      }
    }
  }

这样，我们就可以通过CONFIG_OPITONS这个token，使用@Inject()装饰器把option注入到Config Service中。

  @Injectable()
  export class ConfigService {
    constructor(@Inject('CONFIG_OPTIONS') private options: Record<string, any>){}
  }

我们在使用nest时，会经常碰到register、forRoot、forFeature这些方法，nest给这些方法设定了一些使用场景，但并不是强制的。

register,你想传递不同的配置参数来设置动态模块，每次使用，都是调用这个方法。例如@nestjs/axios: HttpModule.register({baseUrl: 'someUrl}),在另一个模块中这样使用HttpModule.register({baseUrl: 'somewhere else'})。你可以在任何你想用的模块中调用这个方法。
forRoot，你只想设置一次动态模块，然后在不同的位置使用这个模块。例如：GraphQLModule.forRoot(),TypeOrmModule.forRoot()等，在应用中，只会有一个。
forFeature, 你想使用动态模块forRoot的配置，但是需要修改一些参数来指定模块的需求。例如：这个模块使用哪个repository；日志模块应该使用哪个上下文。

上面三个方法都有对应的async方法，手写异步方法会比较复杂，nest提供了ConfigurableModuleBuilder来实现异步动态模块的定义。