Custom provider và injection token là gì?

Question

Accepted Answer

Ngoài các class `@Injectable()` đơn giản, NestJS hỗ trợ **custom provider** — các cách linh hoạt để định nghĩa cái gì được inject — dùng **injection token**. Điều này cho phép bạn inject các giá trị, cấu hình cách các instance được tạo, hoán đổi các cài đặt, và inject các dependency không phải class.

## Bốn loại custom provider

```ts
@Module({
  providers: [
    // 1. useClass — chuẩn (hoặc hoán đổi cài đặt đằng sau một token)
    { provide: PaymentService, useClass: StripePaymentService },

// 2. useValue — inject một hằng số/object/mock (tuyệt cho config và testing)
    { provide: "CONFIG", useValue: { apiKey: "abc", timeout: 5000 } },

// 3. useFactory — tính toán provider động (có thể dùng các dep khác)
    {
      provide: "DATABASE_CONNECTION",
      useFactory: async (config: ConfigService) => {
        return await createConnection(config.get("DB_URL"));   // thiết lập async
      },
      inject: [ConfigService],        // dependency cho factory
    },

// 4. useExisting — tạo một alias cho một provider có sẵn
    { provide: "ALIAS", useExisting: PaymentService },
  ],
})
export class AppModule {}
```

## Injection token — cho các dependency không phải class

```ts
// class có thể là token trực tiếp (theo kiểu). Với giá trị/interface, dùng token string/Symbol:
@Injectable()
export class PaymentProcessor {
  constructor(@Inject("CONFIG") private config: AppConfig) {}   // inject theo token
}
```

Vì bạn không thể inject một interface hoặc một giá trị thuần theo kiểu (chúng không tồn tại lúc runtime), bạn dùng một **token** (một string hoặc `Symbol`) với `@Inject(token)` để inject nó. Đây là cách bạn inject các object cấu hình, client bên thứ ba, hoặc các dependency có kiểu interface.

## useFactory — mạnh nhất (thiết lập động, async)

```ts
// tạo một provider có giá trị phụ thuộc vào config runtime / khởi tạo async
{
  provide: "REDIS_CLIENT",
  useFactory: (config: ConfigService) => new Redis(config.get("REDIS_URL")),
  inject: [ConfigService],
}
```

`useFactory` chạy một hàm (với các dependency được inject) để tạo ra provider — thiết yếu cho các kết nối, client, hoặc bất cứ gì cần cấu hình runtime hoặc thiết lập async.

## Hoán đổi cài đặt (useClass) — linh hoạt & testing

```ts
// inject một cài đặt khác dựa trên môi trường
{
  provide: PaymentService,
  useClass: process.env.NODE_ENV === "test" ? MockPaymentService : StripePaymentService,
}
```

Vì các consumer phụ thuộc vào token (`PaymentService`), bạn có thể hoán đổi class cụ thể — một service Stripe thật trong production, một mock trong test — mà không thay đổi bất kỳ code consumer nào.

## Tại sao điều này quan trọng

Custom provider và injection token mở rộng dependency injection của NestJS vượt ra ngoài các class đơn giản, cho bạn sự linh hoạt cần thiết cho các ứng dụng thực tế.

Hiểu chúng là quan trọng cho nhiều kịch bản phổ biến: **inject các giá trị không phải class** (object cấu hình, hằng số) qua `useValue` và các token string/Symbol (vì bạn không thể inject interface hoặc giá trị thuần theo kiểu); **tạo provider động/async** qua `useFactory` (dạng mạnh nhất — tạo các kết nối database, Redis client, hoặc instance SDK bên thứ ba được cấu hình từ các giá trị runtime, với các dependency được inject của riêng chúng); và **hoán đổi cài đặt** qua `useClass` đằng sau một token (cho phép cài đặt dựa trên môi trường và, quan trọng nhất, dễ dàng **mock trong test** — cung cấp một class mock cho một token mà không chạm vào consumer).

Sự linh hoạt này là điều làm cho DI của NestJS mạnh mẽ cho kiến trúc production và khả năng test xuất sắc.

Biết bốn loại provider (`useClass`, `useValue`, `useFactory`, `useExisting`), cách injection token hoạt động cho các dependency không phải class, và khi nào dùng mỗi cái là một bước quan trọng vượt ra ngoài DI cơ bản — đó là cách bạn kết nối database, dịch vụ bên ngoài, cấu hình, và các dependency hoán đổi/mock được theo cách NestJS thành ngữ, khiến đây trở thành một chủ đề thường cần, quan trọng về mặt kiến trúc trong các ứng dụng thực tế.