NestJS sử dụng decorator như thế nào?

Question

Accepted Answer

NestJS được xây dựng quanh **TypeScript decorator** — các chú thích đặc biệt có tiền tố `@` gắn **metadata** vào class, method và tham số. NestJS đọc metadata này (qua reflection) để kết nối routing, dependency injection, validation, và hơn thế một cách khai báo. Decorator có mặt khắp nơi trong Nest.

## Class decorator — định nghĩa vai trò của một class

```ts
@Controller("users")     // class này là một CONTROLLER, tiền tố /users
export class UsersController {}

@Injectable()            // class này là một PROVIDER (có thể inject)
export class UsersService {}

@Module({ ... })         // class này là một MODULE
export class UsersModule {}
```

Class decorator khai báo một class *là gì* trong kiến trúc NestJS (controller, provider, module) và cấu hình nó.

## Method decorator — ánh xạ route và áp dụng hành vi

```ts
@Get()                   // bộ xử lý GET request
@Post()                  // bộ xử lý POST
@Get(":id")              // GET /users/:id
@HttpCode(204)           // đặt mã trạng thái response
@UseGuards(AuthGuard)    // áp dụng một guard cho route này
@UseInterceptors(LoggingInterceptor)
findAll() {}
```

## Parameter decorator — trích xuất dữ liệu request

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

Parameter decorator lấy ra một cách khai báo đúng dữ liệu bạn cần từ request — không cần parse `req` thủ công.

## Property/validation decorator (trên DTO)

```ts
export class CreateUserDto {
  @IsEmail()                     // quy tắc validation (class-validator)
  email: string;

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

## Tại sao dùng decorator? Metadata khai báo

```text
Decorator gắn METADATA mà NestJS đọc lúc runtime (qua reflection) để:
  ✓ Đăng ký route (@Get, @Controller)
  ✓ Kết nối dependency injection (@Injectable, @Inject)
  ✓ Áp dụng guard/interceptor/pipe (@UseGuards, v.v.)
  ✓ Validate input (@IsEmail, @IsString)
→ Hành vi được khai báo NGAY NƠI nó áp dụng, súc tích và dễ đọc.
```

## Custom decorator

```ts
// bạn có thể tạo decorator của riêng mình — vd. trích xuất user hiện tại từ request
export const CurrentUser = createParamDecorator((data, ctx) =>
  ctx.switchToHttp().getRequest().user
);
// cách dùng: findProfile(@CurrentUser() user: User) {}
```

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

Decorator là tính năng cú pháp đặc trưng của NestJS — toàn bộ framework được tổ chức quanh chúng, nên hiểu cách chúng hoạt động là thiết yếu để đọc và viết bất kỳ code NestJS nào.

Chúng cung cấp một cách tiếp cận **khai báo**, dựa trên metadata: thay vì cấu hình mệnh lệnh (imperative), bạn chú thích class, method và tham số để khai báo routing (`@Controller`, `@Get`), dependency injection (`@Injectable`), hành vi xuyên suốt (`@UseGuards`, `@UseInterceptors`), và validation (`@IsEmail`) ngay nơi chúng áp dụng — súc tích và dễ đọc.

Cơ chế metadata-qua-reflection này (cùng ý tưởng đằng sau annotation của Angular và Java/Spring) là điều tạo nên phong cách sạch sẽ, có cấu trúc của NestJS.

Nhận biết các loại (class, method, parameter, property decorator), biết những loại phổ biến, và có khả năng tạo custom decorator là kiến thức NestJS nền tảng — decorator là cách gần như mọi tính năng được biểu đạt, khiến chúng trở thành một trong những thứ đầu tiên và quan trọng nhất cần hiểu trong framework.