[📘스프링5] 1. 들어가며 / 2. 스프링 시작하기

Chapter 1 들어가며

첫 장인 Chapter 1에서는 기본적인 Spring에 대한 설명과 개발환경 세팅에 대한 내용이 담겨있었다. 다만, 나는 Mac을 사용하고 있고, 이 책에서는 윈도우 기준으로 설명하고 있어 책의 내용대로 진행하긴 어려웠다. JDK나 기타 필요한 패키지들은 Homebrew로 설치했다. 또, 이 책에서는 이클립스를 사용했지만, 나는 Visual Studio Code를 사용했다.

Chapter 2 스프링 시작하기

두 번째 장인 Chapter 2에서는 스프링을 이용한 자바 프로젝트를 진행하는 과정을 소개하고 있다. Maven(or Gradle) 프로젝트 생성 -> 이클립스에서 프로젝트 임포트 -> 스프링에 맞는 자바 코드와 설정 파일 작성 -> 실행 순으로 과정별 설명을 담고 있다. 적절한 그래프와 캡쳐 화면을 첨부해 쉽게 따라 할 수 있었다.

여기서 문제가 있을 수 있나? 싶었지만 문제가 있었다. 지금은 해결했기 때문에 어떤 오류였는지 오류 화면을 캡처하진 못했지만 결국 설정 문제였다. 하라는 대로 했는데 왜 안 될까 해서 찾아봤다.

1. Gradle dependencies 설정

이 책에서는 build.gradle 파일에서 dependencies 추가 부분을 다음과 같이 작성했다.

dependencies {
	compile 'org.springframework:spring-context:5.2.0.RELEASE'
}

하지만 동작하지 않았다. 뭐가 문제일까 찾아봤다. 문법이 compile 대신 implementation을 사용하는 거로 바뀌었다고 한다. 결국 위의 코드는

dependencies {
	implementation 'org.springframework:spring-context:5.2.0.RELEASE'
}

이런 식으로 써야 했다.

Gradle 3.0 이후부터는 compile 대신 api 사용으로 바뀌었지만, 보안적인 측면에서 api 사용도 지양되는 것 같다. 이유를 찾아보니 모듈 수정 시 rebuild 시간(compile or api: 수정한 모듈이 직접 혹은 간접으로 의존하고 있는 모듈을 모두 rebuild / implementation: 직접적으로 의존하고 있는 모듈만을 rebuild 시간상 implementation이 효율적임)과 모듈의 API 노출 방지(compile: 연결된 모든 모듈의 api가 노출됨, 보안상 좋은 방법이 아님)를 이유로 implementation를 사용하는 것을 권장한다고 한다.

implementation 키워드를 사용하는 거로 바꿔서 될 줄 알았는데 안 되길래 spring-context 버전을 상위 버전으로 바꿔봤다. 그래도 안 됐다.. 왤까...?ㅜ 결정적인 문제는 이게 아니었기 때문이었다. 하지만 책의 내용이 업데이트가 필요한 부분이기 때문에 같이 적어봤다.

2. 버전 문제

결정적인 문제는 버전 문제였다. 이 책이 작성된 시기가 2017년이고 지금은 2023년이다. 책이 출간된 시기의 최신 자바 버전은 Java SE 8이었고 지금은 Java SE 20이다. 이제 막 나온 버전이라 이 버전보다 낮은 버전을 사용한다 해도 19 이하일 것이다. 그리고 내 Mac에 설치된 버전이 14였다. (코딩테스트 환경 컴파일러가 14여서 설치한거로 기억한다) 또, 이 책에서는 Gradle 4.4버전을 쓰고 있었다. 나는 버전 신경쓰지 않고 그냥 Homebrew로 설치해서 7.3 버전을 쓰고 있었다.

책에 적힌대로 설정하고 책에 적힌대로 콘솔에 간단한 메시지를 출력하는 아주아주 간단한 예제였는데 실행이 안 됐다. 뭐야 왜 안돼..? 뭐가 문제지...? 하고 삽질한 결과 작성한 Java 파일에 import가 제대로 안 됐다. 엥 왜지? 하고 다시 보니 build.gradle에서 implementation 한 의존성 관련 모듈들이 Project and External Dependencies 폴더에 추가되지 않았다. 프로젝트를 삭제하고 다시 하고를 반복하다가 오류에서 JDK 17 버전을 사용하라는 문장을 언뜻 본 것 같아 JDK 17 버전을 설치하고 프로젝트를 삭제하고 다시 만들었더니 정상적으로 동작했다. 감동의 눈물을 흘릴 뻔했다.

Gradle 7.3 Release Notes를 확인해보니 이런 문구가 있었다.

This release introduces a declarative test suite API for JVM projects, adds support for building projects with Java 17, and updates the Scala plugin to support Scala 3.

Gradle 버전이 필요로 하는 JDK 버전보다 낮은 버전을 쓰고 있어서 동작하지 않았던 것이었다. 이걸 몰라서.. 이틀을 삽질했다...😭

Chapter 1, 2를 마무리 하며..(+출처 표기)

시작하자마자 삽질이었다. 지금 생각해보면 별거 아닌 것 같지만 시작하자마자 가나다 쓰기 수준의 예제가 동작하지 않아 자괴감이 들었다. 하지만 내가 해냄..! 여기서부터 삽질 일기를 써야겠다고 생각했다.

Gradle compile/implementation 관련 설명 출처 -
(여러 글을 봤지만, 이 블로그 글이 가장 직관적이고 쉽게 설명이 돼 있는 것 같아 참고했다. 의존성 옵션들도 설명되어 있어 참고하기 좋았다.)
https://cantcoding.tistory.com/59

Gradle 7.3 Release Note -
(지금 사용하고 있는 Gradle 버전의 Release Note이다. 혹시나 다음에 또 보게 될 일이 생겼을 때를 대비해 함께 적어둔다.)
https://docs.gradle.org/7.3/release-notes.html