Decorator là gì và được dùng như thế nào?

Question

Accepted Answer

Một **decorator** là một khai báo đặc biệt (`@name`) thêm hành vi hoặc metadata vào một class, method, property hay tham số. Nó là một hàm được runtime gọi với target được decorate, cho phép bạn bọc hoặc annotate nó một cách declarative.

```ts
// Một method decorator đơn giản ghi log các lời gọi
function log(target: any, key: string, desc: PropertyDescriptor) {
  const original = desc.value;
  desc.value = function (...args: any[]) {     // bọc method gốc
    console.log(`calling ${key} with`, args);
    return original.apply(this, args);
  };
}

class Service {
  @log
  fetch(id: number) { return { id }; }
}
new Service().fetch(1); // log "calling fetch with [1]" rồi chạy
```

Decorator nhận descriptor của method và thay nó bằng một wrapper — hành vi cross-cutting (logging, caching, timing) mà không cần đụng tới thân method.

## Nơi bạn gặp chúng nhiều nhất: các framework

```ts
@Controller("users")          // NestJS — khai báo một route controller
export class UsersController {
  @Get(":id")                 // map GET /users/:id
  findOne(@Param("id") id: string) { return id; } // param decorator inject route param
}

@Entity()                     // TypeORM — map một class tới một bảng DB
class User { @Column() name: string; }
```

NestJS, Angular, TypeORM và class-validator đều được xây dựng dựa trên decorator cho DI, routing, ORM mapping và validation.

## Hai dạng (quan trọng)

```json
{ "experimentalDecorators": true, "emitDecoratorMetadata": true }
```

Các decorator **legacy (experimental)** ở trên là thứ mà Nest/Angular/TypeORM dựa vào hiện nay. Cũng có **TC39 Stage-3 decorators** mới hơn (TS 5+) với chữ ký khác, đó là chuẩn tương lai — nhưng hầu hết các framework hiện có vẫn dùng dạng legacy.

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

Decorator cho phép meta-programming sạch sẽ, declarative — xương sống của các server framework và ORM.

Biết cả cơ chế (một hàm bọc một target) lẫn sự phân biệt legacy-vs-standard là thiết yếu để làm việc trong hệ sinh thái NestJS/Angular.