DTO trong NestJS là gì?

Question

Accepted Answer

Một **DTO (Data Transfer Object)** là một class định nghĩa **hình dạng của dữ liệu** được gửi đến hoặc từ API của bạn — thường là cấu trúc của một request body. DTO cung cấp an toàn kiểu (type safety), đóng vai trò là một hợp đồng (contract) rõ ràng cho các endpoint, và (với các validation decorator) cho phép validate input tự động.

## Định nghĩa một DTO

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

export class CreateUserDto {
  @IsEmail()                    // phải là email hợp lệ
  email: string;

@IsString()
  @MinLength(8)                 // mật khẩu tối thiểu 8 ký tự
  password: string;

@IsOptional()                 // trường tùy chọn
  @IsInt()
  @Min(0)
  age?: number;
}
```

Một DTO là một class thuần mô tả dữ liệu mong đợi, với các **validation decorator** (từ `class-validator`) chỉ định các quy tắc mà mỗi trường phải thỏa mãn.

## Dùng một DTO trong controller

```ts
@Post()
create(@Body() dto: CreateUserDto) {     // body được gán kiểu VÀ validate là CreateUserDto
  // dto được đảm bảo hợp lệ ở đây (với validation pipe được bật)
  return this.usersService.create(dto);
}
```

`@Body() dto: CreateUserDto` gán kiểu cho request body và — với validation pipe được bật — tự động validate nó trước khi handler của bạn chạy.

## Bật validation tự động

```ts
// main.ts — bật validation pipe toàn cục
app.useGlobalPipes(new ValidationPipe({
  whitelist: true,              // loại bỏ các thuộc tính KHÔNG có trong DTO (bảo mật)
  forbidNonWhitelisted: true,   // từ chối request có thuộc tính lạ không xác định
  transform: true,              // tự động chuyển payload thành instance DTO + chuyển kiểu
}));
```

Với `ValidationPipe`, NestJS validate các body đến dựa trên các decorator của DTO một cách tự động — trả về lỗi 400 kèm chi tiết nếu validation thất bại, trước khi code của bạn chạy.

## DTO so với Entity

```text
DTO    → hình dạng dữ liệu đi qua ranh giới API (hợp đồng request/response)
Entity → model database (vd. một TypeORM entity / Prisma model)
→ Giữ chúng TÁCH BIỆT: hợp đồng API không nên gắn chặt với schema DB.
  (Một CreateUserDto có password+email; User entity có id, timestamp, v.v.)
```

DTO cố ý khác với database entity — chúng đại diện cho những gì API chấp nhận/trả về, tách rời khỏi lưu trữ nội bộ.

## Biến thể và tái sử dụng

```ts
import { PartialType } from "@nestjs/mapped-types";
// dẫn xuất một UpdateUserDto nơi tất cả các trường là tùy chọn — không lặp lại
export class UpdateUserDto extends PartialType(CreateUserDto) {}
```

## Tại sao điều này quan trọng

DTO là một pattern quan trọng của NestJS, mang lại type safety, hợp đồng API rõ ràng, và validation tự động cho các endpoint của bạn.

Chúng định nghĩa chính xác dữ liệu mà một endpoint chấp nhận (hình dạng request), cho bạn gán kiểu lúc compile-time và đóng vai trò là hợp đồng tự tài liệu hóa.

Quan trọng nhất, kết hợp với các decorator `class-validator` và `ValidationPipe`, chúng cho phép **validate input tự động** — các request dị dạng hoặc độc hại bị từ chối với lỗi rõ ràng *trước khi* đến được business logic của bạn, điều này thiết yếu cho bảo mật và độ vững chắc (tùy chọn `whitelist` cũng loại bỏ các thuộc tính không mong đợi).

Hiểu DTO, cách thêm quy tắc validation, cách bật validation pipe, và nguyên tắc quan trọng về việc **giữ DTO tách biệt khỏi database entity** (tách hợp đồng API khỏi lưu trữ nội bộ) là nền tảng để xây dựng các API NestJS an toàn, có cấu trúc tốt, dễ bảo trì.

DTO xuất hiện trong gần như mọi endpoint chấp nhận input, khiến chúng trở thành kiến thức thiết yếu hằng ngày.