NestJSではルーティングはどのように機能していますか？

Question

Accepted Answer

**ルーティング**はNestJSでは**デコレータベース**です：URLパスとHTTPメソッドをデコレータを使用してコントローラメソッドにマップします。ルートプレフィックスは`@Controller()`から来で、特定のパス＋HTTPメソッドはメソッドデコレータ（`@Get()`など）から来ます — これらを組み合わせて完全なルートを形成します。

## ルートの構成

```ts
@Controller("users")          // PREFIX: all routes start with /users
export class UsersController {
  @Get()                       // GET /users
  findAll() {}

@Get("active")               // GET /users/active
  findActive() {}

@Get(":id")                  // GET /users/:id (dynamic parameter)
  findOne(@Param("id") id: string) {}

@Post()                      // POST /users
  create(@Body() dto: CreateUserDto) {}

@Put(":id")                  // PUT /users/:id
  update(@Param("id") id: string, @Body() dto: UpdateUserDto) {}

@Delete(":id")               // DELETE /users/:id
  remove(@Param("id") id: string) {}
}
```

コントローラのプレフィックス＋メソッドデコレータのパスが組み合わされます：`@Controller("users")`内の`@Get(":id")`→`GET /users/:id`。各HTTPメソッドには独自のデコレータがあります（`@Get`、`@Post`、`@Put`、`@Patch`、`@Delete`）。

## ルートパラメータとクエリ文字列

```ts
@Get(":id")
example(
  @Param("id") id: string,        // path param: /users/123 → id = "123"
  @Query("sort") sort: string,    // query: /users?sort=name → sort = "name"
  @Query() allQuery: any,         // the whole query object
) {}
```

## ネストされた/ワイルドカードルートとサブパス

```ts
@Controller("users")
export class UsersController {
  @Get(":id/posts")              // GET /users/:id/posts (nested resource)
  getUserPosts(@Param("id") id: string) {}

@Get("search/*")               // wildcard matching
  search() {}
}
```

## ルートの順序が重要

```ts
@Get("active")    // ✅ specific route FIRST
findActive() {}
@Get(":id")        // dynamic route AFTER — else "active" would match :id
findOne() {}
```

静的（固定）ルートは動的（`:param`）ルートより前に宣言すべきです。そうしないと動的ルートがそれらをキャプチャする可能性があります。

## グローバルプレフィックスとバージョニング

```ts
app.setGlobalPrefix("api/v1");   // all routes become /api/v1/...
// NestJS also supports API versioning (URI, header, media-type based)
```

グローバルプレフィックス（例：`/api/v1`）はすべてのルートに適用されます — APIの慣例として一般的です。

## なぜ重要なのか

ルーティングは基本的です — APIのURL構造を定義し、すべてのリクエストが正しいハンドラに到達する方法です。

NestJSの**デコレータベースのルーティング**（`@Controller`プレフィックスと`@Get`/`@Post`/など method デコレータを組み合わせて完全なルートを形成し、`@Param`/`@Query`でデータを抽出する）を理解することは必須の日常知識です — これはすべてのエンドポイントを構築する方法であり、宣言的なスタイルはマニュアルルート登録と比べてルーティングを清潔で読みやすくします。

実践的な詳細を知っること — プレフィックスとパスの構成、ルートパラメータとクエリ文字列の処理、ネストされたリソースルート、**ルートの順序**（静的を動的の前に）の重要性、およびAPIの慣例のためのグローバルプレフィックス/バージョニング — はNestJSで構造化されたREST APIを構築するために必要です。

ルーティング、コントローラ、およびパラメータデコレータは一緒に、フレームワークのリクエスト処理の基盤を形成し、これはNestJS開発者にとって必須の中核知識です。