Özel sağlayıcılar (custom providers) ve enjeksiyon tokenları nelerdir?

Question

Accepted Answer

Basit `@Injectable()` sınıflarının ötesinde, NestJS **özel sağlayıcıları** — neyin enjekte edileceğini tanımlamanın esnek yolları — **enjeksiyon tokenları** kullanarak destekler. Bu, değerleri enjekte etmenizi, örneklerin nasıl oluşturulduğunu yapılandırmanızı, uygulamaları değiştirmenizi ve sınıf olmayan bağımlılıkları enjekte etmenizi sağlar.

## Dört özel sağlayıcı türü

```ts
@Module({
  providers: [
    // 1. useClass — standard (or swap the implementation behind a token)
    { provide: PaymentService, useClass: StripePaymentService },

// 2. useValue — inject a constant/object/mock (great for config and testing)
    { provide: "CONFIG", useValue: { apiKey: "abc", timeout: 5000 } },

// 3. useFactory — compute the provider dynamically (can use other deps)
    {
      provide: "DATABASE_CONNECTION",
      useFactory: async (config: ConfigService) => {
        return await createConnection(config.get("DB_URL"));   // async setup
      },
      inject: [ConfigService],        // dependencies for the factory
    },

// 4. useExisting — create an alias for an existing provider
    { provide: "ALIAS", useExisting: PaymentService },
  ],
})
export class AppModule {}
```

## Enjeksiyon tokenları — sınıf olmayan bağımlılıklar için

```ts
// classes can be tokens directly (by type). For values/interfaces, use a string/Symbol token:
@Injectable()
export class PaymentProcessor {
  constructor(@Inject("CONFIG") private config: AppConfig) {}   // inject by token
}
```

Arabirim ya da düz bir değeri türe göre enjekte edemezsiniz (çalışma zamanında mevcut değillerdir), bu nedenle bir **token** (bir string veya `Symbol`) kullanırsınız ve bunu `@Inject(token)` ile enjekte edersiniz. Bu, yapılandırma nesnelerini, üçüncü taraf istemcileri veya arabirim tipli bağımlılıkları enjekte etmenin yoludur.

## useFactory — en güçlü (dinamik, zaman uyumsuz kurulum)

```ts
// create a provider whose value depends on runtime config / async initialization
{
  provide: "REDIS_CLIENT",
  useFactory: (config: ConfigService) => new Redis(config.get("REDIS_URL")),
  inject: [ConfigService],
}
```

`useFactory` sağlayıcıyı üretmek için (enjekte edilen bağımlılıklarla) bir işlev çalıştırır — bağlantılar, istemciler veya çalışma zamanı yapılandırması ya da zaman uyumsuz kurulum gerektiren herhangi bir şey için gereklidir.

## Uygulamaları değiştirme (useClass) — esneklik ve test etme

```ts
// inject a different implementation based on environment
{
  provide: PaymentService,
  useClass: process.env.NODE_ENV === "test" ? MockPaymentService : StripePaymentService,
}
```

Tüketiciler token'a (`PaymentService`) bağlı olduğundan, somut sınıfı değiştirebilirsiniz — üretimde gerçek Stripe servisi, testlerde sahte — tüketicileri değiştirmeden.

## Neden önemli

Özel sağlayıcılar ve enjeksiyon tokenları, NestJS'nin bağımlılık enjeksiyonunu basit sınıfların ötesine genişleterek, gerçek dünya uygulamaları için gereken esnekliği sağlar.

Bunları anlamak birkaç yaygın senaryo için önemlidir: **sınıf olmayan değerleri enjekte etme** (yapılandırma nesneleri, sabitler) `useValue` ve string/Symbol tokenları aracılığıyla (arabirimler veya düz değerleri türe göre enjekte edemezsiniz); **dinamik/zaman uyumsuz sağlayıcı oluşturma** `useFactory` aracılığıyla (en güçlü form — veritabanı bağlantıları, Redis istemcileri veya çalışma zamanı değerlerinden yapılandırılan üçüncü taraf SDK örnekleri oluşturma, kendi enjekte edilen bağımlılıklarıyla); ve **uygulamaları bir token'ın arkasında değiştirme** `useClass` aracılığıyla (ortam tabanlı uygulamaları etkinleştirme ve kritik olarak, **testlerde kolaylıkla sahte kullanma** — tüketicilere dokunmadan bir token için sahte bir sınıf sağlama).

Bu esneklik NestJS'nin DI'sını üretim mimarisi için güçlü ve mükemmel test edilebilirlik yapar.

Dört sağlayıcı türünü (`useClass`, `useValue`, `useFactory`, `useExisting`), enjeksiyon tokenlarının sınıf olmayan bağımlılıklar için nasıl çalıştığını ve her birinin ne zaman kullanılacağını bilmek, temel DI'ın ötesinde önemli bir adımdır — veritabanlarını, harici hizmetleri, yapılandırmayı ve değiştirilebilir/sahte yapılabilir bağımlılıkları idiyomatik NestJS şekliyle bağladığınız yoldur, bu da gerçek uygulamalarda sıkça gereken, mimari açıdan önemli bir konudur.