스프링부트 처음 설정하면서, 나중에 또 삽질 안하려고 처음부터 기록하는 글.
스프링 초보이기 때문에 꽤많이 수박겉핥기, 주먹구구식인 부분이 많을 것이다.
vs code도 처음 사용해보는 거라 더 헤멘듯..
그래도 안하는 것 보단 낫겠지! 라는 마음에 정리해본다. 🤓
틀린 점이 있으면 알려주세요. 감사합니다 ^^
나의 최종(?) 프로젝트 목적
스프링부트를 이용해서 MySQL 데이터베이스와 연결해서
간단한 CRUD 게시판 하나를 만들어보자 !
이번 게시물의 목적
Visual Studio Code를 이용해서 스프링부트 프로젝트를 만들어보자.
목차
- vs Code 다운받기
- 확장팩 설치하기
- JDK 버전 변경하기
- 스프링부트 프로젝트 생성
- 프로젝트 확인
1. VS Code 다운받기
비주얼스튜디오 (https://code.visualstudio.com/) 에 접속해서 운영체제에 맞는걸로 설치하기
나는 M1칩을 탑재한 맥북 에어를 사용하고 있다!
2. 확장팩 설치하기
vs code를 다 설치했다면 실행하자.
좌측에 퍼즐? 테트리스 같은 네모를 누르면
여기서 확장팩들을 설치/삭제 할 수 있다.
✅ 설치해야할 확장팩
- Spring Boot Extension Pack (아래 세 개를 한번에 다운 받아주는 확장팩)
- (또는 Spring Boot Tools / Spring Initializr Java Support / Spring Boot DashBoard 세개 따로 다운 받아도 된다.)
- Extension Pack for Java
- Lombok
3. JDK 버전 바꾸기
확장팩 설치를 다했다면 JDK 버전을 바꾸자.
나는 원래 스프링 레거시 환경이나 기타 웹 프로젝트를 할 때는 자바 1.8 버전을 써왔었다.
당연히 스프링부트에서도 될 줄 알았지만 1.8로 하니
버전 바꾸라고 계속 경고 주길래 결국 11 버전도 설치. 😤
찾아보니 작년 7월쯤 부터 11 버전 이상의 Java를 권장한다고 하는 것 같다.
원래는 JDK를 설치하면 PC 환경변수를 설정해주어야 하는데,
이 작업을 통해 VS Code에서 작업하는 프로젝트에 한해서만 JDK 버전을 바꿀 수 있기 때문에
11버전(혹은 그 외 버전)을 다운 받았다고 해도 따로 PC 환경변수를 변경해주지 않아도 된다고 한다!
설정 - JDK 검색 - Java:Home 항목 의 Edit in Settings.json 클릭
"java.home": "/Library/Java/JavaVirtualMachines/설치한JDK/Contents/Home" 추가
(Mac 사용 시 JDK 경로)
※ json 파일이므로 json 형태 주의해서 입력하기
4. 스프링부트 프로젝트 생성
드디어! 스프링부트 프로젝트를 만들어보자!
프로젝트 생성 방법은 크게 두 가지 (근본은 Initializr로 같음)
(내가 만들) 프로젝트 생성 정보
1. Project : Maven 기반 Project
2. Language : Java
3. Version : 2.5.4
4. Group : com.example (default)
5. Artifact : demo (default)
6. Package : Jar 타입
7. Java : 11 ver.
(방법 1) Spring Initializr 웹을 통해 프로젝트 다운
1) Spring Initializr (https://start.spring.io/) 사이트를 통해 각종 설정을 선택해준다.
✅ Dependencies 추가
여기서 Dependencies를 추가하면, 자동으로 pom.xml 이 예쁘게 생성된다.
지금 뭘 추가해야할지 모르겠다면 지금 안해도 된다. 😄
나중에 pom.xml 이나 dependency 추가하는 부분에서 하면 된다.
내가 일단 생각하기에 가장 기본적으로 필요할 것 같은 것 5개를 추가했다.
- Spring Boot DevTools : 빠른 앱 재실행 지원, 개발 지원
- Spring Web : 웹 개발을 위함, 톰캣 서버가 내장되어 있음
- MySQL Driver, MyBatis Framework : MySQL 연결을 위한 MySQL JDBC와 MyBatis
- Lombok : 어노테이션 라이브러리
2) 하단 Generate 를 누르면 프로젝트가 자동 생성되어 압축파일로 다운받아짐.
그럼 vs code에서 Open만 해주면 끝!
(방법 2) VS Code에서 바로 생성하기
웹 말고 VS Code에서 바로 만들 수 있다.
1) ctrl + shift + P 를 눌러 VS Code 명령창(?) 띄우기 (맥북은 cmd + shift + p)
2) Spring Initializr 입력 후 Maven 프로젝트 선택
3) Spring Boot 버전 선택
- Snapshot은 현재 개발중인 버전.
4) Java 언어 선택, Groud ID, Artifact ID 설정
- Groud ID, Artifact ID가 합쳐져 com.example.demo 패키지명 형식이 만들어지는 것 같다. (이게 의미하는 바는 아직 잘 모르겠다!🧐)
- Artifact ID에 - (Dash)는 안넣어도 된다. (오히려 안넣고 짧은 단어 쓰는게 좋은것 같다...)
5) Dependencies 추가하기
여기서 Dependencies를 추가하면, 자동으로 pom.xml 이 예쁘게 생성된다.
위에 말했던 것 처럼 지금 당장 안해도 되고, 나중에 추가할 수 있다.
추가 해준 것들은 위와 동일.
- Spring Boot DevTools : 빠른 앱 재실행 지원, 개발 지원
- Spring Web : 웹 개발을 위함, 톰캣 서버가 내장되어 있음
- Lombok : 좀 더 편리한 어노테이션 라이브러리
- MySQL Driver, MyBatis Framework : MySQL 연결을 위한 MySQL JDBC와 MyBatis
6) 그 외
프로젝트 이름을 설정하고, 저장 위치를 선택하면 끝!!!
vs code 상단 File - Open 을 통해 프로젝트 열어주면 된다!!
5. 프로젝트 확인
프로젝트 Open을 하고, 프로젝트가 잘 열리는지 확인해보자! :)
원래 프로젝트가 잘 열리는지 확인하고, 테스트 실행 또한 되는지 확인해야 하지만
일단 이번 게시물은 여기까지...다음 게시물에 쓰겠다!
일단 여기까지 ...
여기까지 하는데도 오래 걸리고 어려웠네요.
다음은 프로젝트를 테스트 실행하는 방법을 업로드 하겠습니다.
감사합니다. ^^
