NestJS'de dependency injection nasıl çalışır?

Question

Accepted Answer

**Dependency Injection (DI)**, çerçevenin bir sınıfın ihtiyaç duyduğu bağımlılıkları **otomatik olarak oluşturup sağladığı** NestJS'nin temel desenidir; sınıf bunları kendisi oluşturmak yerine, yapıcıya (constructor) ne gerektiğini belirtir ve NestJS onu sağlar — sonuç olarak gevşek bağlı, test edilebilir kod elde ederiz.

## Nasıl çalışır: yapıcıya (constructor) bildirin

```ts
@Injectable()
export class UsersService {
  // declare dependencies as constructor parameters — Nest injects them
  constructor(
    private readonly db: DatabaseService,
    private readonly logger: LoggerService,
  ) {}
  // you NEVER write `new DatabaseService()` — Nest creates and provides it
}
```

Nest, yapıcının parametre türlerini okur, ilgili kayıtlı provider'ları arar, bunları oluşturur (henüz oluşturulmadıysa) ve iletir — tüm bağımlılık grafiğini otomatik olarak çözer.

## DI akışı

```text
1. A class is marked @Injectable() → it's a provider
2. The provider is registered in a module's `providers` array
3. Another class declares it as a constructor parameter
4. NestJS's IoC container resolves and INJECTS the instance automatically
```

## Kayıt ve çözümleme

```ts
@Module({
  providers: [UsersService, DatabaseService, LoggerService],  // register all providers
  controllers: [UsersController],
})
export class UsersModule {}
// Nest's container now knows how to construct each and inject them where needed
```

## DI neden değerlidir

```text
✓ Loose coupling — classes depend on ABSTRACTIONS, not on constructing concrete deps
✓ Testability — inject MOCK dependencies in tests easily (no real DB needed)
✓ Reusability — one shared instance (singleton) used across the app
✓ Maintainability — change an implementation in one place (the module registration)
```

## Test edilebilirlik — esas fayda

```ts
// in a test, provide a fake DatabaseService — no real database required
const module = await Test.createTestingModule({
  providers: [
    UsersService,
    { provide: DatabaseService, useValue: mockDatabase },  // inject a mock
  ],
}).compile();
```

Sınıf bağımlılıklarını oluşturmadığı için, test sırasında mock'ları yerine koyabilirsiniz — DI, NestJS uygulamalarını son derece test edilebilir hale getirir.

## Sınıf dışı değerleri enjekte etmek

```ts
// use injection tokens for config/values, not just classes
constructor(@Inject("CONFIG") private config: AppConfig) {}
```

## Neden önemli

Dependency injection, NestJS'nin tüm mimarisinin altında yatan temel desendir — controller'ların nasıl servis aldığı, servislerin repository'leri ve diğer servisleri nasıl aldığı, ve tüm uygulamanın nasıl birbirine bağlandığıdır.

Bunu anlamak gereklidir çünkü neredeyse her NestJS sınıfı DI'a katılır: yapıcıya bağımlılıkları bildirirsiniz ve çerçevenin IoC konteyneri bunları otomatik olarak çözer ve sağlar — manuel örnekleme ve sıkı bağlamayı ortadan kaldırır.

Faydalar önemli ve NestJS'nin neden değerli olduğunun merkezindedir: **gevşek bağlama** (soyutlamalara bağlı olun), **test edilebilirlik** (gerçek bağımlılıklar yerine mock'ları enjekte edin — kapsamlı birim test yapmasını kolaylaştırır), yeniden kullanılabilirlik (paylaşılan singleton'lar) ve bakım yapılabilirlik.

DI, Angular ve Spring gibi çerçevelerden ödünç alınmıştır; bunu ustaca kullanmak — bağımlılıkları nasıl bildireceğinizi, kaydedeceğinizi, enjekte edeceğinizi ve mock'layacağınızı — iyi yapılandırılmış, test edilebilir NestJS uygulamaları oluşturmak için gereklidir ve çerçevede derinlemesine anlaşılması gereken en önemli kavramlardan biridir.