NestJSのコントローラーとは何ですか？

Question

Accepted Answer

**コントローラー**は、**HTTP リクエスト**を処理して応答を返します。アプリケーションのルートを定義し、エントリーポイントとして機能します。リクエストを受け取り、データを抽出し、サービスに委譲し、結果を返します。ルーティングの関心事をビジネスロジックから分離します。

## コントローラーの定義

```ts
import { Controller, Get, Post, Body, Param } from "@nestjs/common";

@Controller("users")          // the route PREFIX → all routes start with /users
export class UsersController {
  constructor(private usersService: UsersService) {}   // inject a service via DI

@Get()                       // GET /users
  findAll() {
    return this.usersService.findAll();
  }

@Get(":id")                  // GET /users/:id
  findOne(@Param("id") id: string) {        // extract the route param
    return this.usersService.findOne(id);
  }

@Post()                      // POST /users
  create(@Body() dto: CreateUserDto) {       // extract the request body
    return this.usersService.create(dto);
  }
}
```

## 仕組み：デコレーターがメソッドをルートにマップする

```text
@Controller("users") → route prefix /users
@Get() / @Post() / @Put() / @Patch() / @Delete() → HTTP method + sub-path
Combined: @Get(":id") inside @Controller("users") → GET /users/:id
```

デコレーターは宣言的にクラスメソッドを HTTP ルートにバインドします — クリーンで読みやすく、手動のルート登録は不要です。

## パラメーターデコレーターがリクエストデータを抽出する

```ts
@Get(":id")
example(
  @Param("id") id: string,        // route parameter (/users/:id)
  @Query("sort") sort: string,    // query string (?sort=name)
  @Body() body: CreateUserDto,    // request body
  @Headers("authorization") auth: string,  // a header
  @Req() req: Request,            // the raw request object (rarely needed)
) {}
```

Nestのパラメーターデコレーター（`@Param`、`@Query`、`@Body`、`@Headers`）は、必要なデータを正確にクリーンに抽出します — `req` の手動解析は不要です。

## コントローラーは THIN に保つべき

```ts
// ✅ controller delegates to a service — stays thin
@Post()
create(@Body() dto: CreateUserDto) {
  return this.usersService.create(dto);   // business logic lives in the SERVICE
}
// ❌ don't put database queries / business logic directly in the controller
```

ベストプラクティス：コントローラーを**薄く**保つ — HTTP 関心事（ルーティング、データ抽出、応答返却）を処理し、すべてのビジネスロジックを**サービス**に委譲します。この分離により、コードはテスト可能で整理された状態に保たれます。

## なぜ重要なのか

コントローラーは NestJS の基本的な構成要素です — すべての HTTP リクエストのエントリーポイントであり、API のルートが定義される場所です。

デコレーター（`@Controller`、`@Get`/`@Post`、`@Param`/`@Body`/`@Query`）がメソッドをルートにマップし、リクエストデータを宣言的に抽出する方法を理解することは、日常的な NestJS の知識です — これはいかなるエンドポイントも構築する方法です。

同様に重要なのは、コントローラーを**薄く**保つという原則です（HTTP 関心事のみを処理し、ビジネスロジックを注入されたサービスに委譲する）。これは NestJS の関心の分離哲学を具現化し、コードを保守可能でテスト可能に保ちます。

コントローラーは、サービスとモジュールとともに、すべての NestJS アプリケーションのコア構造を形成し、最初から理解することが不可欠です。