プロバイダーとサービスとは何ですか？

Question

プロバイダーとサービスとは何ですか？

IT Interview Practice · Accepted Answer

NestJS において、**provider** は依存関係として**注入（inject）**できる任意のクラスであり、**service** はその最も一般的な種類で、**ビジネスロジック**を保持するクラスです。クラスに `@Injectable()` を付けると、NestJS の DI システムが生成して注入できる provider になります。

## サービスの定義（最も一般的な provider）

```ts
import { Injectable } from "@nestjs/common";

@Injectable()              // marks the class as a provider (injectable)
export class UsersService {
  private users = [];

findAll() { return this.users; }                  // business logic
  findOne(id: string) { return this.users.find(u => u.id === id); }
  create(data) { this.users.push(data); return data; }
}
```

`@Injectable()` デコレーターは、このクラスが dependency injection に参加することを NestJS に伝えます。これにより controller や他の provider に注入できるようになります。

## コンストラクター経由でのサービスの注入

```ts
@Controller("users")
export class UsersController {
  // NestJS sees this parameter and INJECTS a UsersService instance automatically
  constructor(private usersService: UsersService) {}

@Get()
  findAll() {
    return this.usersService.findAll();   // use the injected service
  }
}
```

依存関係はコンストラクターのパラメーターとして宣言し、NestJS がインスタンスを生成して供給します。`new UsersService()` を自分で書くことは決してありません。

## モジュールへの provider の登録

```ts
@Module({
  controllers: [UsersController],
  providers: [UsersService],        // register the provider so DI can resolve it
  exports: [UsersService],          // make it available to OTHER modules that import this one
})
export class UsersModule {}
```

DI が認識できるように、provider はモジュールの `providers` 配列に登録する必要があります。また `exports` によって、それを import する他のモジュールと共有できます。

## provider はデフォルトでシングルトン

```text
By default, NestJS creates ONE shared instance of each provider (singleton scope)
for the whole application → efficient, shared state.
(Other scopes exist: REQUEST-scoped, TRANSIENT — but singleton is the default.)
```

## なぜ service を controller から分離するのか？

```text
Controller → handles HTTP (routing, request/response)
Service    → handles business logic (rules, data access, computations)
→ Separation makes logic REUSABLE (multiple controllers can use one service),
  TESTABLE (test the service in isolation), and ORGANIZED.
```

## なぜ重要なのか

プロバイダーとサービスは、NestJS のアーキテクチャと dependency-injection を中心とした設計の核心です。

サービスはアプリケーションの**ビジネスロジック**を保持し、（HTTP の関心事のみを扱う）controller から分離されます。この関心の分離により、ロジックは複数の controller 間で再利用可能になり、単独で容易にテストでき、整理された状態が保たれます。

`@Injectable()` がクラスを注入可能な provider としてマークすること、provider がモジュールに登録されコンストラクター経由で注入されること（DI がインスタンスを生成してくれること）、そしてデフォルトでシングルトンであることを理解しておくことは、NestJS の基本的な日常知識です。

provider／service パターンは、controller やモジュールと組み合わさって、あらゆる NestJS アプリケーションの土台となります。これを習得することは、よく構造化され保守しやすいバックエンドを構築するために不可欠であり、このフレームワークで最初に学ぶべき概念の一つです。

サービスの定義（最も一般的な provider）

コンストラクター経由でのサービスの注入

モジュールへの provider の登録

provider はデフォルトでシングルトン

なぜ service を controller から分離するのか？

なぜ重要なのか

関連する質問