Pipe là gì và validation hoạt động như thế nào?

Question

Accepted Answer

**Pipe** là các class **biến đổi hoặc validate** dữ liệu input trước khi nó đến được route handler. Chúng hoạt động trên các tham số (argument) của các method controller — hoặc biến đổi chúng (vd. string → number) hoặc validate chúng (từ chối dữ liệu không hợp lệ). Validation trong NestJS được xây dựng trên pipe.

## Các transformation pipe tích hợp sẵn

```ts
@Get(":id")
findOne(@Param("id", ParseIntPipe) id: number) {    // biến "5" (string) → 5 (number)
  // id được đảm bảo là number; input không phải số → lỗi 400 tự động
  return this.usersService.findOne(id);
}
// các pipe tích hợp khác: ParseBoolPipe, ParseUUIDPipe, ParseArrayPipe, DefaultValuePipe
```

Transformation pipe chuyển input sang đúng kiểu (route param/query luôn là string), thất bại với lỗi 400 nếu không thể chuyển đổi.

## ValidationPipe — validate DTO tự động

```ts
// bật toàn cục trong main.ts
app.useGlobalPipes(new ValidationPipe({
  whitelist: true,              // loại bỏ thuộc tính không được khai báo trong DTO
  forbidNonWhitelisted: true,   // ném lỗi nếu có thuộc tính lạ
  transform: true,              // biến object thuần thành instance DTO, chuyển kiểu
}));
```

```ts
// với một DTO dùng decorator class-validator:
export class CreateUserDto {
  @IsEmail() email: string;
  @MinLength(8) password: string;
}

@Post()
create(@Body() dto: CreateUserDto) {   // ValidationPipe validate body tự động
  // nếu không hợp lệ → 400 kèm chi tiết, TRƯỚC KHI cái này chạy
}
```

`ValidationPipe` đọc các decorator `class-validator` của DTO và validate dữ liệu đến tự động — trả về lỗi 400 chi tiết khi thất bại, để handler của bạn chỉ bao giờ nhận dữ liệu hợp lệ.

## Cách pipe nằm trong luồng request

```text
Request → ...middleware/guard/interceptor... → PIPE (biến đổi/validate) → Handler
Pipe chạy NGAY TRƯỚC route handler, hoạt động trên các argument của method.
```

## Custom pipe

```ts
@Injectable()
export class TrimPipe implements PipeTransform {
  transform(value: any) {
    return typeof value === "string" ? value.trim() : value;   // biến đổi tùy chỉnh
  }
}
// cách dùng: @Body(TrimPipe) ...
```

Bạn implement method `transform()` của `PipeTransform` cho logic validation/biến đổi tùy chỉnh.

## Áp dụng pipe ở các cấp độ khác nhau

```ts
@UsePipes(new ValidationPipe())      // cấp method hoặc controller
@Param("id", ParseIntPipe)            // cấp tham số
app.useGlobalPipes(new ValidationPipe())   // toàn cục (phổ biến nhất cho validation)
```

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

Pipe là một tính năng then chốt của NestJS để xử lý input an toàn, và chúng là nền tảng của **hệ thống validation** của framework.

Hiểu chúng là thiết yếu vì gần như mọi API endpoint đều cần validate và biến đổi input: transformation pipe (`ParseIntPipe`, v.v.) đảm bảo các tham số đúng kiểu, và — quan trọng nhất — **`ValidationPipe`** kết hợp với DTO cung cấp validation tự động, khai báo cho request body dựa trên các quy tắc `class-validator`, từ chối input không hợp lệ hoặc độc hại với lỗi rõ ràng *trước khi* nó đến được business logic của bạn.

Điều này quan trọng cho cả bảo mật (validate/làm sạch input không tin cậy, loại bỏ thuộc tính không mong đợi) và độ vững chắc (handler chỉ nhận dữ liệu hợp lệ).

Biết cách bật validation pipe toàn cục với các tùy chọn hợp lý (`whitelist`, `transform`), dùng transformation pipe tích hợp sẵn, và viết custom pipe là nền tảng để xây dựng các API NestJS an toàn, có cấu trúc tốt — pipe và validation là các khái niệm hằng ngày, phải biết trong framework.