DTO ใน NestJS คืออะไร?

Question

Accepted Answer

**DTO (Data Transfer Object)** คือคลาสที่กำหนด **รูปร่างของข้อมูล** ที่ส่งไปยังหรือมาจาก API ของคุณ — โดยทั่วไปคือโครงสร้างของ request body DTO ให้ type safety, ทำหน้าที่เป็น contract ที่ชัดเจนสำหรับ endpoint และ (เมื่อใช้ร่วมกับ validation decorator) ช่วยให้เกิดการ validate input โดยอัตโนมัติ

## การกำหนด DTO

```ts
import { IsEmail, IsString, MinLength, IsOptional, IsInt, Min } from "class-validator";

export class CreateUserDto {
  @IsEmail()                    // must be a valid email
  email: string;

@IsString()
  @MinLength(8)                 // password at least 8 chars
  password: string;

@IsOptional()                 // optional field
  @IsInt()
  @Min(0)
  age?: number;
}
```

DTO คือคลาสธรรมดาที่อธิบายข้อมูลที่คาดหวัง พร้อมด้วย **validation decorator** (จาก `class-validator`) ที่ระบุกฎซึ่งแต่ละ field ต้องเป็นไปตาม

## การใช้ DTO ใน controller

```ts
@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` กำหนดชนิดให้กับ request body และ — เมื่อเปิดใช้ validation pipe — จะ validate มันโดยอัตโนมัติก่อนที่ handler ของคุณจะทำงาน

## การเปิดใช้ validation อัตโนมัติ

```ts
// 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 จะ validate body ที่เข้ามาเทียบกับ decorator ของ DTO โดยอัตโนมัติ — ส่ง error 400 พร้อมรายละเอียดหากการ validate ล้มเหลว ก่อนที่โค้ดของคุณจะทำงาน

## DTO เทียบกับ Entity

```text
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 ตั้งใจให้แตกต่างจาก database entity — มันแทนสิ่งที่ API รับ/ส่ง โดยแยกออกจากการจัดเก็บภายใน

## รูปแบบและการนำกลับมาใช้ซ้ำ

```ts
import { PartialType } from "@nestjs/mapped-types";
// derive an UpdateUserDto where all fields are optional — no duplication
export class UpdateUserDto extends PartialType(CreateUserDto) {}
```

## ทำไมจึงสำคัญ

DTO เป็นรูปแบบสำคัญของ NestJS ที่นำ type safety, API contract ที่ชัดเจน และการ validate อัตโนมัติมาสู่ endpoint ของคุณ

มันกำหนดอย่างชัดเจนว่า endpoint รับข้อมูลอะไร (รูปร่างของ request) ให้คุณได้ typing ตอน compile-time และทำหน้าที่เป็น contract ที่บันทึกตัวเองได้

ที่สำคัญ เมื่อรวมกับ decorator ของ `class-validator` และ `ValidationPipe` มันช่วยให้เกิดการ **validate input โดยอัตโนมัติ** — request ที่ผิดรูปแบบหรือมุ่งร้ายจะถูกปฏิเสธพร้อม error ที่ชัดเจน *ก่อน* ถึง business logic ของคุณ ซึ่งจำเป็นต่อความปลอดภัยและความทนทาน (ตัวเลือก `whitelist` ยังตัด property ที่ไม่คาดหวังทิ้งด้วย)

การเข้าใจ DTO, วิธีเพิ่มกฎ validation, วิธีเปิดใช้ validation pipe และหลักการสำคัญของการ **แยก DTO ออกจาก database entity** (แยก API contract ออกจากการจัดเก็บภายใน) เป็นพื้นฐานของการสร้าง API NestJS ที่ปลอดภัย มีโครงสร้างดี และดูแลรักษาง่าย

DTO ปรากฏในแทบทุก endpoint ที่รับ input ทำให้มันเป็นความรู้พื้นฐานที่ใช้ทุกวัน