NestJS는 decorator를 어떻게 사용하나요?

Question

Accepted Answer

NestJS는 **TypeScript decorator**를 중심으로 구축되었습니다 — 클래스, 메서드, 파라미터에 **메타데이터**를 부착하는 특수한 `@` 접두사 어노테이션입니다. NestJS는 이 메타데이터를 (reflection을 통해) 읽어 라우팅, dependency injection, 검증 등을 선언적으로 연결합니다. Decorator는 Nest 어디에나 있습니다.

## 클래스 decorator — 클래스의 역할 정의

```ts
@Controller("users")     // 이 클래스는 CONTROLLER, prefix /users
export class UsersController {}

@Injectable()            // 이 클래스는 PROVIDER (주입 가능)
export class UsersService {}

@Module({ ... })         // 이 클래스는 MODULE
export class UsersModule {}
```

클래스 decorator는 클래스가 NestJS 아키텍처에서 *무엇인지*(controller, provider, module)를 선언하고 구성합니다.

## 메서드 decorator — 라우트 매핑 및 동작 적용

```ts
@Get()                   // GET 요청 핸들러
@Post()                  // POST 핸들러
@Get(":id")              // GET /users/:id
@HttpCode(204)           // 응답 상태 코드 설정
@UseGuards(AuthGuard)    // 이 라우트에 guard 적용
@UseInterceptors(LoggingInterceptor)
findAll() {}
```

## 파라미터 decorator — 요청 데이터 추출

```ts
findOne(
  @Param("id") id: string,       // 라우트 파라미터
  @Query("sort") sort: string,   // 쿼리 문자열
  @Body() dto: CreateUserDto,    // 요청 본문
  @Headers("auth") auth: string, // 헤더
) {}
```

파라미터 decorator는 요청에서 필요한 데이터만 선언적으로 추출합니다 — 수동 `req` 파싱이 필요 없습니다.

## 속성/검증 decorator (DTO에서)

```ts
export class CreateUserDto {
  @IsEmail()                     // 검증 규칙 (class-validator)
  email: string;

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

## 왜 decorator인가? 선언적 메타데이터

```text
Decorator는 NestJS가 런타임에 (reflection을 통해) 읽는 메타데이터를 부착하여:
  ✓ 라우트 등록 (@Get, @Controller)
  ✓ dependency injection 연결 (@Injectable, @Inject)
  ✓ guard/interceptor/pipe 적용 (@UseGuards 등)
  ✓ 입력 검증 (@IsEmail, @IsString)
→ 동작이 적용되는 위치에 간결하고 읽기 쉽게 선언됩니다.
```

## 커스텀 decorator

```ts
// 직접 만들 수 있습니다 — 예: request에서 현재 사용자 추출
export const CurrentUser = createParamDecorator((data, ctx) =>
  ctx.switchToHttp().getRequest().user
);
// 사용: findProfile(@CurrentUser() user: User) {}
```

## 왜 중요한가

Decorator는 NestJS의 대표적인 구문적 특징입니다 — 프레임워크 전체가 이를 중심으로 구성되어 있으므로, 그 동작 방식을 이해하는 것은 모든 NestJS 코드를 읽고 쓰는 데 필수적입니다.

Decorator는 **선언적**이고 메타데이터 기반의 접근을 제공합니다: 명령형 구성 대신, 클래스, 메서드, 파라미터에 어노테이션을 달아 라우팅(`@Controller`, `@Get`), dependency injection(`@Injectable`), 횡단 관심사(`@UseGuards`, `@UseInterceptors`), 검증(`@IsEmail`)을 적용되는 바로 그 위치에 선언합니다 — 간결하고 읽기 쉽습니다.

Reflection을 통한 이 메타데이터 메커니즘(Angular와 Java/Spring 어노테이션의 동일한 아이디어)이 NestJS의 깔끔하고 구조화된 스타일을 가능하게 합니다.

범주(클래스, 메서드, 파라미터, 속성 decorator)를 인식하고, 일반적인 것들을 알고, 커스텀 decorator를 만들 수 있는 것은 기본적인 NestJS 능숙도입니다 — decorator는 거의 모든 기능이 표현되는 방식이므로 프레임워크에서 가장 먼저, 가장 중요하게 이해해야 할 것 중 하나입니다.