JAVA 스프링 세팅하기 Spring Legacy Project 만들기
JAVA 언어를 사용해 예제를 몇 개 만들어 보고자 오랜만에 스프링 세팅을 시작했습니다. 스프링 최신 버전을 보니 Spring4 버전이었으나 익숙한 스프링3로 세팅을 진행하려고 했습니다. 가볍게 생각하고 시작했으나 버전이 바뀌면서 스프링4 버전에서 Spring Legacy Project로 프로젝트를 만드는 것을 전 실패 했습니다.
전 스프링4 버전에선 Spring Legacy Project로 만들 수 없어 버전을 낮춰 세팅에 필요한 파일을 준비했습니다. 시간을 보내며 여러 가지 방법을 시도 했지만, 실패했습니다.
자바 스프링 이클립스 세팅은 버전 호환성에 매우 민감하며 지원하지 않는 버전을 억지로 맞춰서 진행하지 않으시길 추천해 드리고 싶습니다. 스프링4 버전에서는 스프링 부트 방식으로 최신 버전에 맞게 진행하시고 이전 버전의 스타일로(Spring Legacy Project) 진행하시려면 버전을 낮추어서 세팅을 하는 게 가장 좋다고 생각 합니다.
스프링3 버전을 지원하는 이클립스 버전도 명시되어 있습니다. 이클립스가 아닌 다른 프로그램을 사용해 보려고 했지만, JAVA 언어는 이클립스 프로그램과 궁합이 좋다고 생각하기에 이전 버전으로 설치를 진행했습니다. 2020년 9월 이클립스 버전을 받으려 했지만 전 2020년 6월 버전의 이클립스 버전으로 진행했습니다.
JDK 11 다운로드
총 세 개의 파일을 준비하시면 됩니다. JDK(11버전), 이클립스(2020년 6월), 톰캣(8.5) 먼저 JDK 11 버전을 다운로드 받으시려면 https://www.oracle.com/kr/java/technologies/downloads/ 사이트에 접속하시고 JAVA 11 버전으로 JDK를 다운로드 받으시면 됩니다.
팝업창이 하나 나오면 아래 이미지와 같이 다운로드 받겠다고 해주시면 됩니다. 최신 버전과 다르게, 이전 버전은 다운로드 하는데 로그인까지 하라고 합니다.
오라클 계정을 하나 만드시거나 기존 계정으로 로그인 하시면 JDK 11 버전이 다운로드 됩니다.
이클립스 다운로드(2020년 6월)
이번엔 이클립스 파일을 다운로드 하기 위해서 https://www.eclipse.org/downloads/ 사이트에 접속하시고 Download Packages 링크 버튼을 눌러 주세요.
그럼, 아래 이미지와 같이 화면이 나오는데 여기서 Older Versions 링크를 눌러 주세요.
그럼, 날짜별로 이클립스 버전이 표시되는데 여기서 2020-06 버전 링크를 눌러 주세요.
사용하는 환경에 맞춰 링크를 눌러 주시면 이전 버전의 이클립스 파일이 다운로드 됩니다.
톰캣 다운로드(8.5)
톰캣 8.5 버전을 다운받기 위해서 https://tomcat.apache.org/download-80.cgi 사이트에 접속하시고 톰캣도 다운로드 받으시면 됩니다.
JDK 환경 세팅
이제 세팅하기 위해 파일은 모두 준비됐습니다. JDK부터 설치하시면 됩니다.
JDK를 설치하시면 프로그램 파일 폴더에 JAVA 폴더가 생성되어 있습니다.
JDK 설치 후 먼저 환경 변수부터 설정해 놓으시면 윈도우 환경에서 어디서든지 자바 언어가 인식되기에 필수로 해주는 과정인데 설정을굳이 안해도 인식이 되더군요. 그래도 세팅해 놓겠습니다.
고급 시스템 설정 선택.
시스템 속성에서 고급 메뉴에서 환경 변수 선택.
시스템 변수에서 새로 만들기 메뉴를 눌러 주시고 JAVA_HOME 변수에 JDK가 설치된 경로를 넣고 확인.
Path 편집 선택.
새로 만들기(N) 선택 후 방금 추가한 JAVA_HOME 변수를 넣어 주고 확인 선택.
윈도우키+R 버튼을 눌러 실행창에서 CMD 실행 후 java -version으로 JDK 설치가 정상적으로 된 것을 확인했습니다. 환경 변수를 안 잡아줘도 되는 걸 보니 필요 없었던 과정인 것 같기도 한데 그래도 세팅했습니다.
이클립스 세팅
이번엔 다운로드 받았던 이클립스 파일을 압축을 푸시면 됩니다.
압축을 푼 이클립스를 실행 하시면 됩니다.
작업 공간은 편하신 공간으로 선택하시고 Launch 선택.
이클립스 실행 후 Help → Eclipse Marketplace 선택.
sts 검색 후 Spring Tools 3 (Standalone Edition) 3.9.14.RELEASE install 선택.
Confirm 버튼 선택.
동의 하시고 Finish 선택.
Install anyway 선택하시면 이클립스가 자동으로 업데이트가 진행되며 모든 업데이트가 끝나면 이클립스가 재시작됩니다.
업데이트 이후 이클립스가 재시작되면 파일 메뉴 Other 메뉴 선택하시면 됩니다.
Spring 폴더에서 Spring Legacy Project 선택. Next
프로젝트 이름을 넣으시고 Spring MVC Project 메뉴 선택 후 Next
패키지 이름까지 작성하고 Finish 버튼 선택.
마지막으로 Yes 버튼을 눌러 주시면 프로젝트가 생성되게 됩니다.
이클립스 톰캣 세팅
Spring Legacy Project 생성 후 서버를 지정하기 위해 서버 메뉴에서 아래 이미지와 같이 링크 버튼을 통해 서버를 추가하실 수 있습니다.
새로운 서버를 만들때 아파치 폴더에서 다운로드 받았던 톰캣 8.5 서버를 선택 하시고 Next.
다운로드 받았던 톰캣 8.5 버전의 파일 압축을 푸신 폴더 경로를 지정해 주시면 됩니다. JRE는 jdk-11로 지정하고 Finish 버튼 선택.
생성된 서버를 더블클릭하시면 포트를 지정해 주실 수 있습니다. 저는 7070 포트로 수정 후 저장하였습니다.
Modules 탭 선택 후 Add Web Module 선택.
Modules에서 생성된 프로젝트를 선택 하시고 OK 선택.
다시 한번 마지막으로 생성된 모듈에서 Edit 버튼 선택.
Path에서 글자를 지우고 슬러시만 남겨 놓았습니다. 원하는 글자를 마음대로 작성하셔도 됩니다. 마지막으로 OK.
테스트
서버까지 설정 완료 후 실행하시면 됩니다. 프로젝트 폴더에서 src/webapp/WEB-INF/views/home.jsp 페이지를 열고 한글이 깨지지 않도록 코드를 넣어 주시고 Ctrl+S 저장.
그럼 파일 인코딩 방식이 ISO-8859-1인데 이대로 저장해도 괜찮냐고 물어보면 UTF-8로 저장하겠다고 해주시고 나중에 이클립스 세팅에서 UTF-8로 세팅 하시면 됩니다.
프로젝트 선택 후 마우스 오른쪽 버튼을 선택하시고 Run As → Run on Server 선택.
방금 생성한 톰캣 8.5가 선택된 상태에서 Finish 선택.
그럼, 아래 이미지와 같이 Spring Legacy Project로 만든 메인 페이지가 화면에 표시됩니다. 이클립스 화면에서 표시가 안되신다면 인터넷 브라우저를 켜시고 http://localhost:7070/ 포트는 지정하신 포트로 테스트 해보시면 됩니다.
MVC 패턴의 샘플 코드가 이미 작성되어 있어서 메인 페이지 컨트롤러 파일을 만들지 않아도 바로 실행할 수 있었습니다.
JDK 11, 이클립스, 톰캣 파일을 따로 올려 두었으니 필요하신 분들은 다운로드 받아서 진행하셔도 됩니다.
https://drive.google.com/drive/folders/1dgEmOvbMlK2tafQDHkgb4ey3FD9NKeBP?usp=share_link
스프링_세팅파일 - Google Drive
이 폴더에 파일이 없습니다.이 폴더에 파일을 추가하려면 로그인하세요.
drive.google.com
신규 버전 이클립스에서 이전 스프링 버전의 Spring Legacy Project를 사용하는 게 가능할 거라는 생각 때문에 꽤 헤맸던 기억이 납니다. 프로그램 간 버전 호환 문제도 있다 보니 이전 버전에 검증된 세팅 파일로 진행하시길 추천해 드리며 개인적으로도 필요한 자료라는 생각으로 글을 작성해 보았습니다. 스프링 세팅을 하시면서 도움이 되는 내용이었기를 바랍니다.
