Decorator란 무엇이며 어떻게 사용하나요?

Question

Accepted Answer

**Decorator**는 클래스, 메서드, 프로퍼티, 또는 매개변수에 동작이나 메타데이터를 추가하는 특수 선언(`@name`)입니다. 런타임이 데코레이션된 대상과 함께 호출하는 함수로, 선언적으로 그것을 감싸거나 어노테이션하게 해줍니다.

```ts
// 호출을 로깅하는 간단한 메서드 decorator
function log(target: any, key: string, desc: PropertyDescriptor) {
  const original = desc.value;
  desc.value = function (...args: any[]) {     // 원본 메서드를 감쌈
    console.log(`calling ${key} with`, args);
    return original.apply(this, args);
  };
}

class Service {
  @log
  fetch(id: number) { return { id }; }
}
new Service().fetch(1); // "calling fetch with [1]"를 로그한 뒤 실행
```

Decorator는 메서드 descriptor를 받아 래퍼로 교체했습니다 — 메서드 본문을 건드리지 않고 횡단 관심사(로깅, 캐싱, 타이밍)를 처리합니다.

## 가장 흔히 보는 곳: 프레임워크

```ts
@Controller("users")          // NestJS — 라우트 컨트롤러 선언
export class UsersController {
  @Get(":id")                 // GET /users/:id 매핑
  findOne(@Param("id") id: string) { return id; } // param decorator가 라우트 파라미터를 주입
}

@Entity()                     // TypeORM — 클래스를 DB 테이블에 매핑
class User { @Column() name: string; }
```

NestJS, Angular, TypeORM, class-validator는 DI, 라우팅, ORM 매핑, 검증을 위해 decorator를 중심으로 구축되었습니다.

## 두 가지 형태 (중요)

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

위의 **레거시(실험적)** decorator는 오늘날 Nest/Angular/TypeORM이 의존하는 것입니다. 또한 다른 시그니처를 가진 더 새로운 **TC39 Stage-3 decorator**(TS 5+)도 있으며, 이것이 미래의 표준입니다 — 하지만 대부분의 기존 프레임워크는 여전히 레거시 형태를 사용합니다.

## 왜 중요한가

Decorator는 깔끔하고 선언적인 메타프로그래밍을 가능하게 합니다 — 서버 프레임워크와 ORM의 중추입니다.

메커니즘(대상을 감싸는 함수)과 레거시-대-표준 구분을 둘 다 아는 것은 NestJS/Angular 생태계에서 작업하는 데 필수입니다.