🍀 Spring Boot 초기 세팅 (Maven, Eclipse)

초기 셋팅에 겁먹어서 반 년전에 샀던 책 챕터 1에서 멈춘 상태로 있었는데, 드디어 다시 해보기로 했다. 캡디에서 스프링으로 개발하겠다는 목표로 2주 동안 책 실습 싹 따라가기가 목표다.

사용하는 책은 구멍가게 코딩단의 '스타트 스프링 부트'이다.
내용이나 배운점을 작성하기 보단, 초기 셋팅을 하면서 겪은 시행착오를 블로그에 기록하면서 하면 나중에 같은 문제를 금방 해결할 수 있을 것 같아서 적으러 왔다!
문제의 제대로 된 해결책을 알고 계신 이 글을 읽는 분들은 부디 알려주시길..

---

스프링 부트

스프링 부트는 사실 Ruby on Rails나 Django에 영감을 얻어 만들어진 스프링의 서브 프로젝트라고 볼 수 있다. 이것 저것 설정이나 충돌로 인해 소요하는 시간을 줄이기 위해 환경을 자동으로 제공한다.

사실 스프링을 해보지 않고 스프링 부트를 해도 괜찮을까?에 대한 의문이 있어서 검색을 좀 해봤다.

다들 기초 다지기엔 당연히 스프링이 맞지만, 그래도 한번에 너무 많은 것을 배워야 할지도 모르니 프로젝트를 빨리 진행하려고 하는거면 스프링 부트를 공부하란다. 이런 차원에서 어차피 맞는 것 같았다. 스프링은 캡디 이후에 다시 공부하자!

Serverlet / JSP

이 쯤 책을 읽다가 처음 보는 용어가 등장했다.
두 단어의 기능은 같은데 맡은 역할이 다르다고 한다.
Serverlet은 Java코 드 안에 HTML 코드가 존재,
JSP는 HTML 코드 안에 Java 코드가 존재하는 형태이다.

---

Chapter 1

프로젝트 셋팅

일단 이것저것 설치를 했다. Intellij가 요즘은 유행이라지만 초심자에게는 책 그대로를 따라가는게 나을 것 같아 이클립스로 진행했다.

설치 후 Spring Starter Project를 이용해 프로젝트를 생성한 뒤, Run As Spring Boot App 해보았다.

짜잔 초기 화면..
이 화면을 보기까지 꽤나 오래 걸렸다..

단순히 프로젝트를 생성하고 실행해 보는 것 뿐인데, Run As 에서 none applicable이 떴다

일단 Eclipse Marketplace에서 Eclipse Web Developer Tools를 설치했다.

로그를 보니 pom.xml이라는 파일에서 오류가 나고있었다.
검색 결과 .m2 파일을 싹 다 지워라 또는 https로 호출을 바꿔라 기타 등등을 요구하던데 해결방법은 그게 아니였다.
Maven dependancy를 등록하고 maven install -> refresh -> maven update project를 진행했고 해결되었다!

한참의 다운로드 끝에 초기 화면이 성공적으로 떴다!
스프링 부트 배너 변경하는 방법도 다양하다는데, 중간에 한 번 해봐야겠다!

정상적으로 로딩 되었는지 8080포트와 마지막 Started 로그까지 확인!

SampleController를 이용해서 /hello에 맵했다. 그 결과 이렇게 만물 공통 Hello World를 로컬에서 확인할 수 있었다.
여기서 별다른 가공없이 단순히 문자열만 나오는 이유는 RestController를 사용했기 때문이라고 한다.

책이 스프링을 조금은 해본 사람을 위한 것 같아서 나 같은 사람에게는 조금 어려운 점도 있었지만, 아장아장.. 재밌다.. 공부를 열심히 하자..

---

Lombok

책 그대로 Lombok을 설치한다.
Eclipse 폴더의 eclipse.ini에

-vm
C:\Program Files\Java\jdk-15.0.1\bin\javaw.exe
--launcher.library
C:\Users\비밀\.p2\pool\plugins\org.eclipse.equinox.launcher.win32.win32.x86_64_1.2.400.v20211117-0650

이런식으로 각자 환경에 맞게 추가하면 lombok.jar 파일이 알아서 딱 들어와 있다!
클래스를 작성하는데 있어서 약간의 코드만 작성할 수 있도록 해주는 역할을 한다.

---

Chapter 2

디비 셋팅

2장은 책이랑 다른게 많아 힘들었던 챕터다...
프로젝트 셋팅을 완전 밑바닥부터 시작한 건 처음인지라 따라하기만 바빴는데, 2017년 책이 집필된 이후에 많이 바뀌어서 버전 맞추는게 어려웠다. deprecated 된 것도 많아서 계속해서 검색이 필요했다! ㅠ

먼저 mysql 생성하고 application.properties 작성하는데 이 과정부터가 고난의 시작이였다.

