NestJS로 프로젝트 만들어보기 - 1 (nestjs/cli)

Node.js를 사용하고, Typescript를 배우던 와중에 접했던 프레임워크인 NestJS라는 물건을 사용하게 되었습니다.
기존엔 Express를 사용했었고, 그 안에 Typescript를 셋팅하여 프로젝트를 구성했던 것과는 다르게 이 프레임워크를 쓰게되면 기본적인 Typescript 셋팅부터 전체적인 구조까지 프레임워크 생성 커맨드를 통해 기본적으로 제공해줍니다. 공식 문서에서는 아래와 같이 소개합니다.

Nest (NestJS) is a framework for building efficient, scalable Node.js server-side applications. It uses progressive JavaScript, is built with and fully supports TypeScript (yet still enables developers to code in pure JavaScript) and combines elements of OOP (Object Oriented Programming), FP (Functional Programming), and FRP (Functional Reactive Programming).

Under the hood, Nest makes use of robust HTTP Server frameworks like Express (the default) and optionally can be configured to use Fastify as well!

Nest provides a level of abstraction above these common Node.js frameworks (Express/Fastify), but also exposes their APIs directly to the developer. This gives developers the freedom to use the myriad of third-party modules which are available for the underlying platform.

[출처 - https://docs.nestjs.com/]

직접 사용해보면서 느꼈던거지만 약간 Spring 같은 느낌이 있었습니다.
기존에 바닐라 자바스크립트로 구성하던 모양새와는 달리 OOP(객체지향 프로그래밍)의 요소가 강력하게 느껴졌습니다.
공식 문서에서 가이드해주는 시작대로 프로젝트를 생성하면 굉장히 쉽게 웹어플리케이션을 실행할 수 있고, 아주 깔끔하게 프로젝트의 구조가 생성됩니다.

$ npm i -g @nestjs/cli
$ nest new project-name

위와같이 커맨드를 입력하면 package manager로 무엇을 쓸지 물어보는데
그건 취향에 맞게끔 선택하시면 이런 구조의 프로젝트가 생성됩니다.

test모듈과 기타 설정파일들은 제쳐두고 src디렉토리 안에 파일들을 보시면 되는데 기본적으로 세가지의 구성이 있습니다.
물론 일반적인 디렉토리 구조는 아니고 앱을 구동하기 위한 기본 구성만을 생성해줍니다.

• Controller : 컨트롤러는 들어오는 요청을 처리하고 클라이언트에 응답을 반환하는 역할을 합니다.
• Module : Nest가 애플리케이션 구조를 만들때 사용할 수 있는 메타데이터를 제공해주는 역할을 합니다. 내용이 조금 헷갈리는데 굳이 비유를 하자면 Module에 Controller나 Service등을 추가하여 특정 기능을 가지는 모듈로 만들 수 있습니다. 프로젝트 생성시에 기본적으로 만들어진 모듈은 루트모듈입니다.
• Service : 서비스, 말그대로 서비스를 하기위한 로직을 담고있는 역할을 합니다.

---

NestJS는 Typescript를 기반으로 만들어진 프레임워크기때문에 기본적으로 빌드가 필요합니다.
그래서 nest build 명령어를 쓰면 tsconfig 설정을 이용하여 Typescript 빌드를 하고 빌드된 js 파일을 node 명령어로 실행시킬 수 있습니다.
npm 혹은 yarn start 명령어로 실행을 하면 아주 간단하게 3000 포트로 웹어플리케이션 하나가 뜨게됩니다.
시작은 굉장히 간단하죠? 그럼 굳이 이런 프레임워크를 왜 써야할까 싶었는데 사용하다보니 NestJS의 여러 기능들이 있었습니다.
다양한 어노테이션 지원과 아키텍쳐가 명확하고 그에따른 각종 기능들을 공식적으로 지원해주고있기때문에 큰 무리없이 프로젝트를 구성할 수 있었습니다. 이런 부분들은 다른 글에서 담아볼 수 있도록 하겠습니다.