🎯 NestJS Controller 완전 정복 – 요청과 응답의 모든 흐름 이해하기

🎯 NestJS Controller 완전 정복 – 요청과 응답의 모든 흐름 이해하기

---

NestJS에서 Controller는 클라이언트의 요청(Request)을 받아 서버의 응답(Response)을 반환하는 역할을 합니다.
이 글에서는 NestJS 공식 문서의 Controllers를 한글로 번역하고, 실무 중심의 해석을 덧붙여 설명합니다.

NestJS 백엔드 애플리케이션을 설계한다면 Controller는 반드시 정확히 이해하고 넘어가야 할 핵심 요소입니다.

---

✨ Controller란?

NestJS에서 Controller는 라우팅(경로 처리)과 요청 매핑을 담당하는 계층입니다.
실제로는 @Controller() 데코레이터를 붙여 만든 클래스이며, 여기에 HTTP 메서드(@Get, @Post, 등) 데코레이터를 붙인 메서드들이 클라이언트 요청을 처리합니다.

---

1️⃣ Controller 생성 방법

nest g controller cats

Nest CLI를 이용하면 자동으로 cats.controller.ts 파일이 생성되고, 다음과 같은 기본 구조가 포함됩니다:

import { Controller, Get } from '@nestjs/common';

@Controller('cats')
export class CatsController {
  @Get()
  findAll(): string {
    return '모든 고양이를 반환합니다';
  }
}

해석

• @Controller('cats'): /cats 경로에 대한 요청을 처리
• @Get(): HTTP GET 요청을 매핑

---

2️⃣ 다양한 HTTP 메서드 매핑

반응형

import { Controller, Get, Post, Body, Param } from '@nestjs/common';

@Controller('cats')
export class CatsController {
  @Get()
  findAll(): string {
    return '모든 고양이를 반환합니다';
  }

  @Get(':id')
  findOne(@Param('id') id: string): string {
    return `${id}번 고양이를 반환합니다`;
  }

  @Post()
  create(@Body() body: any): string {
    return `새로운 고양이를 추가했습니다: ${JSON.stringify(body)}`;
  }
}

실무 팁

• @Param(): URL 경로에 포함된 파라미터를 추출
• @Body(): POST 요청의 본문(body)을 파싱
• @Query(): 쿼리 스트링 파라미터를 다룰 수 있음

---

3️⃣ 컨트롤러에서 서비스 호출하기

NestJS는 서비스(Service) 계층을 분리하여 비즈니스 로직을 관리합니다.

@Controller('cats')
export class CatsController {
  constructor(private readonly catsService: CatsService) {}

  @Get()
  findAll(): string {
    return this.catsService.findAll();
  }
}

서비스는 @Injectable()로 선언되며, 컨트롤러의 생성자에서 의존성 주입(DI)으로 연결됩니다.

---

4️⃣ 라우팅 경로 커스터마이징

@Controller({
  path: 'cats',
})
export class CatsController {
  @Get('my')
  getMyCats() {
    return '내 고양이 목록입니다';
  }
}

경로는 문자열로 직접 지정하거나, 오브젝트 형태로도 커스터마이징 할 수 있습니다.

---

📺 광고

이 부분에 AdSense 광고 코드 삽입: 중단 광고 위치 (클릭률이 높은 구간입니다)
예: <ins class="adsbygoogle" style="display:block" data-ad-client="ca-pub-xxxx" data-ad-slot="yyyy"></ins>

---

5️⃣ RESTful API를 설계할 때의 Controller 전략

메서드 경로 예시 설명

@Get()	/cats	전체 목록 조회
@Get(':id')	/cats/1	특정 ID 조회
@Post()	/cats	새 데이터 생성
@Patch(':id')	/cats/1	특정 데이터 일부 수정
@Delete(':id')	/cats/1	특정 데이터 삭제

REST API 설계 원칙에 따라 HTTP 메서드와 URL을 분리하여 표현하는 것이 유지보수와 테스트 모두에 유리합니다.

---

🧠 실제 서비스 구조에서 Controller 역할

1. 요청을 받고
2. 서비스 계층으로 위임하며
3. 필요한 경우 DTO로 유효성 검증을 하고
4. 적절한 응답 또는 예외를 반환하는 구조

컨트롤러는 절대 비즈니스 로직을 직접 다루지 않고, 라우팅과 서비스 연결에만 집중합니다.

---

🔚 마무리

NestJS에서 Controller는 가장 앞단에서 사용자의 요청을 처리하고 응답하는 핵심 구조입니다.
라우팅, 매핑, 요청 데이터 추출, 서비스 연결 등의 패턴을 잘 익혀두면, 유지보수 가능한 구조를 손쉽게 만들 수 있습니다.

---

 

NestJS Controller,NestJS 라우팅,NestJS 요청 처리,NestJS 서비스 연동,NestJS Get Post,NestJS Param Body,TypeScript 백엔드,REST API 설계,Node.js 백엔드,NestJS 실무 예제

---