1. com.mysql.jdbc.Driver 빨간 줄
   => com.mysql.cj.jdbc.Driver
2. Public Key Retrieval is not allowed
   => 이전 버전에서는 괜찮았지만 이제는 url 뒤에 &allowPublicKeyRetrieval=true를 붙여줘야한다고 한다
3. Error creating bean with name 'entityManagerFactory'
   => 이 친구.. 일단 pom.xml에 다음 dependancy를 추가해야 한다.

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
		
<dependency>
	<groupId>com.h2database</groupId>
	<artifactId>h2</artifactId>
	<scope>runtime</scope>
</dependency>

또 이후에도 같은 에러가 발생한 적이 있는데, 그 때부터는 셋팅은 제대로 된 상태였고 내 실수였다! Annotation에 오타가 나거나 이름을 잘못 쓴다거나 import를 잘못했거나 뭐 그런 실수가 있었다.

이 세가지 문제를 해결하고 나니 서버는 돌아갔다.
다만 디비 연결이 되지 않았다. 남은 문제들은 전부 같은 오류였다.
Access denied for user 'jpa_user'@'localhost' (using password: YES)

비밀번호가 맞는데 계속해서 문제가 발생했다.
root로 접속해서 새로 user를 생성하고 권한을 준 뒤 flush privileges 해도 아무런 변화도 없었다ㅠ

비밀번호가 8자 이상이 맞는지, ip에 접근 권한이 없는건지, 버전이 다른건지
이것저것 고민하고 검색하고 시도해보느라 시간을 엄청 보냈는데.. 결과는 참혹했다.

그냥 삽질X삽질X삽질 하고 있었다 나는..
Bitnami WAMP 확인 하니 MySQL과 Apache 서버가 켜져 있더라...

서버를 다 끄고 나니 드디어 연결이 되었지만, 테이블이 생기지 않았다.
여기서 발생한 에러는

4. Error excuting DDL
   => 버전을 맞춰서 spring.jpa.database-platform=org.hibernate.dialect.MySQL8Dialect로 변경!
   이 와중에 한번 더 에러가 났는데 저 Dialect 뒤에 스페이스가 하나있어서...오마이가쉬 이런거 주의하자!

<최종 application.properties>

spring.jpa.database=mysql
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/jpa_ex?useSSL=false&serverTimezone=Asia/Seoul&allowPublicKeyRetrieval=true
spring.datasource.username=jpa_user
spring.datasource.password={비밀번호}

spring.jpa.hibernate.ddl-auto=create
spring.jpa.generate-ddl=false
spring.jpa.show-sql=true
logging.level.org.hibernate=info
spring.jpa.database-platform=org.hibernate.dialect.MySQL8Dialect

고난과 역경 끝에 멀쩡하게 테이블 생긴거 확인! 성공!
여기서 ddl-auto=create는 기존 테이블 삭제 후 다시 생성이라고 한다.
지금은 책 따라 이렇게 작성했지만 이후에 update로 바꾸어 주었다.

---

레포지토리

여기서 발생한 문제는 뭐 코드 쓰는건 쭉 따라했지만 JUnit test 실행이 안됐다.

dependancy 추가해도, 전처럼 maven update project도 해봤다.
요상하게 JUnit에 기록은 있는데 초록이든 빨강이든 성공/실패 여부가 전혀 안뜬다.

이쯤되면 당연히 버전 문제겠거니 했지만 어떻게 해결하느냐가 문제였는데 run as configuration가서 Junit 5로 되어있는걸 4로 바꾸어줘야 했다.
다음과 같이 SQL이 수행된걸 확인할 수 있었다!

"아니 근데 매번 이렇게 바꿔 줘야하나? 귀찮다"라는 생각이 들면서, 그냥 프로젝트 자체 라이브러리를 5로 변경해주니까 매번 할 필요는 없었다! 편-안

이 시점에서 여려 테스트들을 실행하기 위해 위에서 언급한 ddl-auto를 create -> update로 변경했다.

Spring boot 2.x부터는 findOne이 없어지는 바람에 boardRepo.findById(1L).get(); 형태로 바꾸어 주면 된다.
이유는 findById의 return type이 Optional 이기 때문!

다 작성하고 실행하려고 하면 pom.xml Qdomain 설정에서 execution 에러가 뜬다. 아래와 같은 메이븐 리소스 플러그인을 추가하면 된다.

<!-- https://mvnrepository.com/artifact/org.apache.maven.plugins/maven-resources-plugin -->
<dependency>
     <groupId>org.apache.maven.plugins</groupId>
     <artifactId>maven-resources-plugin</artifactId>
     <version>3.0.2</version>
 </dependency>

또는 프로젝트 우클릭 이후 RunAs -> Maven install(build), Maven -> update project 해도 가능하다.

그래도 계속 해결이 안돼서 위에 추가했던 dependancy의 버전에 계속 워닝이 떴었는데 그거 지우니까 해결됐다.