I moduli dinamici sono moduli che possono essere configurati al momento dell'importazione — invece di un @Module({...}) statico, espongono metodi statici (convenzionalmente forRoot e ) che restituiscono un modulo configurato con gli argomenti che passi. Questo è il modo in cui i moduli configurabili e riutilizzabili (config, database, JWT) accettano opzioni.
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 {}
Le chiamate .forRoot()/.register()/.forFeature() che vedi quando importi moduli sono metodi di moduli dinamici che accettano configurazione.
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)
La convenzione: forRoot per la configurazione globale/una tantum; forFeature per la registrazione per-feature che chiami in più moduli.
@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" })
Il metodo statico restituisce un oggetto DynamicModule (modulo + provider + export), collegando le opzioni passate ai provider del modulo (spesso tramite un token di iniezione).
// configure using OTHER injected dependencies (e.g. ConfigService) — async/factory
StorageModule.forRootAsync({
useFactory: (config: ConfigService) => ({ bucket: config.get("BUCKET") }),
inject: [ConfigService],
});
La variante forRootAsync consente alla configurazione di dipendere da altri provider (come ConfigService) — essenziale quando le opzioni provengono da configurazione validata.
I moduli dinamici e il pattern forRoot/forFeature sono un concetto importante di NestJS per costruire moduli configurabili e riutilizzabili — e comprenderli è prezioso sia per usare l'ecosistema che per costruire moduli condivisi.
Quasi ogni grande modulo di NestJS (ConfigModule, TypeOrmModule, JwtModule, BullModule, CacheModule) è un modulo dinamico configurato tramite .forRoot()/.register()/.forFeature(), quindi riconoscere cosa sono queste chiamate (passare la configurazione a un modulo al momento dell'importazione, piuttosto che un'importazione statica) demistifica il modo in cui tutto l'ecosistema è collegato.
La convenzione forRoot vs forFeature (forRoot per la configurazione globale una tantum come una connessione al database o un segreto; forFeature per la registrazione per-feature come registrare entità in ogni modulo) è un pattern che incontri costantemente.
Per gli sviluppatori senior, sapere come costruire i tuoi moduli dinamici (restituendo un DynamicModule con provider configurati da opzioni passate, spesso tramite token di iniezione, con varianti asincrone per setup dipendente dalla configurazione) è quello che ti consente di creare moduli riutilizzabili e configurabili — infrastruttura condivisa (storage, client API esterni, configurazione personalizzata) che altre parti di un'app o altri progetti importano con le loro impostazioni.
Questo è un argomento più avanzato, ma è fondamentale per comprendere in profondità l'architettura modulare di NestJS e per costruire librerie di moduli professionali e riutilizzabili, rendendolo una capacità importante per strutturare grandi sistemi NestJS ben organizzati.