[Nodejs] Express 구조 뜯어보기

 📌 들어가며

저번 포스팅에서는 node.js와 Express를 이용한 간단한 서버 구축을 해보았습니다.

이번 글에서는 Express 폴더, 파일에 대해 좀 더 자세하게 다뤄보려고 합니다.

 

⬇️ 저번 포스팅 보러가기!

https://ju-hyeon.tistory.com/28

[Server] nodejs, express 서버 구축

 

 📌 Express 구조

​가장 상단의 practice (express 명령어로 만든 프로젝트의 이름) 를 눌러보면

5개의 폴더와 app.js, package.json을 볼 수 있습니다.

 

위에서 부터 하나씩 뜯어보도록 하겠습니다.

 

1. bin 폴더

bin폴더에는 오른 쪽 이미지와 같은 www파일이 있습니다.

이 파일은 서버를 실행하는 스크립트이며 프로젝트에 할당되는 포트 번호를 변경할 수 있습니다.

 

🔴 포트번호 주의 (겹치지 않도록 주의해야 합니다.)

1 ~ 1023: well-known port

1024 ~ 49151: registered port

49152 ~ 65535: dynamic port

 

well-known port란?

국제인터넷주소관리기구인 ICANN에서 TCP, UDP에 할당한 포트 번호입니다.

해당 포트 번호들은 특정 애플리케이션을 사용하기 위해 할당된 포트 번호입니다.

예를 들어, 20번과 21번 포트는 TCP, 22번은 SSH 등이 있습니다.

각 포트는 강제가 아니라 권고 사항이라 할당된 포트 번호를 그대로 사용하지 않고 다른 포트 번호를 사용하기도 합니다.

 

registered port란?

특정 용도로 사용하기 위한 포트 번호입니다.

등록된 포트라는 것은 말 그대로 기업에서 등록해서 사용이 가능한 포트입니다.

예를 들면, 8080번 포트는 HTTP 포트를 대체할 수 있는 포트 또는 MS에서 제공하는 SQL을 사용하기 위한 1433 포트 등이 있습니다.

registered port도 강제가 아닌 권고사항이라 할당된 포트 번호를 그대로 사용하지 않고 다른 포트 번호를 사용하기도 합니다.

 

dynamic port란?

특별히 용도가 지정되지 않았으며, 어느 프로그램에서나 사용이 가능한 포트 번호입니다.

 

포트 설명 출처: https://m.blog.naver.com/kyeong477/221558180792

 

 

2. public 폴더

public 폴더에는 각종 리소스들이 포함되어 있습니다.

이미지, JS파일, stylesheets 파일을 볼 수 있네요!

 

이 폴더는 서버에서 건드릴 일이 없습니다!

 

 

3. routes 폴더

route 폴더에는 페이지 라우팅과 관련된 파일들이 들어있습니다.

주소 별로 라우터들을 모아둔 것이며 URL 별로 실행되는 실제 서버 로직입니다.

 

index.js를 시작으로 관리해주면 됩니다.

이 라우터에 대해서는 제가 주로 사용하던 폴더링 구조에서 확인하시면 이해하기 쉬울 겁니다!

 

 

4. views 폴더

views 폴더에는 jade, ejs 등 템플릿 파일들을 모아 둡니다.

웹 서버 사용 시 해당 폴더의 파일들을 사용해서 렌더링 하는 것입니다.

 

이 폴더도 public 폴더와 같이 서버에서 건드릴 일이 없습니다!

 

 

5. app.js

app.js 파일은 프로젝트의 중심이자 핵심적인 서버 역할을 합니다.

이 파일에서는 미들웨어 관리가 이루어지며 라우팅의 시작점이 됩니다.

 

 

6. package.json

package.json 파일은 저번 포스팅에서 설명한 것과 같이 프로젝트에 사용된 모듈들이 나와있습니다.

 

npm install 명령어를 이용해 해당 파일에 있는 모듈들을 모두 설치할 수 있습니다.

또한 npm <모듈명>을 하게 된다면 package.json 파일에 추가됩니다.

 

 

 📌 마치며

Express처럼 자동으로 생성되거나 타인의 프로젝트 내용을 이해하기 위해서는 폴더, 파일을 뜯어보는 것이 정말 중요합니다!

저도 동아리에서 처음 서버를 공부할 때는 파트장님이 만들어주신 보일러 플레이트를 사용하여 api 코드를 짜는 것에 집중을 했었습니다.

최근에 진행한 서버 프로젝트에서는 정말 모든 파일을 뜯어본 것 같습니다.

시간이 좀 걸려도 이렇게 공부했던 것이 서버 로직 이해 뿐만 아니라 코드 짜는 것에도 도움이 되고, 오류가 나도 어디서 오류가 났고 어떤 것을 수정해야 하는지 알기 쉬웠던 것 같습니다.

api를 짜는 것도 중요하지만 파일을 처음부터 하나하나 뜯어보는 것을 추천드립니다!!!! 파이팅 👏

 

다음 포스팅에서는 firebase functions를 이용한 서버 초기 셋팅 방법, 자주 사용한 폴더링 구조를 공유하도록 하겠습니다.

 

 

 

참고: SOPT 29th 서버 파트 2차 세미나 자료