Spring Boot 프로젝트 생성

Git Code 버전 : 0.0.1-SNAPSHOT

Spring Boot 프로젝트를 생성해 기본인 Hello World를 웹페이지에 띄우고, GitHub에 코드를 등록하는 개발 초기 세팅만 정리해 보겠다. 맨 위 Git Code 버전은 블로그에 post 할 때마다 해당 내용을 반영한 코드 버전으로 향후 포스팅을 진행할 때 build.gradle과 메시지를 살펴보면서 해당 버전의 코드를 수행하면 동작을 확인해 볼 수 있도록 할 예정이다.

이번 포스팅을 그대로 수행한다면 git에 등록했을 때 메시지를 직접 등록할 수 없으나 Git으로 관리를 시작한 버전이기 때문에 history를 확인 최초 commit 버전으로 code를 불러오면 테스트 할 수 있다.

초기 프로젝트를 생성하면서 가장 고민했던 것은 Java의 버전이었다. 이 글을 쓰는 지금도 다시 만들어보는 프로젝트인데 Java 대신 Kotlin으로 갈까 하는 고민이 있었지만, 우선은 Java 21 버전으로 정리한다. Java 21 버전을 선택한 이유는 현시점에서 지원 종료 시점이 가장 먼 버전이기 때문이다. Spring boot 프로젝트 생성전 Java는 미리 설치한다.

Spring boot 프로젝트를 생성하기 위해서는 https://start.spring.io/ 사이트에서 생성하는 방법, VS Code에서 생성하는 방법이 있다. 그중 VS Code를 통해서 생성을 했다. VS Code를 통해 Springboot 프로젝트를 생성하기 위해서는 별도의 확장팩을 설치해줘야 하는데 Spring Initializr Java Support, Spring Boot Extension Pack를 설치해 줬다. (아래 그림 참조)

VS Code의 마켓플레이스에서 spring으로 검색하면 나오며 설치버튼을 누르면 된다. 그 밖에 VS Code를 통해 개발할 때 유용한 확장팩도 마켓플레이스를 통해 설치하면 된다. 나는 추가적으로 아래 확장팩들을 설치했다.

Spring Boot Extension Pack
Spring Boot Tools
Spring Boot Dashboard
Lombok Annotations Support for VS Code

설치가 완료되면 「shift + cmd + p」 단축키를 눌러 VS Code 상단에 명령어 터미널을 띄우고 spring을 입력하면, 아래 그림처럼 프로젝트 생성 메뉴인 Spring Initializr: Create a Gradle Project가 검색되면 선택하면 프로젝트 생성과정에 진입한다.

Spring Inmitializr: Create a Gradle Project... 을 선택하면 아래 순서 대로 선택하는 메뉴가 나온다.

Spring Boot Version → 3.4.1 선택
Project Language → Java 선택
Input Group Id → io.personal 입력
Input Artifact Id → stock 입력
packaging type → Jar 선택 (Spring 내장 tomcat을 사용할 예정임)
Java Versin → 21
Choose dependencies (프로젝트에 사용할 라이브러리들 선택)
1. mvc를 입력하면 Spring Web이 검색됨. 검색 결과 리스트를 클릭해서 선택
2. lombok을 입력하면 Lombok이 검색됨. 검색 결과 리스트를 클릭해서 선택

이 상태에서 Search for depenencies에서 그냥 Enter 키를 입력하면 Project를 저장할 위치를 묻는 창이 나옴. 경로 선택 후 생성 4번 Artifact Id란에 입력한 폴더명(여기서는 demo)으로 파일 생성됨
생성이 완료되면 VS Code 폴더열기를 통해 생성된 폴더를 열면 프로젝트가 로드됨

프로젝트 생성을 마쳤으므로 Hello World를 출력하기 위해 Controller를 생성한다. 좌측메뉴에서 java/io/persion/stock의 stock 위 부분에서 우클릭해 새폴더를 선택 controller 폴더를 생성한다. LogniController.java 파일을 생성하고 아래와 같이 입력.(향후 OAuth2 연동을 통해 로그인 아웃동작을 기능을 구현해 줄 예정)

package io.personal.stock.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class LoginController {
    @GetMapping("/")
    public String index() {
        return "Hello World!";
    }
}

VS Code 우측 상단에 "▷" 아이콘이 있는데 클릭해주면 알아서 빌드해서 실행해 준다. 아래는 실행시킨 모습

실행 중간에 보면 Tomcat initialized with port 8080 ..... 하고 log가 출력된다. 크롬 같은 브라우저에 localhost:8080으로 입력하면 아래처럼 결과를 볼 수 있다.

VSCode 상단 중간에 보면 "□"아이콘이 있는데 눌러서 멈춘다. 생성된 프로젝트와 코드의 버전관리를 위해 Git Repository를 생성하고 GitHub에 등록해보자(GitHub 계정은 이미 가지고 있는 것을 전제로 한다.)

VS 좌측 위에서 세번째보면 git logo와 비슷한 아이콘이 있는데 클릭하면 2개의 메뉴가 나온다 하단 "GitHub에 게시"(한글 환경이라 한글로 나옴 영문의 경우 "Publish to GitHub"로 나옴)를 클릭하면(개인적으로 이미 github에 로그인 상태이기 때문 로그인이 안되면 새 브라우저 창이 뜨면서 로그인 창이 뜨고 연동 절차가 진행됨) private public 2개의 Repository 종류를 선택하는데 공개할 예정이라 Public을 선택함