첫 번째 NestJS 애플리케이션 만들기

main.ts 실행: 애플리케이션을 시작하면 npm run start:dev 명령어가 Nest CLI를 watch 모드로 실행하고, Nest는 엔트리 파일인 main.ts를 기준으로 애플리케이션을 부트스트랩합니다.

이 파일의 핵심 코드는 다음과 같습니다.

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  // NestJS 애플리케이션 인스턴스를 생성합니다.
  // 여기서 AppModule은 애플리케이션의 루트 모듈입니다.
  const app = await NestFactory.create(AppModule);
  // PORT가 없으면 3000번 포트에서 수신 대기합니다.
  await app.listen(process.env.PORT ?? 3000);
}
bootstrap(); // bootstrap 함수를 호출하여 애플리케이션을 시작합니다.

NestFactory.create(AppModule)은 import한 AppModule 클래스와 @Module() 메타데이터를 부트스트랩 입력으로 사용합니다. app.listen(...)은 전달받은 포트에서 HTTP 요청을 수신 대기합니다.

현재 공식 TypeScript starter 저장소의 main.ts는 app.listen(3000)을 사용하고, 현재 공식 First Steps 문서는 환경에서 포트를 덮어쓸 수 있는 app.listen(process.env.PORT ?? 3000) 예를 보여줍니다. 이 차이는 버전이나 템플릿에 따라 달라질 수 있으므로, 실제 프로젝트의 main.ts와 실행 로그에 표시된 주소를 기준으로 확인해야 합니다.

AppModule 초기화: main.ts에서 AppModule 클래스를 전달했으므로, NestJS는 이 클래스의 @Module() 메타데이터를 읽어 애플리케이션 그래프를 구성합니다.

import { Module } from '@nestjs/common';
import { AppController } from './app.controller';
import { AppService } from './app.service';

@Module({
  imports: [], // 다른 모듈을 가져올 때 사용합니다.
  controllers: [AppController], // 이 모듈에 속한 컨트롤러를 등록합니다.
  providers: [AppService], // 이 모듈에 속한 프로바이더를 등록합니다.
})
export class AppModule {}

@Module() 데코레이터 안의 controllers 배열에 AppController가 등록되어 있고, providers 배열에 AppService가 등록되어 있는 것을 볼 수 있습니다.

NestJS는 이 정보를 바탕으로 AppController와 AppService의 의존성을 해석합니다. 별도 scope를 지정하지 않은 기본 provider는 애플리케이션 생명 주기에 연결된 singleton으로 조립되고, controller 생성자에 주입됩니다.

요청 처리: AppController 동작: listener 포트를 바꾸지 않았다면 이제 웹 브라우저가 http://localhost:3000으로 요청을 보냅니다.

이 요청은 NestJS 애플리케이션에 도달하고, 등록된 컨트롤러 중 해당 요청을 처리할 컨트롤러를 찾습니다.

import { Controller, Get } from '@nestjs/common';
import { AppService } from './app.service';

@Controller() // 이 클래스가 컨트롤러임을 나타냅니다. 기본 경로는 '/' 입니다.
export class AppController {
  // AppService를 주입받습니다. NestJS가 자동으로 AppService 인스턴스를 제공합니다.
  constructor(private readonly appService: AppService) {}

  @Get() // HTTP GET 요청, 경로가 '/'일 때 이 메서드가 실행됩니다.
  getHello(): string {
    // AppService의 getHello() 메서드를 호출하여 결과값을 반환합니다.
    return this.appService.getHello();
  }
}

@Controller()에 경로 접두사를 지정하지 않았고, @Get()에도 경로가 없기 때문에 이 메서드는 GET / 요청에 매핑됩니다.

AppController 생성자를 보면 private readonly appService: AppService 코드가 있습니다.

이것이 NestJS 핵심 기능 중 하나인 의존성 주입(Dependency Injection)입니다.

AppService는 AppModule의 providers에 등록되어 있고 기본 scope를 사용하므로, NestJS는 보통 애플리케이션에서 공유하는 인스턴스를 조립해 AppController에 주입합니다. 따라서 controller가 new AppService()처럼 직접 인스턴스를 만들 필요가 없습니다.

getHello() 메서드는 주입받은 appService의 getHello() 메서드를 호출합니다.

비즈니스 로직 처리: AppService 동작: AppController의 요청을 받은 AppService가 실행됩니다.

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

@Injectable() // 이 클래스가 프로바이더임을 나타냅니다. (다른 곳에 주입될 수 있음)
export class AppService {
  getHello(): string {
    return 'Hello World!'; // 간단하게 "Hello World!" 문자열을 반환합니다.
  }
}

@Injectable() 데코레이터는 이 클래스가 NestJS의 의존성 주입 시스템에서 관리될 수 있도록 메타데이터를 제공합니다. 실제 주입을 위해서는 이 provider가 현재 module scope에서 사용할 수 있도록 등록되거나 가져와져야 합니다.

getHello() 메서드는 단순히 'Hello World!' 문자열을 반환합니다.

응답 반환: AppService.getHello()가 반환한 'Hello World!' 문자열은 AppController.getHello()로 돌아옵니다. Nest의 표준 응답 처리에서 문자열 같은 primitive 값은 JSON으로 직렬화하지 않고 값 그대로 HTTP 응답에 실어 클라이언트(웹 브라우저)에 전달합니다.