Bir modül, @Module() dekoratörü ile dekorasyon edilmiş bir sınıftır ve ilgili bileşenleri — kontrolörleri, sağlayıcıları/servisleri — tutarlı bir birim halinde gruplandırır. Modüller, NestJS'in bir uygulamayı özelliklere göre nasıl organize ettiğidir ve her Nest uygulamasının en az bir kök AppModule'ü vardır.
import { Module } from "@nestjs/common";
({
controllers: [UsersController], // controllers belonging to this module
providers: [UsersService], // providers (services) this module creates
imports: [DatabaseModule], // OTHER modules whose exports this module needs
exports: [UsersService], // what this module makes available to importers
})
export class UsersModule {}
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
Modüller bir DI kapsamı oluştururlar: bir sağlayıcı kendi modülü içinde mevcuttur ve diğer modüllerde yalnızca export edilirse (ve diğer modül bunu import ederse) kullanılabilir.
@Module({
imports: [UsersModule, AuthModule, DatabaseModule], // compose feature modules
})
export class AppModule {} // the root — bootstrapped to start the app
Her uygulamanın, feature modüllerini import eden ve tüm uygulamayı oluşturan bir kök AppModule'ü vardır.
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)
Konvansiyonel yöntem feature/domain başına bir modül (kullanıcılar, kimlik doğrulama, ürünler) olması ve ilgili kodu bir arada tutmak ve bağımlılıkları açık yapmaktır.
// 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 {}
Başka bir modülden bir sağlayıcı kullanmak için, sağlayan modülün bunu export etmesi ve tüketen modülün sağlayan modülü import etmesi gerekir — bu sayede bağımlılıklar açık hale gelir.
Modüller, her NestJS uygulamasının organizasyon omurgasıdır — ilgili kontrolörleri ve sağlayıcıları tutarlı feature birimleri halinde gruplandırırlar ve dependency-injection sınırlarını tanımlarlar.
Dört özelliği (controllers, providers, imports, exports) anlamak ve özellikle modüller arasında sağlayıcıları paylaşmak için import/export mekanizmasını anlamak gereklidir: bu, NestJS'in modüler, gevşek bağlı mimariye ulaştığı yoldur; burada her feature bağımsızdır ve bağımlılıklar açıktır.
Feature tabanlı modül yapısı (domain başına bir modül), Nest uygulamalarını ölçeklenebilirlik ve bakım kolaylığı açısından organize etmenin standart yoludur.
Modüller, kontrolörler ve sağlayıcılar ile birlikte NestJS'in temel mimarisini oluştururlar ve bu nedenle temel bilgisini kapsamaktadırlar — bir uygulamayı modüllere nasıl yapılandıracağını ve sağlayıcıları import/export üzerinden modüller arasında nasıl bağlayacağını anlamak, herhangi bir karmaşık NestJS uygulaması oluşturmak için gereklidir ve sık karışıklık yaşanan, erken öğrenilmesi gereken bir konudur.