🎯 NestJS Custom Decorators – 나만의 데코레이터 만들기 완전 가이드

🎯 NestJS Custom Decorators – 나만의 데코레이터 만들기 완전 가이드

---

NestJS는 Express 기반 프레임워크지만, 메타프로그래밍을 적극 활용하여 데코레이터 기반 개발을 핵심 아키텍처로 삼고 있습니다.
이번 글에서는 NestJS 공식 문서 Custom Decorators를 기반으로,
**나만의 데코레이터(Custom Decorator)**를 만들고 실무에 적용하는 방법을 한글로 해설합니다.

데코레이터를 잘 다루면 코드의 재사용성, 가독성, 구조화가 눈에 띄게 향상됩니다.

---

✅ Custom Decorator란?

NestJS에서 @Body(), @Query() 같은 기본 데코레이터 외에도,
개발자가 직접 만든 데코레이터를 통해 반복되는 코드나 메타데이터를 추상화할 수 있습니다.

---

1️⃣ 예제 1 – 사용자 정보 추출 데코레이터 (@User())

✅ 사용자 정의 데코레이터 만들기

import { createParamDecorator, ExecutionContext } from '@nestjs/common';

export const User = createParamDecorator(
  (data: unknown, ctx: ExecutionContext) => {
    const request = ctx.switchToHttp().getRequest();
    return request.user;
  },
);

• createParamDecorator()를 통해 파라미터 데코레이터 생성
• ctx.switchToHttp().getRequest()로 Express 요청 객체 접근

---

✅ 사용 예시

@Get('profile')
getProfile(@User() user: any) {
  return user; // request.user 값
}

Passport 등을 통해 인증된 사용자의 정보를 요청 핸들러에서 간편하게 추출 가능

---

반응형

이 구간은 커스텀 데코레이터의 실사용 예제가 등장하는 중요한 지점입니다.
애드센스 광고를 삽입하면 CTR이 높게 나오는 구간입니다.

<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-XXXXXX"
     data-ad-slot="YYYYYY"
     data-ad-format="auto"
     data-full-width-responsive="true"></ins>

---

2️⃣ 예제 2 – @Roles() 데코레이터 + Guard 연동

✅ Roles 데코레이터 정의

import { SetMetadata } from '@nestjs/common';

export const Roles = (...roles: string[]) => SetMetadata('roles', roles);

• NestJS에서는 SetMetadata()를 이용해 데코레이터로 메타데이터를 설정할 수 있음

---

✅ Guard에서 메타데이터 읽기

import { CanActivate, ExecutionContext, Injectable } from '@nestjs/common';
import { Reflector } from '@nestjs/core';

@Injectable()
export class RolesGuard implements CanActivate {
  constructor(private reflector: Reflector) {}

  canActivate(context: ExecutionContext): boolean {
    const roles = this.reflector.get<string[]>('roles', context.getHandler());
    const request = context.switchToHttp().getRequest();
    const user = request.user;
    return roles?.includes(user.role);
  }
}

---

✅ 적용 예시

@UseGuards(RolesGuard)
@Roles('admin')
@Get('admin')
getAdminPanel() {
  return '관리자 전용 페이지입니다.';
}

---

3️⃣ 예제 3 – Header에서 특정 값 추출하는 데코레이터

export const Device = createParamDecorator(
  (data: string, ctx: ExecutionContext) => {
    const request = ctx.switchToHttp().getRequest();
    return request.headers[data.toLowerCase()];
  },
);

// 사용 예시
@Get()
handleRequest(@Device('User-Agent') userAgent: string) {
  return `당신의 브라우저는: ${userAgent}`;
}

---

🧠 실무 팁

상황 추천 데코레이터

사용자 정보 추출	@User()
요청 헤더 정보 추출	@Header('x-...')
역할/권한 설정	@Roles('admin')
메타데이터 분기 처리	@SetMetadata() + Reflector

---

✅ 마무리 요약

기능 설명

createParamDecorator()	파라미터에서 값 추출
SetMetadata()	커스텀 메타데이터 정의
Reflector	Guard, Interceptor 등에서 메타데이터 읽기
재사용성	중복 코드 제거 및 구조화 가능
확장성	Guard, Interceptor, Pipe와 조합 시 강력한 기능 구현 가능

---

 

NestJS Custom Decorator,NestJS createParamDecorator,NestJS SetMetadata,NestJS Roles Decorator,NestJS Reflector 사용법,NestJS 데코레이터 확장,NestJS 사용자 추출,NestJS Request 데코레이터,NestJS 권한 설정,NestJS 실무 구조 설계

---