Dinamični moduli so moduli, ki se konfigurirajo ob navozu — namesto statičnega @Module({...}) izpostavljajo statične metode (po dogovoru forRoot in forFeature), ki vrnejo modul konfiguriran z argumenti, ki jih proslijedite. To je način, kako nastavljivi, ponovno uporabni moduli (config, baza podatkov, JWT) sprejmejo možnosti.
A 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 {}
Klici .forRoot()/.register()/.forFeature(), ki jih vidite pri navozu modulov, so dinamične metode modulov, ki sprejemajo konfiguracijo.
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)
Dogovor: forRoot za globalno/enotno konfiguracijo; forFeature za registracijo po funkciji, ki jo pokličete v več modulih.
@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" })
Statična metoda vrne objekt DynamicModule (modul + ponudniki + izvozi) in preslika prejete možnosti v ponudnike modula (pogosto prek žetona za vbrizgavanje).
// configure using OTHER injected dependencies (e.g. ConfigService) — async/factory
StorageModule.forRootAsync({
useFactory: (config: ConfigService) => ({ bucket: config.get("BUCKET") }),
inject: [ConfigService],
});
Varianta forRootAsync omogoča, da je konfiguracija odvisna od drugih ponudnikov (kot je ConfigService) — bistveno, ko možnosti prihajajo iz validirane konfiguracije.
Dinamični moduli in vzorec forRoot/forFeature so pomemben koncept NestJS za gradnjo nastavljivi, ponovno uporabnih modulov — in njihovo razumevanje je dragoceno tako za uporabo ekosistema kot za gradnjo skupnih modulov.
Skoraj vsak glavni modul NestJS (ConfigModule, TypeOrmModule, JwtModule, BullModule, CacheModule) je dinamični modul, konfiguriran prek .forRoot()/.register()/.forFeature(), zato prepoznavanje, kaj so ti klici (prepustitev konfiguracije modulu ob času navozu namesto statičnega navozu), pojasni, kako je celoten ekosistem povezan.
Dogovor forRoot vs forFeature (forRoot za enotno globalno nastavitev, kot je povezava s podatkovno bazo ali skrivnost; forFeature za registracijo po funkciji, kot je registracija entitet v vsakem modulu) je vzorec, s katerim se soočate nenehno.
Za starejše programerje je znanje, kako graditi lastne dinamične module (vrnitev DynamicModule s ponudniki, konfiguriranimi iz prejenih možnosti, pogosto prek žetonov za vbrizgavanje, z asinkrenim variantami za nastavitve, odvisne od konfiguracije), tisto, kar vam omogoča ustvarjanje ponovno uporabnih, nastavljivi modulov — skupne infrastrukture (shramba, zunanji API odjemalci, posebna konfiguracija), ki jo drugi deli aplikacije ali drugi progetti navoze z lastnimi nastavitvami.
To je naprednejša tema, vendar je temeljna za globoko razumevanje modularnih arhitektur NestJS in za gradnjo profesionalnih, ponovno uporabnih knjižnic modulov, kar je fazer zahtevane sposobnosti za arhitekturiranje velikih, dobro strukturiranih sistemov NestJS.