[eclipse] Spring Legacy Project - MVC project 생성하는 법

실행환경 - window 10 

최신 개발 환경은 legacy project를 생성하기에 불친절한 부분이 있다.
필자도 Spring legacy project를 생성하기 위해 여러 방법을 시도하였는데, 그 과정에 대해 공유하고자 한다.
개인의 경험을 포스팅한 것이기에, 생략 가능한 과정이나 다른 방법이 존재할 수 있다.

 

STS 설치

우선 이클립스에서 Spring 개발 환경을 구축하기 위해 Spring Tools Suite (aka. STS)라는 플러그인이 필요하다.

플러그인을 설치하기 위해 Help -> Eclipse Marketplace 로 들어간다.

이클립스 상단 메뉴 Help -> Eclipse Marketplace 클릭

 

검색창에 STS를 검색하고 Spring Tools Add-On for Spirng Tools을 찾아, Install.

 

이후 Confirm -> 약관 동의 (I accept the terms ~~) 클릭 후 Finish를 누르면

 

 

백그라운드에서 설치되며 이클립스 오른쪽 하단에서 설치 진행 상황을 볼 수 있다.

 

설치가 완료되면 Restart Now를 클릭하여 이클립스를 다시 시작해주면 STS 설치가 완료된다.

 

 

Spring Legacy Project 생성

이클립스에 STS 플러그인이 설치되었다면 Spring legacy project를 생성해보자.

이클립스 상단 메뉴 File - New - Other 클릭

Spring -> Spring Legacy Project 클릭 후 Next를 클릭.

프로젝트 이름을 설정하고 Spring MVC project를 선택한 후, Next 클릭.
이후 패키지 설정 후 Finish를 클릭.

다음과 같이 Spring project가 생성된다.

 

---

 

Spring MVC project가 없거나 오류가 발생할 때

오류 1. Spring MVC project 없음 -> 1번 -> 3번

오류 2. Spring MVC project 생성 시, 오류 발생 -> 2번

필자는 Spring MVC project가 뜨지 않는 1번의 경우였는데 구글링을 통해 알아본 결과,
이 오류를 해결하는 방법엔 크게 3가지가 있었다.

1. 템플릿 설정
2. JRE 변경
3. 이클립스 버전(2021 - 12) 이전으로 다운그레이드

방법이 뒤로 갈수록 귀찮아지는데, 1번부터 차례대로 살펴보자.

 

1. 템플릿 설정

방금 전, Legacy Project 생성창에서, 파란색 글씨의 밑줄쳐져있는 Configure templates 를 클릭.

중간에 있는 spring-defaults를 제외하고 모두 Remove 해준 뒤,
하단 체크박스 Show self-hosted templates ... 을 체크하고

Apply and Close 를 클릭한다.

 

2. JRE 변경

위의 방법으로 해결하지 못했다면 이클립스에서 사용하는 자바 버전을 확인해보아야 한다.
이클립스 버전이 2021-12 이상이라면 OpenJDK 17 이상의 버전이 내장되어 있을 텐데, 11까지 낮춰서 설정해보자.

 

• 구글에 jdk 11 검색 후, 오라클 페이지로 들어가, (윈도우 기준) x64 installer 을 다운받아 설치한다.

https://www.oracle.com/kr/java/technologies/javase/jdk11-archive-downloads.html

설치 파일을 다운받기 위해서는 오라클 계정이 필요하다.

 

• 설치 파일을 실행하여 jdk를 설치한다. 이때 JDK가 설치되는 경로를 복사해두자.

 

 

• JDK 설치 후, eclipse 가 설치된 폴더에서 eclipse.ini 파일을 텍스트 에디터로 연다.

• 파일의 내용 중, -vm 다음 줄에 plugins/org.eclipse.justj.openjdk.hotspot.jre.full.win32.x86_64_17.0.1.v20211116-1657/jre/bin 를 아까 복사해둔 JDK 설치 경로로 바꿔준다. ( \bin까지 입력한다. )
  -> C:\Program Files\Java\jdk-11.0.15\bin

 

• 이후, 이클립스를 실행하여 Window -> Preference 클릭.
• 왼쪽 카테고리에서 Java -> Installed JREs 선택후,  Add..  -> Standard VM ->  Next

 

• Directory 클릭 후, 아까 복사해둔 JDK 경로를 선택 -> Finish

 

• 추가한 JDK 경로를 체크하여 default로 설정, 나머지 Jdk는 Remove를 눌러 목록에서 지우자.

 

 

 

3. 이클립스 2021-12 이전 버전 설치

필자는 위의 방법을 포함하여 다양한 시도를 해보았지만 해결하지 못했고, 결국 답은 이클립스 버전을 낮추는 것이었다.
이클립스 2022-06 버전을 사용하고 있었는데, 2021-12버전을 사용하니 해결되었다.
정확하진 않지만 IDE 버전이 계속해서 업그레이드 되면서 점점 legacy에 대한 지원을 줄이고 있는 것 같다.

다음 URL에서 이클립스 2021-12 버전을 다운 받고 압축을 풀자.
https://www.eclipse.org/downloads/packages/release/2021-12/r

2021-12 R | Eclipse Packages

이후, 이클립스 마켓플레이스에서 STS 설치 -> 2번 과정(JRE 수정) 까지 수정하면 정상적으로 Spring legacy project가 생성된다.

 

 

ㆍ참고

https://kim-jihoon.tistory.com/24

Spring Legacy Project → Spring MVC Project 생성 시 java.lang.java.lang.ExceptionInInitializerError 발생