Moduły dynamiczne to moduły, które można konfigurować podczas importu — zamiast statycznego @Module({...}), udostępniają metody statyczne (konwencjonalnie forRoot i ), które zwracają moduł skonfigurowany z argumentami, które przekazujesz. W ten sposób konfigurowalne, wielokrotnego użytku moduły (konfiguracja, baza danych, JWT) akceptują opcje.
forFeatureA static module is fixed — but reusable modules (DatabaseModule, ConfigModule,
JwtModule) need to be CONFIGURED per app (connection URL, secret, options).
Dynamic modules let a module accept configuration at import time.
@Module({
imports: [
ConfigModule.forRoot({ isGlobal: true }), // ← forRoot with options
TypeOrmModule.forRoot({ type: "postgres", url: ... }), // ← configured at import
JwtModule.register({ secret: process.env.SECRET }), // ← register variant
TypeOrmModule.forFeature([User, Post]), // ← forFeature for specifics
],
})
export class AppModule {}
Wołania .forRoot()/.register()/.forFeature(), które widzisz podczas importowania modułów, to metody modułu dynamicznego akceptujące konfigurację.
forRoot() → configure the module ONCE, globally (the connection, the secret, core setup)
called in the root/app module a single time
forFeature() → register feature-specific pieces in each feature module that needs them
(e.g. TypeOrmModule.forFeature([User]) registers entities per module)
Konwencja: forRoot dla konfiguracji globalnej/jednorazowej; forFeature dla rejestracji per-feature, którą wywołujesz w wielu modułach.
@Module({})
export class StorageModule {
static forRoot(options: StorageOptions): DynamicModule {
return { // returns a configured module
module: StorageModule,
providers: [
{ provide: "STORAGE_OPTIONS", useValue: options }, // inject the passed options
StorageService,
],
exports: [StorageService],
global: true, // optionally make it global
};
}
}
// usage: StorageModule.forRoot({ bucket: "my-bucket", region: "us-east-1" })
Metoda statyczna zwraca obiekt DynamicModule (moduł + providery + exports), podłączając przekazane opcje do providerów modułu (często przez token iniekcji).
// configure using OTHER injected dependencies (e.g. ConfigService) — async/factory
StorageModule.forRootAsync({
useFactory: (config: ConfigService) => ({ bucket: config.get("BUCKET") }),
inject: [ConfigService],
});
Warianta forRootAsync pozwala na to, aby konfiguracja zależała od innych providerów (takich jak ConfigService) — niezbędne, gdy opcje pochodzą ze zwalidowanej konfiguracji.
Moduły dynamiczne i wzorzec forRoot/forFeature to ważna koncepcja NestJS do budowania konfigurowalnych, wielokrotnego użytku modułów — i zrozumienie ich jest cenne zarówno dla używania ekosystemu, jak i do budowania współdzielonych modułów.
Prawie każdy duży moduł NestJS (ConfigModule, TypeOrmModule, JwtModule, BullModule, CacheModule) to moduł dynamiczny konfigurowany przez .forRoot()/.register()/.forFeature(), dlatego rozpoznanie, czym są te wywołania (przekazywanie konfiguracji do modułu w momencie importu, zamiast statycznego importu), wyjaśnia, jak całe ekosystem jest połączone.
Konwencja forRoot vs forFeature (forRoot dla jednorazowej konfiguracji globalnej, takiej jak połączenie z bazą danych lub sekret; forFeature dla rejestracji per-feature, takiej jak rejestrowanie jednostek w każdym module) to wzorzec, na który natykasz się stale.
Dla starszych developerów umiejętność budowania własnych modułów dynamicznych (zwracanie DynamicModule z providerami skonfigurowanymi na podstawie przekazanych opcji, często przez tokeny iniekcji, z wariantami asynchronicznymi dla konfiguracji zależnej od setupu) to to, co pozwala na tworzenie wielokrotnego użytku, konfigurowalnych modułów — współdzielonej infrastruktury (przechowywanie, klienty zewnętrznych API, niestandardowa konfiguracja), którą inne części aplikacji lub inne projekty importują z własnymi ustawieniami.
To bardziej zaawansowany temat, ale jest fundamentalny dla głębokie zrozumienia architektury modularnej NestJS i do budowania profesjonalnych, wielokrotnego użytku bibliotek modułów, co czyni go ważną umiejętnością do architektowania dużych, dobrze zorganizowanych systemów NestJS.