controllers → the controllers (request handlers) in this module
providers → the providers/services defined and instantiated here (for DI)
imports → other modules whose EXPORTED providers this module can use
exports → the subset of THIS module's providers shared with importing modules
モジュールはDIスコープを形成します: プロバイダーはそのモジュール内で利用可能であり、他のモジュールからはエクスポートされた場合のみ、かつその他のモジュールがインポートした場合のみ利用可能です。
@Module({
imports: [UsersModule, AuthModule, DatabaseModule], // compose feature modules
})
export class AppModule {} // the root — bootstrapped to start the app
すべてのアプリケーションはルートAppModuleを持ち、これがフィーチャーモジュールをインポートして、アプリケーション全体を構成します。
src/
app.module.ts (root — imports feature modules)
users/
users.module.ts (groups users controller + service)
users.controller.ts
users.service.ts
auth/
auth.module.ts
database/
database.module.ts (shared infrastructure)
慣例はフィーチャー/ドメインごとに1つのモジュール(ユーザー、認証、商品)であり、関連コードを一箇所に保ち、依存関係を明示的にしています。
// UsersModule exports UsersService...
@Module({ providers: [UsersService], exports: [UsersService] })
export class UsersModule {}
// ...so AuthModule can use it by importing UsersModule
@Module({ imports: [UsersModule] }) // now AuthModule can inject UsersService
export class AuthModule {}
別のモジュールのプロバイダーを使用するには、提供側のモジュールがエクスポートする必要があり、利用側のモジュールは提供側のモジュールをインポートする必要があります — これにより依存関係が明示的になります。
モジュールはすべてのNestJSアプリケーションの組織的な中核です — 関連するコントローラーとプロバイダーを構造化されたフィーチャーユニットにグループ化し、依存性注入の境界を定義します。
4つのプロパティ(controllers、providers、imports、exports)、特にモジュール間でのプロバイダー共有のためのインポート/エクスポート機構を理解することは不可欠です: これがNestJSが各フィーチャーが自己完結し依存関係が明示的な、モジュール化された疎結合のアーキテクチャを実現する方法です。
フィーチャーベースのモジュール構造(ドメインごとに1つのモジュール)は、スケーラビリティと保守性のためのNestアプリケーションを構成する標準的な方法です。
モジュールは、コントローラーとプロバイダーと共に、NestJSのコアアーキテクチャを形成し、基本的な知識となります — アプリケーションをモジュールに構造化し、インポート/エクスポートを通じてモジュール間にプロバイダーを配線する方法を習得することは、自明ではないNestJSアプリケーションを構築するために必要であり、理解する価値のある頻出の混乱ポイントです。