VSCode에서 MAVEN을 사용하여 Spring 프로젝트를 설정하였다.
내용을 작성하기 앞서 현재(2022-02-14) JDK1.7 버전은 Spring과 호환이 안된다는 것을 미리 말해둔다.
(JDK 1.7 버전 사용했다가 고생했다.)
설치 파일
설치해야 될 파일은 VSCode, Tomcat,JDK, MAVEN이다.
각 파일은 위의 URL에서 설치할 수 있다.
환경 변수 설정
JDK, MAVEN은 환경 변수를 설정해주어야 한다.
환경 변수 링크된 사이트에 접속하면 환경 변수 설정을 어떻게 하는지 알 수 있다. 옆과 같은 방법으로 Maven도 환경 변수 설정해주면 된다.
이 후 VSCode에서 JDK, Maven 경로를 연동해주어야 된다.
VSCode 실행 후 파일 -> 기본 설정 -> 설정에 들어가 java라고 검색하면 아래와 같은 화면이 뜨게 된다 거기서 Java > Jdt > Java:Home이 적혀이는 구간을 찾은뒤 Settings.json에서 편집을 눌러 JDK, Maven 경로를 지정해주어야 된다.
- JDK 경로 : "java.jdt.ls.java.home": "JDK 경로 작성"
- mvn.cmd 경로 : "maven.executable.path": "mvn.cmd 경로 작성"
- settings.xml 경로 : "java.configuration.maven.userSettings": "settings.xml 경로 작성"
3가지 경로를 설정해주면 된다.
VSCode 확장팩 설치
이 후 VSCode에서 Spring Boot Extension Pack 설치를 진행하여야 된다. Ctrl + Shift + X를 누르면 확장팩을 설치할 수 있는 탭이 나오게 된다. 여기서 Spring을 검색하면 위에서 얼마안가 Spring Boot Extension Pack 이라는 파일을 찾을 수 있다. 설치해준다.
VSCode Spring 프로젝트 생성
설치가 완료되면 Spring 프로젝트를 생성할 수 있다. Ctrl + Shift + P를 눌러 Spring Initializr: Create Maven Project를 선택한다.
선택하면 버전, 언어, Group ID, Artifact ID 등 여러가지 프로젝트에 대한 정보를 설정할 수 있다. 설정하다 보면 Choose dependencies를 하게 되는데 여기서 프로젝트 용도에 따라서 설정해주면된다. 작성자는 Spring Web, Spring Boot DevTools를 선택하였다.
이 후 프로젝트가 생성될 때 아래 터미널 창에서 생성되는 과정을 볼 수 있다. 내용확인 후 Enter, Y만 눌러주면 된다.
프로젝트가 정상적으로 생성되면 아래와 같이 된다.
여기서 이제 생성한 프로젝트 demo를 Maven을 통해서 War파일로 만든 후 Tomcat Server에 올려서 정상작동이 되는지 확인할 것이다.
먼저 War 파일을 만들기 위해 MAVEN 탭에 있는 demo 파일을 우클리해준 후 Clean -> Install -> Package를 진행해 준다. 진행하다보면 아래와 같은 귀여운 스프링이 보일 것이다.
정상적으로 빌드가 완료되면 프로젝트 폴더 중 target이라는 폴더에 war파일이 생성이 된다.
이 후 다운 받은 Tomcat Server를 TOMCAT SERVERS 탭에 설정한 후 가동시킨다.
생성 된 War 파일을 Tomcat Server에 올리기 위해 War파일을 우클린한 후 Run on Tomcat Server를 눌러주면 서버에 올릴 수 있다.
이 과정이 모두 정상적으로 진행이 되었다면 Http://localhost:8080/폴더명/프로젝트 로 접속하면 아래와 같은 화면이 나올 것이다.
아직 내용을 작성하지 않았기 때문에 위의 화면이 나오는 것이 정상적으로 출력이 된 것이다.
마무리
JDK, Maven, Tomcat, VSCode를 설치하고 환경변수를 설정하는데 까지는 오랜시간이 안걸렸다.
하지만 JDK 1.7 버전이 Spring과 호환이 되지않아 VSCode에서 프로젝트 생성 후 오류가 발생하여 해결하는데 시간을 오래 투자하게 되었다. 구글링을 계속 진행하다가 JDK 1.7이 Spring과 호환이 안되다는 정보를 얻게 되어 1.4로 변경하였더니 바로 실행이 되었다.
앞으로는 특정 프로그램에 잘 작동되는 버전을 미리 알아보고 설정을 진행해야 될 것 같다.
참고 사이트
JDK 환경변수 설정
https://somjang.tistory.com/entry/JAVA-Windows-10%EC%97%90%EC%84%9C-%ED%99%98%EA%B2%BD%EB%B3%80%EC%88%98-%EC%84%A4%EC%A0%95%ED%95%98%EA%B8%B0
JDK 오류
https://study-ce.tistory.com/79
VSCode에서 Spring 시작하기
https://sambalim.tistory.com/67
