Spring Boot) 개발환경 셋팅 / Spring Boot 3 프로젝트 생성

1. IntelliJ community edition 에디터 설치 

 

구글에 검색해서 IntelliJ community edition을 설치합시다.

개발환경 셋팅을 덜해도 되고 디자인 깔끔한 에디터라 이걸 쓸 것인데

무료버전이라 HTML, CSS, JavaScript 하이라이트가 안되고 코드변경시 자동 재실행도 잘 안되는 단점이 있는데 못 쓸 정도는 아닙니다.

꼬우면 한달에 20달러 내고 ultimate edition 이라고 유료버전 씁시다.

아마 대학생이면 Jetbrains 사이트에서 무료로 키 발급이 가능합니다.

아무튼 설치 끝났으면 기념으로 에디터 열어봅시다.

 

 

 

 

 

2. Spring initializr 에서 프로젝트 만들기

 

에디터 유료버전이면 에디터에서 Spring boot 프로젝트를 만들 수 있긴 한데 

우리는 거지기 때문에 다른 방법을 써봅시다.

https://start.spring.io/ 사이트 들어가면 셋팅완료된 프로젝트를 하나 만들 수 있습니다.

 

 

 

 

 

▲ 1. Gradle과 Spring Boot 3.x 버전 고르면 됩니다. 소괄호 붙어있는 버전만 피합시다.

2. 오른쪽에 기본 라이브러리 설치도 할 수 있는데 Spring Web / Spring Boot DevTools 골라줍시다.

3. Group에는 회사명, Name에는 프로젝트명을 자유롭게 작명하면 됩니다.

4. 그리고 Java 17 이나 21을 사용합시다.

남자답게 22 이상의 버전 써도 되는데 너무 신버전 쓰면 AWS 배포시 신버전 지원안해서 문제생길 수도 있고 에디터에서도 뭔가 이상할 수 있으니 그건 남자답게 감수해야합니다.

5. 다운받아서 압축풀어봅시다.

이제 에디터에서 그 프로젝트 폴더 오픈하면 코딩시작할 수 있음

 

 

 

 

 

 

3. 에디터에서 프로젝트 오픈

 

 

▲ 에디터 켜면 폴더 오픈메뉴가 있는데

방금 다운받아서 압축푼 스프링 프로젝트 폴더를 오픈합시다.

이제 코딩하면 되는데 그 전에 셋팅할게 3개 정도 있습니다.

 

 

 

 

 

 

4-1. SDK 버전 확인

 

 

 

상단 메뉴에서 파일 - project structure 메뉴 열어서 SDK가 프로젝트의 자바 버전 이상인지 확인합시다.

예를 들어 프로젝트 자바 버전을 17로 골랐으면 SDK 버전도 17 이상만 되면 됩니다.

낮으면 이거저거 눌러보면 새로 다운로드 가능

 

 

 

 

 

 

4-2. build tool 선택

 

선택사항입니다.

상단 메뉴에서 파일 - Settings 메뉴 열어서 'gradle' 메뉴를 검색해봅시다.

 

 

그럼 Build and run 할 때 뭘 쓸지 선택가능한데

Gradle 말고 IntelliJ IDEA 선택하면 약간 더 빠르고 버그가 적을 수 있습니다.

근데 코드짤 때 뭔가 이상하면 그냥 다시 들어와서 원래대로 Gradle로 바꿔서 씁시다.

 

 

 

 

참고로 IntelliJ IDEA로 바꿔놓을거면

Java Compiler 메뉴에서 저렇게 -parameters 라고 추가해놔야 잘됩니다.

- 스프링 부트 3.2 버전 이상부터는 저래야함

- 참고로 프로젝트 폴더에 out 폴더가 이미 있으면 안될 수 있으니 한 번 삭제해봅시다.

- 에디터에 Java Compiler 항목이 없으면 build.gradle 파일 열어서 

compileJava {
  options.compilerArgs << '-parameters'
}

이런 코드 하단에 추가하면 될 수도 있습니다.

 

 

 

 

 

4-3. 테마

 

강의에서 쓰는 에디터 테마는 One Dark Native인데 영상이랑 깔맞춤하려면 그거 설치합시다.

파일 - Settings - Plugin 메뉴에서 새로운 테마 설치할 수 있습니다.

 

 

 

 

 

 

프로젝트 파일들 설명 

 

src 폴더 : 실제로 코드 짜는 곳

resources 폴더 : HTML CSS JavaScript 이미지 등 하찮은 파일 보관소

application.properties 파일 : 환경변수나 프로젝트 설정 보관하는 곳

build.gradle 파일 : 프로젝트 이름, 버전, 라이브러리 등 기록용 파일

gradle 어쩌구 : gradle이라는 작업자동화 프로그램 돌리는거 도와주는 파일들이라 건드릴 일 없음

 

 

 

 

 

Q. 에디터에서 코드가 전부 회색이에요

- 에디터 설정에서 자바 SDK 버전을 변경해봅시다. SDK 버전을 21로 좀 낮춰보거나 프로젝트 버전과 SDK 버전을 동일하게 맞춰봅시다.

- 안되면 스프링 프로젝트 생성시 자바 버전을 낮춰봅시다.

 

 

Q. 프로젝트 실행이 안돼요

- 이것도 자바 SDK 버전이 낮거나 너무 최신이라 생기는 문제일 수 있습니다.

- 프로젝트를 이상한 onedrive 폴더나 이름 이상한 폴더에 두면 안됩니다.

- 이상한 보안프로그램 끕시다.

 

 

Q. gradle plugin api version 어쩌구 에러가 나요

- Settings 메뉴 들어가서 Gradle 메뉴 - Gradle JVM 부분의 SDK 버전을 높여봅시다.