[Spring] 스프링 입문 - 코드로 배우는 스프링 부트, 웹 MVC, DB 접근 기술 1. 프로젝트 환경설정

💡 본 게시글은 김영한님의 인프런(Inflearn) 강의 스프링 입문 - 코드로 배우는 스프링 부트, 웹 MVC, DB 접근 기술에 대한 수강 기록용으로 작성되었습니다.

1. 프로젝트 생성

1-1. 스프링 부트(Spring Boot) 버전

• 'SNAPSHOT'은 아직 개발 중인 버전이다.
• 'M(Milestone)'은 정식 릴리즈 전 사용자 테스트 버전을 말한다.
• 별도 표기 없는 것이 바로 정식 릴리즈 된 버전으로, 안정성 높은 스프링 라이브러리를 제공한다.

---

1-2. 프로젝트 메타데이터

• Group은 com.reminder와 같이 대개는 기업의 도메인 주소를 작성하는 란이다.
• Artifact는 빌드돼 나오는 프로젝트 결과물의 이름을 지칭한다.

---

2. 라이브러리 살펴보기

❗ 그레이들(Gradle)은 의존관계에 있는 라이브러리들을 함께 다운로드해 가져온다. 이때 중복된 라이브러리는 (*) 표식으로 대체된다.

❗ 현업에서 System.out.println()으로 실행 내역을 확인하는 일은 없으며, 대신에 로깅을 쓰게 된다. 로그로 남겨 심각한 에러만 따로 모아 관리할 수 있다는 장점이 있다. 이전에는 slf4j를 많이 썼으나, 요즘은 logback으로 넘어가는 추세이다.

•  spring-boot-starter-web
  • spring-boot-starter-tomcat: 톰캣(웹 서버)
  • spring-webmvc: 스프링 웹 MVC
• spring-boot-starter-thymeleaf: 타임리프 템플릿 엔진
• spring-boot-starter(공통)
  • spring-boot
    • spring-core
  • spring-boot-starter-logging
    • logback
    • slf4j
• spring-boot-starter-test
  • junit: 테스트 프레임워크
  • mockito: 목 라이브러리
  • assertj: 테스트 코드를 보다 편리하게 작성할 수 있도록 도와주는 라이브러리
  • spring-test: 스프링 통합 테스트 지원

---

3. View 환경설정

3-1. Welcome Page 생성

❗ 스프링 부트(Spring Boot)는 정적인 또는 템플릿에 기반한 웰컴 페이지 모두를 지원한다. 실행 시 사전에 설정된 정적 요소 위치로 가 index.html 파일을 탐색한 뒤, 조회된 바가 없다면 그 다음으로 템플릿 형식의 index를 찾는다: https://docs.spring.io/spring-boot/docs/2.7.15/reference/html/web.html#web.servlet.spring-mvc.welcome-page

• 정적 요소 위치인 resources:static/ 폴더 하위에 index.html을 올려두면 웰컴 페이지로서 기능한다.

---

3-2. Thymeleaf 템플릿 엔진

❗ 스프링 부트(Spring Boot)는 프리마커(FreeMarker), 그루비(Groovy), 타임리프(Thyemleaf), 머스타시(Mustache)와 같은 템플릿 엔진 관련 자동 설정 기능이 내재돼 있다: https://docs.spring.io/spring-boot/docs/2.7.15/reference/html/web.html#web.servlet.spring-mvc.template-engines

• 서버 사이드 템플릿 엔진인 타임리프(Thymeleaf) 사용을 위해서는 의존성 추가가 우선되어야 한다.
  • implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'

• 타임리프(Thymeleaf)에서 헤더(header), 푸터(footer) 등 공통 레이아웃을 구분 및 사용하고자 한다면 다음 라이브러리에 대해서도 의존성 추가가 필요하다.
  • implementation 'nz.net.ultraq.thymeleaf:thymeleaf-layout-dialect'

---

3-3. 뷰 리졸버(View Resolver) 통한 화면 동작 원리

• 컨트롤러에서 리턴 값으로 문자를 반환하거든 뷰 리졸버(View Resolver)가 해당 이름을 가진 화면을 찾아 처리한다.
  • 스프링 부트(Spring Boot) 템플릿 엔진 기본 뷰 네임(view name)으로 매핑이 이뤄지는 것이다.
  • resources:templates/ + { view name } + .html

---

4. 빌드하고 실행하기(Windows)

❗ 윈도우 운영체제에서 그레이들(Gradle) 기반으로 빌드하고, 빌드 된 자르(jar) 파일을 실행하는 방법에 대해 서술한다.

• 명령 프롬프트(cmd)를 실행해 프로젝트 폴더가 있는 경로로 이동한다.
  • 찾고자 하는 폴더가 D드라이브에 있을 경우 다음과 같이 써서 D드라이브를 가리킬 수 있다: D:
  • cd(change directory) 명령어 통해 디렉토리를 가리킨다. 예를 들어 C드라이브의 'study/hello-spring' 폴더 하위에 프로젝트가 존재한다고 가정하자. 이때 단일 명령으로 cd study, cd hello-spring, cd hello-spring처럼 타고 타고 들어갈 수 있게 작성할 수도 있고, 다음과 같이 일괄적으로 쓸 수도 있다: C:\Users\User>cd study\hello-spring-hello-spring

빌드 전/빌드 후

• 빌드를 진행시키는 명령어로서 다음과 같이 작성한다: gradlew build
  • BUILD SUCCESSFUL 결과가 보이면 빌드가 성공리에 마쳐진 것이다.
  • 만약 위 명령어로 원활한 실행이 어렵다면 gradlew clean build를 써서 대신할 수 있다.
  • 반대로 gradlew clean은 기존에 빌드된 내역을 삭제하는 명령어이다.

• 빌드 된 결과물에서 라이브러리가 들어있는 폴더로 이동한다: cd build/libs
• 이때 디렉토리 안의 상세 구성을 조회하고자 한다면 명령어는 다음과 같다: dir
  • 앞선 빌드 과정에 문제가 없었다면 libs 폴더 하위에 자르(jar) 파일이 생성된 것을 확인할 수 있을 것이다.
• 조회된 이름을 참고해 해당 자르(jar) 파일을 실행시킨다: java -jar 파일이름.jar
  • 여기서는 java -jar hello-spring-0.0.1-SNAPSHOT.jar와 같이 작성하였다.
  • 스프링(Spring) 로고부터 어플리케이션이 실행되었다는 안내말까지 출력된다면 무사히 실행된 것이다.
• 실행한 어플리케이션을 종료시키는 것도 중요하다. 계속 켜둔 상태로 사용하다간 포트 충돌이 발생할 수 있기 때문이다: ctrl + C