Modulele dinamice sunt module care pot fi configurate atunci când sunt importate — în loc de un @Module({...}) static, ele expun metode statice (numite convenţional forRoot şi ) care returnează un modul configurat cu argumentele pe care le transmiţi. Acesta este modul în care modulele configurabile şi reutilizabile (config, bază de date, JWT) acceptă opţiuni.
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 {}
Apelurile .forRoot()/.register()/.forFeature() pe care le vezi atunci când importezi module sunt metode de module dinamice care acceptă configurare.
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)
Convenţia: forRoot pentru configurarea globală/unică; forFeature pentru înregistrare per-feature pe care o apelezi în mai multe module.
@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 statică returnează un obiect DynamicModule (modul + furnizori + exporturi), conectând opţiunile transmise în furnizorii modulului (adesea printr-un token de injecţie).
// configure using OTHER injected dependencies (e.g. ConfigService) — async/factory
StorageModule.forRootAsync({
useFactory: (config: ConfigService) => ({ bucket: config.get("BUCKET") }),
inject: [ConfigService],
});
Varianta forRootAsync permite ca configurarea să depindă de alţi furnizori (cum ar fi ConfigService) — esenţial atunci când opţiunile provin din configurare validată.
Modulele dinamice şi modelul forRoot/forFeature sunt un concept important NestJS pentru construirea modulelor configurabile şi reutilizabile — şi înţelegerea lor este valoroasă atât pentru utilizarea ecosistemului, cât şi pentru construirea modulelor partajate.
Practiv fiecare modul major NestJS (ConfigModule, TypeOrmModule, JwtModule, BullModule, CacheModule) este un modul dinamic configurat prin .forRoot()/.register()/.forFeature(), deci recunoaşterea acestor apeluri (transmiterea configurării unui modul la timpul importării, mai degrabă decât o importare statică) demistifică modul în care întregul ecosistem este conectat.
Convenţia forRoot vs forFeature (forRoot pentru configurare globală unică, cum ar fi o conexiune la baza de date sau un secret; forFeature pentru înregistrare per-feature, cum ar fi înregistrarea entităţilor în fiecare modul) este un model pe care îl întâlneşti constant.
Pentru dezvoltatorii seniori, ştirea cum să construieşti propriile tale module dinamice (returnând un DynamicModule cu furnizori configuraţi din opţiunile transmise, adesea prin tokenuri de injecţie, cu variante asincrone pentru configurare dependentă de setup) este ceea ce te permite să creezi module reutilizabile şi configurabile — infrastructură partajată (stocare, clienţi API externi, configurare personalizată) pe care alte părţi ale unei aplicaţii sau alte proiecte le importă cu propriile lor setări.
Acesta este un subiect mai avansat, dar este fundamental pentru înţelegerea aprofundată a arhitecturii modulare NestJS şi pentru construirea de biblioteci de module profesionale şi reutilizabile, făcând din aceasta o capacitate importantă pentru arhitectarea sistemelor NestJS mari, bine structurate.