NestJS ใช้ decorator อย่างไร?

Question

Accepted Answer

NestJS ถูกสร้างขึ้นรอบ ๆ **TypeScript decorator** — คำกำกับพิเศษที่นำหน้าด้วย `@` ซึ่งแนบ **metadata** เข้ากับคลาส, method และพารามิเตอร์. NestJS อ่าน metadata นี้ (ผ่าน reflection) เพื่อเชื่อมต่อ routing, dependency injection, validation และอื่น ๆ แบบ declarative Decorator มีอยู่ทั่วทุกที่ใน Nest

## Class decorator — กำหนดบทบาทของคลาส

```ts
@Controller("users")     // this class is a CONTROLLER, prefix /users
export class UsersController {}

@Injectable()            // this class is a PROVIDER (injectable)
export class UsersService {}

@Module({ ... })         // this class is a MODULE
export class UsersModule {}
```

Class decorator ประกาศว่าคลาส *เป็นอะไร* ในสถาปัตยกรรม NestJS (controller, provider, module) และตั้งค่ามัน

## Method decorator — แมป route และใช้พฤติกรรมต่าง ๆ

```ts
@Get()                   // GET request handler
@Post()                  // POST handler
@Get(":id")              // GET /users/:id
@HttpCode(204)           // set the response status code
@UseGuards(AuthGuard)    // apply a guard to this route
@UseInterceptors(LoggingInterceptor)
findAll() {}
```

## Parameter decorator — ดึงข้อมูลจาก 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 ดึงเฉพาะข้อมูลที่คุณต้องการออกจาก request แบบ declarative — ไม่ต้องแกะ `req` เองด้วยมือ

## Property/validation decorator (บน DTO)

```ts
export class CreateUserDto {
  @IsEmail()                     // validation rules (class-validator)
  email: string;

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

## ทำไมต้อง decorator? metadata แบบ declarative

```text
Decorators attach METADATA that NestJS reads at runtime (via reflection) to:
  ✓ Register routes (@Get, @Controller)
  ✓ Wire dependency injection (@Injectable, @Inject)
  ✓ Apply guards/interceptors/pipes (@UseGuards, etc.)
  ✓ Validate input (@IsEmail, @IsString)
→ Behavior is declared WHERE it applies, concisely and readably.
```

## Custom decorator

```ts
// you can create your own — e.g. extract the current user from the request
export const CurrentUser = createParamDecorator((data, ctx) =>
  ctx.switchToHttp().getRequest().user
);
// usage: findProfile(@CurrentUser() user: User) {}
```

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

Decorator เป็นคุณสมบัติทางไวยากรณ์ที่บ่งบอกความเป็น NestJS — เฟรมเวิร์กทั้งหมดจัดระเบียบรอบ ๆ มัน ดังนั้นการเข้าใจวิธีการทำงานของมันจึงจำเป็นต่อการอ่านและเขียนโค้ด NestJS ใด ๆ

มันให้แนวทางที่ขับเคลื่อนด้วย metadata แบบ **declarative**: แทนการตั้งค่าแบบ imperative คุณกำกับคลาส, method และพารามิเตอร์เพื่อประกาศ routing (`@Controller`, `@Get`), dependency injection (`@Injectable`), พฤติกรรมแบบ cross-cutting (`@UseGuards`, `@UseInterceptors`) และ validation (`@IsEmail`) ตรงจุดที่มันถูกใช้ — กระชับและอ่านง่าย

กลไก metadata-via-reflection นี้ (แนวคิดเดียวกับที่อยู่เบื้องหลัง annotation ของ Angular และ Java/Spring) คือสิ่งที่ทำให้สไตล์ที่สะอาดและมีโครงสร้างของ NestJS เป็นไปได้

การจดจำหมวดหมู่ต่าง ๆ (class, method, parameter, property decorator), การรู้จักตัวที่พบบ่อย และความสามารถในการสร้าง custom decorator เป็นความคล่องแคล่วพื้นฐานของ NestJS — decorator คือวิธีที่ฟีเจอร์แทบทุกอย่างถูกแสดงออกมา จึงเป็นหนึ่งในสิ่งแรกและสำคัญที่สุดที่ต้องเข้าใจในเฟรมเวิร์ก