🌐 NestJS Execution Context – 다중 프로토콜 지원을 위한 핵심 개념

🌐 NestJS Execution Context – 다중 프로토콜 지원을 위한 핵심 개념

---

NestJS에서 **Execution Context(실행 컨텍스트)**는 HTTP, WebSocket, GraphQL 등 다양한 프로토콜에 걸쳐 공통적인 접근 방식을 제공하는 핵심 개념입니다.
이번 글은 NestJS 공식 문서 Execution Context를 기반으로,
실무에서 Execution Context를 활용하여 다양한 요청 유형을 효과적으로 처리하는 방법을 설명합니다.

💡 "다양한 요청 유형을 하나의 방식으로 처리할 수 있어, 유연한 API 설계가 가능해집니다."

---

✅ Execution Context란?

• NestJS에서 핸들러 메서드가 호출될 때의 실행 환경을 의미합니다.
• HTTP, WebSocket, GraphQL 등 다양한 프로토콜을 동일한 인터페이스로 다룰 수 있습니다.
• Guard, Interceptor, Pipe 등에서 주로 사용됩니다.

---

🧠 Context의 핵심 구조

ExecutionContext {
  getType(): string;
  getClass<T = any>(): Type<T>;
  getHandler(): Function;
  switchToHttp(): HttpArgumentsHost;
  switchToRpc(): RpcArgumentsHost;
  switchToWs(): WsArgumentsHost;
}

🪓 주요 메서드

메서드 설명

getType()	컨텍스트 유형 반환 (http, rpc, ws)
getClass()	현재 컨트롤러 반환
getHandler()	현재 메서드 핸들러 반환
switchToHttp()	HTTP 요청 객체로 전환
switchToRpc()	RPC 요청 객체로 전환
switchToWs()	WebSocket 요청 객체로 전환

---

📦 기본 사용법 – HTTP 요청 처리

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

@Injectable()
export class LoggingGuard implements CanActivate {
  canActivate(context: ExecutionContext): boolean {
    const request = context.switchToHttp().getRequest();
    console.log(`HTTP 요청 경로: ${request.url}`);
    return true;
  }
}

✅ 사용 예시

@UseGuards(LoggingGuard)
@Get('users')
getUsers() {
  return ['user1', 'user2'];
}

💡 switchToHttp().getRequest()를 사용하여 HTTP 요청 정보를 안전하게 추출합니다.

---

📺 광고

Execution Context의 실사용 예제가 나오는 중요한 지점입니다.
애드센스 광고를 삽입하면 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>

---

🌐 다양한 프로토콜 지원 – WebSocket 예제

✅ WebSocket 전환

@Injectable()
export class WsGuard implements CanActivate {
  canActivate(context: ExecutionContext): boolean {
    const client = context.switchToWs().getClient();
    console.log(`WebSocket Client: ${client.id}`);
    return true;
  }
}

✅ 사용 예시

@WebSocketGateway()
export class ChatGateway {
  @UseGuards(WsGuard)
  @SubscribeMessage('message')
  handleMessage(client: any, payload: any): string {
    return 'Message received';
  }
}

💡 switchToWs().getClient()로 WebSocket 클라이언트 정보를 가져옵니다.

---

📧 RPC (Remote Procedure Call) 지원

반응형

✅ RPC 전환

@Injectable()
export class RpcGuard implements CanActivate {
  canActivate(context: ExecutionContext): boolean {
    const data = context.switchToRpc().getData();
    console.log(`RPC 데이터: ${JSON.stringify(data)}`);
    return true;
  }
}

✅ 사용 예시

@GrpcMethod('HeroService', 'FindOne')
findOne(data: { id: number }): string {
  return `Hero with ID: ${data.id}`;
}

---

🚀 실무 활용 – 다중 프로토콜 처리 Guard

@Injectable()
export class MultiGuard implements CanActivate {
  canActivate(context: ExecutionContext): boolean {
    const type = context.getType();
    if (type === 'http') {
      const request = context.switchToHttp().getRequest();
      console.log(`HTTP 요청: ${request.url}`);
    } else if (type === 'ws') {
      const client = context.switchToWs().getClient();
      console.log(`WebSocket 클라이언트: ${client.id}`);
    } else if (type === 'rpc') {
      const data = context.switchToRpc().getData();
      console.log(`RPC 데이터: ${JSON.stringify(data)}`);
    }
    return true;
  }
}

✅ 적용 예시

@UseGuards(MultiGuard)
@Controller('multi')
export class MultiController {
  @Get()
  getData() {
    return 'HTTP 요청 처리';
  }

  @MessagePattern('chat')
  chatHandler(data: any) {
    return 'WebSocket 메시지 처리';
  }
}

---

🧩 Context 활용 전략

상황 사용 방법

HTTP 요청 처리	context.switchToHttp().getRequest()
WebSocket 클라이언트 확인	context.switchToWs().getClient()
RPC 데이터 수신	context.switchToRpc().getData()
다중 프로토콜 처리	context.getType()으로 구분
공통 로직 처리	MultiGuard로 한 번에 처리

---

⚠️ 주의 사항

1. 프로토콜 혼용 주의:
   • 동일 핸들러에서 서로 다른 프로토콜을 사용하는 경우 컨텍스트 변환이 잘못될 수 있음.
2. 컨텍스트 타입 확인 필수:
   • getType()으로 현재 컨텍스트를 반드시 확인 후 처리해야 안전합니다.
3. 프로토콜마다 객체가 다름:
   • HTTP의 request, WebSocket의 client, RPC의 data가 다르므로 명확히 구분하여 사용해야 합니다.

---

🔚 마무리 요약

특징 설명

다양한 프로토콜 지원	HTTP, WebSocket, RPC 등 다중 프로토콜 지원
유연한 컨텍스트 전환	switchToHttp, switchToWs, switchToRpc 제공
실시간 요청 처리	요청 유형에 따라 동적으로 데이터 추출 가능
실무 활용성 극대화	다중 프로토콜 서비스 구축 시 필수 요소

---

 

NestJS Execution Context,NestJS 다중 프로토콜,NestJS HTTP 컨텍스트,NestJS WebSocket 컨텍스트,NestJS RPC 컨텍스트,NestJS Context 전환,NestJS Guard 실무,NestJS 실시간 처리,NestJS 프로토콜 처리,NestJS 고급 가이드

---