controllers → 이 module의 controller(요청 핸들러)
providers → 여기서 정의되고 인스턴스화되는 provider/service (DI용)
imports → 이 module이 사용할 수 있는, EXPORT된 provider를 가진 다른 module
exports → 이 module의 provider 중 import하는 module과 공유하는 부분 집합
Module은 DI scope를 형성합니다: provider는 자신의 module 내에서 사용 가능하며, export되었고(그리고 다른 module이 그것을 import할 때만) 다른 module에서 사용 가능합니다.
@Module({
imports: [UsersModule, AuthModule, DatabaseModule], // 기능 module 조합
})
export class AppModule {} // 루트 — 앱을 시작하기 위해 부트스트랩됨
모든 앱에는 기능 module을 import하여 전체 애플리케이션을 구성하는 루트 AppModule이 있습니다.
src/
app.module.ts (루트 — 기능 module을 import)
users/
users.module.ts (users controller + service 그룹화)
users.controller.ts
users.service.ts
auth/
auth.module.ts
database/
database.module.ts (공유 인프라)
관례는 기능/도메인당 하나의 module(users, auth, products)로, 관련 코드를 함께 두고 의존성을 명시적으로 만듭니다.
// UsersModule이 UsersService를 export...
@Module({ providers: [UsersService], exports: [UsersService] })
export class UsersModule {}
// ...그래서 AuthModule이 UsersModule을 import하여 사용 가능
@Module({ imports: [UsersModule] }) // 이제 AuthModule이 UsersService를 주입 가능
export class AuthModule {}
다른 module의 provider를 사용하려면 제공하는 module이 그것을 export해야 하고 소비하는 module이 제공하는 module을 import해야 합니다 — 의존성이 명시적이 됩니다.
Module은 모든 NestJS 애플리케이션의 조직적 근간입니다 — 관련 controller와 provider를 응집된 기능 단위로 그룹화하고 dependency-injection 경계를 정의합니다.
네 가지 속성(controllers, providers, imports, exports)과 특히 module 간 provider 공유를 위한 import/export 메커니즘을 이해하는 것이 필수적입니다: 이것이 NestJS가 각 기능이 자기완결적이고 의존성이 명시적인, 모듈식의 느슨하게 결합된 아키텍처를 달성하는 방법입니다.
기능 기반 module 구조(도메인당 하나의 module)는 확장성과 유지보수성을 위해 Nest 앱을 구성하는 표준 방식입니다.
Module은 controller, provider와 함께 NestJS의 핵심 아키텍처를 형성하므로 기본 지식이 됩니다 — 앱을 module로 구조화하고 import/export를 통해 module 간 provider를 연결하는 방법을 숙달하는 것은 사소하지 않은 모든 NestJS 애플리케이션을 구축하는 데 필요하며 초반에 잘 이해해 둘 가치가 있는 흔한 혼동 지점입니다.