カスタムプロバイダとインジェクショントークンとは何ですか？

Question

Accepted Answer

シンプルな `@Injectable()` クラスを超えて、NestJSは**カスタムプロバイダ**（何を注入するかを定義する柔軟な方法）と**インジェクショントークン**をサポートしています。これにより、値を注入したり、インスタンスの作成方法を設定したり、実装を入れ替えたり、非クラス依存関係を注入したりできます。

## 4つのカスタムプロバイダタイプ

```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 {}
```

## インジェクショントークン — 非クラス依存関係向け

```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
}
```

インターフェースまたはプレーン値をタイプで注入することはできません（実行時に存在しないため）。代わりに、`@Inject(token)` と共に**トークン**（文字列または `Symbol`）を使用して注入します。これは、設定オブジェクト、サードパーティクライアント、またはインターフェース型の依存関係を注入する方法です。

## useFactory — 最も強力（動的、非同期セットアップ）

```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` は関数（注入された依存関係を持つ）を実行してプロバイダを生成します。これは接続、クライアント、または実行時設定や非同期セットアップが必要なものに不可欠です。

## 実装の入れ替え（useClass） — 柔軟性とテスト

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

コンシューマーはトークン（`PaymentService`）に依存しているため、具体的なクラスを入れ替えることができます。本番環境では実際のStripeサービス、テストではモックなど、消費元のコードを変更することなく。

## なぜ重要なのか

カスタムプロバイダとインジェクショントークンは、NestJSの依存性注入をシンプルなクラスを超えて拡張し、実世界のアプリケーションに必要な柔軟性を提供します。

いくつかの一般的なシナリオで理解することが重要です：**非クラス値の注入**（設定オブジェクト、定数）を `useValue` と文字列/Symbolトークンを使って行う（インターフェースやプレーン値をタイプで注入できないため）；**動的/非同期プロバイダ作成** `useFactory` を使って行う（最も強力な形式 — データベース接続、Redisクライアント、またはサードパーティSDKインスタンスを実行時値から設定し、自身の注入された依存関係を持つ）；および**トークンの背後で実装を入れ替える** `useClass` を使って行う（環境ベースの実装を有効にし、重要なことに、テストでの簡単な**モッキング** — コンシューマーに触れることなくトークンのモッククラスを提供）。

この柔軟性がNestJSのDIを本番アーキテクチャに強力にし、優れたテスト可能性を実現しています。

4つのプロバイダタイプ（`useClass`、`useValue`、`useFactory`、`useExisting`）、非クラス依存関係のインジェクショントークンがどのように機能するか、およびそれぞれをいつ使用するかを知ることは、基本的なDIを超えた重要なステップです。これは、データベース、外部サービス、設定、および交換可能/モック化可能な依存関係をNestJSのイディオマティックな方法で配線する方法です。これにより、実際のアプリケーションで頻繁に必要とされ、アーキテクチャ的に重要なトピックになります。