NestJSはデコレータをどのように使用していますか?

Question

Accepted Answer

NestJSは**TypeScriptデコレータ**を中心に構築されています。これは、クラス、メソッド、パラメータに**メタデータ**をアタッチする特別な`@`プレフィックス付きのアノテーションです。NestJSはこのメタデータ(リフレクションを介して)を読み込み、ルーティング、依存性注入、検証などを宣言的に配線します。デコレータはNestのいたるところにあります。

## クラスデコレータ — クラスの役割を定義する

```ts
@Controller("users")     // this class is a CONTROLLER, prefix /users
export class UsersController {}

@Injectable()            // this class is a PROVIDER (injectable)
export class UsersService {}

@Module({ ... })         // this class is a MODULE
export class UsersModule {}
```

クラスデコレータは、NestJSアーキテクチャにおいてクラスが*何であるか*(コントローラ、プロバイダ、モジュール)を宣言し、設定します。

## メソッドデコレータ — ルートをマップしてビヘイビアを適用する

```ts
@Get()                   // GET request handler
@Post()                  // POST handler
@Get(":id")              // GET /users/:id
@HttpCode(204)           // set the response status code
@UseGuards(AuthGuard)    // apply a guard to this route
@UseInterceptors(LoggingInterceptor)
findAll() {}
```

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

```ts
findOne(
  @Param("id") id: string,       // route parameter
  @Query("sort") sort: string,   // query string
  @Body() dto: CreateUserDto,    // request body
  @Headers("auth") auth: string, // header
) {}
```

パラメータデコレータは、リクエストから必要なデータを宣言的に抽出します — `req`の手動パースは不要です。

## プロパティ/検証デコレータ(DTO上)

```ts
export class CreateUserDto {
  @IsEmail()                     // validation rules (class-validator)
  email: string;

@IsString()
  @MinLength(8)
  password: string;
}
```

## なぜデコレータを使うのか? 宣言的メタデータ

```text
Decorators attach METADATA that NestJS reads at runtime (via reflection) to:
  ✓ Register routes (@Get, @Controller)
  ✓ Wire dependency injection (@Injectable, @Inject)
  ✓ Apply guards/interceptors/pipes (@UseGuards, etc.)
  ✓ Validate input (@IsEmail, @IsString)
→ Behavior is declared WHERE it applies, concisely and readably.
```

## カスタムデコレータ

```ts
// you can create your own — e.g. extract the current user from the request
export const CurrentUser = createParamDecorator((data, ctx) =>
  ctx.switchToHttp().getRequest().user
);
// usage: findProfile(@CurrentUser() user: User) {}
```

## なぜ重要なのか

デコレータはNestJSを定義する構文機能です。フレームワーク全体がそれらを中心に構成されているため、その動作方法を理解することはNestJSコードの読み書きに不可欠です。

デコレータは**宣言的な**、メタデータ駆動のアプローチを提供します。命令的な設定の代わりに、クラス、メソッド、パラメータにアノテーション(`@Controller`, `@Get`)を付けてルーティング、依存性注入(`@Injectable`)、横断的なビヘイビア(`@UseGuards`, `@UseInterceptors`)、検証(`@IsEmail`)を宣言します。これらはそれが適用される場所に直接記述されます。簡潔で読みやすいです。

このメタデータ経由リフレクションメカニズム(AngularとJava/Springアノテーションの背後にある同じ考え)は、NestJSのクリーンで構造化されたスタイルを可能にします。

カテゴリ(クラス、メソッド、パラメータ、プロパティデコレータ)を認識し、一般的なものを知り、カスタムデコレータを作成できることは、NestJSの流暢性の基礎です。デコレータはほぼすべての機能が表現される方法であり、フレームワークで最初に学ぶべき最も重要なものの1つにします。