DTOは予期されるデータを記述する単純なクラスで、検証デコレータ（class-validatorから）を使って各フィールドが満たすべきルールを指定します。
@Post()
create(@Body() dto: CreateUserDto) { // the body is typed AND validated as CreateUserDto
// dto is guaranteed to be valid here (with the validation pipe enabled)
return this.usersService.create(dto);
}
@Body() dto: CreateUserDtoはリクエストボディに型を付け、検証パイプが有効な場合、ハンドラー実行前に自動的に検証します。
// main.ts — turn on the global validation pipe
app.useGlobalPipes(new ValidationPipe({
whitelist: true, // strip properties NOT in the DTO (security)
forbidNonWhitelisted: true, // reject requests with extra unknown properties
transform: true, // auto-transform payloads to DTO instances + convert types
}));
ValidationPipeを使用すると、NestJSはDTOのデコレータに対して受信ボディを自動的に検証し、検証失敗時は詳細情報を含む400エラーを返します。これはコードが実行される前に行われます。
DTO → the shape of data crossing the API boundary (request/response contract)
Entity → the database model (e.g. a TypeORM entity / Prisma model)
→ Keep them SEPARATE: the API contract shouldn't be coupled to the DB schema.
(A CreateUserDto has password+email; the User entity has id, timestamps, etc.)
DTOは意図的にデータベースエンティティと異なります。APIが受け入れ/返すものを表し、内部ストレージから分離されています。
import { PartialType } from "@nestjs/mapped-types";
// derive an UpdateUserDto where all fields are optional — no duplication
export class UpdateUserDto extends PartialType(CreateUserDto) {}
DTOは、型安全性、明確なAPIコントラクト、自動検証をエンドポイントにもたらす重要なNestJSパターンです。
DTOはエンドポイントが受け入れるデータ（リクエスト形状）を正確に定義し、コンパイル時の型付けを提供し、自己文書化されたコントラクトとして機能します。
重要なのは、class-validatorデコレータとValidationPipeと組み合わせることで、自動入力検証が可能になるということです。不正形式または悪意のあるリクエストはビジネスロジックに到達する前に明確なエラーで拒否されます。これはセキュリティと堅牢性に不可欠です（whitelistオプションは予期しないプロパティも削除します）。
DTOの追加方法、検証ルールの追加方法、検証パイプの有効化方法、そしてDTOをデータベースエンティティから分離する（APIコントラクトを内部ストレージから分離する）という重要な原則を理解することは、安全で構造化された保守性の高いNestJS APIを構築するための基礎です。
DTOはほぼすべての入力を受け入れるエンドポイントに表示され、日常的で必須の知識となっています。