2. Módulos (@Module): Encapsulamiento de Dominios, imports, providers, controllers y exports
Organiza tu aplicación en módulos de dominio cohesivos, comparte servicios entre módulos y comprende los módulos globales (@Global).
El Grafo Modular de NestJS
Toda aplicación NestJS tiene al menos un módulo raíz (AppModule), pero en proyectos reales jamás registramos todos los controladores y servicios allí. En su lugar, dividimos el sistema en Módulos de Dominio (Feature Modules) como CursosModule, EstudiantesModule y PagosModule.
Diagrama 2.1: Encapsulamiento en @Module, enrutamiento en @Controller e inyección IoC en @Injectable.
Las 4 Propiedades del Decorador @Module()
| Propiedad | Propósito en el Contenedor de NestJS |
|---|---|
providers |
Servicios, repositorios o fábricas instanciados por el inyector de Nest y compartidos dentro de este módulo. |
controllers |
Conjunto de controladores HTTP definidos en este módulo que deben ser instanciados para escuchar rutas. |
imports |
Lista de otros módulos cuyos proveedores exportados son necesarios dentro de este módulo. |
exports |
Subconjunto de providers de este módulo que se hacen públicos para cualquier otro módulo que lo importe. |
nest g resource cursos para generar de un solo golpe el módulo, controlador, servicio y carpeta de DTOs/Entidades.
⚡ Encapsulamiento y Exportación de Servicios entre Módulos
Definición de CursosModule exportando CursosService para que MatriculasModule pueda reutilizarlo:
import { Module } from '@nestjs/common';
import { CursosController } from './cursos.controller';
import { CursosService } from './cursos.service';
@Module({
imports: [],
controllers: [CursosController],
providers: [CursosService],
// En NestJS los providers son privados al módulo por defecto.
// Al incluir CursosService en exports, otros módulos que importen CursosModule podrán inyectarlo:
exports: [CursosService],
})
export class CursosModule {}
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lecciónSi el módulo MatriculasModule necesita inyectar y usar CursosService (que pertenece a CursosModule), ¿qué configuración es obligatoria en NestJS?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar NestJS Framework Profesional y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.