Spring Boot Gradle 시작하기 - 1. 개발환경 구성, 서버 시작

안녕하세요. 복사장🍗입니다.

 

앞으로 계속해서 스프링 부트 관련 포스팅을 하고자 합니다.

 

스프링 부트를 이용한 웹(API) 서버를 만들 건데요. DB도 붙여보고, 파일 처리도 해보고, 로그도 쌓아보고, 형상관리도 해보고요, 기타 등등 여러 번에 걸쳐 차근차근 진행해보겠습니다. 

 

윈도우 환경의 vs code를 통한 개발환경을 구성할 것이고 관련 소스는 github.com을 통해 공유할 겁니다. 실제 업무에 써도 될 정도의 서버를 구성할 예정입니다. 믿고 따라오세요.

---

1. 환경 구성 - java, vs code 설치

우선 자바와 vs code 설치가 필요하니 아래 링크를 통해 설치를 해주세요.

자바의 경우 스프링 부트 버전에 영향이 미치니 글에 설치한 대로 jdk15 버전으로 설치 바랍니다.

 

[JAVA-openJDK]자바 다운로드 설치방법 / 버전확인

vs code 설치 / 한글 / 한글깨짐 / 단축키

자 모두들 쉽게 설치하셨나요? 😉

 

 

2. 환경 구성 - vs code 확장 프로그램 설치

vs code 확장프로그램 Java Extension Pack(Micosoft), Spring Boot Extension Pack(Pivotal) 2개를 설치합니다. 위에서 한글 팩 설치한 것과 동일하게 설치합니다.

 

 

 

3. 기본 소스 생성

vs code 단축키 F1을 누른 후 Spring Initializer를 입력합니다.

 

첫 번째,  Spring Initializer: Create a Gradle Project... 을 선택합니다.

 

두 번째,  스프링 부트 버전을 선택하라고 나오는데 2.3.4를 선택하세요.(Specify Spring Boot version.)

 

세 번째,  프로젝트 언어는 Java를 선택합니다.(Specify project language.)

 

네 번째, 그룹아이디(Group Id)는 com.tistory를 입력합니다.(Input Group Id for your project.) 보통 생성하려는 웹페이지의 도메인을 거꾸로 적습니다.(com.daum 이런 식...)

 

다섯 번째, 아티팩트 아이디(Artifact Id)를 적습니다. 프로젝트 이름 정도로 생각하시면 될 것 같습니다. 저는 doit1을 적었습니다.

 

여섯 번째, 최종 소스 패키징 타입을 선택합니다. 실행 행태의 JAR를 선택하세요. JAR의 경우 WAS를 가동하는데 필요한 라이브러리를 포함하여 패키징 됩니다.(Specify packaging type.)

 

일곱 번째, 자바 버전을 선택합니다. 우리는 15 버전을 설치했지만 15가 나오지 않아 우선은 최신인 14로 선택합니다.(Specify Java version.)

 

여덟 번째, 필요한 라이브러리를 선택하는 화면이 나오는데요.(Search for dependencies)

Spring Boot DevTools, Spring Web 2가지를 선택합니다.

 

아홉 번째, 프로젝트를 생성할 위치를 지정합니다. 저는 C:\Dev\workspace를 지정하였습니다. 경로지정 후 아래 Generate into this folder를 클릭하세요.

 

열 번째, 파일(F) > 폴더 열기... 를 선택해서 위에서 지정한 경로에 생성된 폴더를 선택합니다. 저는 doit1 폴더를 선택했습니다.

 

프로젝트가 잘 생성되었습니다. build.gradle파일을 열어보니 아까 선택한 2개 라이브러리도 잘 들어왔네요.

 

이로써 프로젝트 구성은 완료하였습니다. 👍

 

 

4. 샘플 Controller 만들기

자 이제 서버를 시작하기 전에 샘플페이지를 만들어 봐야겠죠? 간단히 텍스트를 보여주는 화면을 만들어보겠습니다.

 

첫 번째, 왼쪽 트리 메뉴에서 /src/main/java/com/tistory/doit1에 마우스를 위치하고 우클릭을 합니다. 메뉴가 나오면 새폴더를 선택하고 controller를 입력해 폴더를 생성합니다.

 

두 번째, controller 폴더에 HelloController.java 폴더를 생성하고 아래와 같이 소소를 생성하겠습니다. 페이지에 접속하면 환영 메시지를 보여주는 페이지입니다. @RequestMapping을 "/"로 생성했으니 http://localhost:8080/으로 접속할 때 보여주는 페이지입니다. 

package com.tistory.doit1.controller;

import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestMapping;

@RestController
public class HelloController {

    @RequestMapping(value = "/", method = RequestMethod.GET)
    public String index() {
        return "반갑습니다. doit1.tistory.com에 오신것을 환영합니다.";
    }
}

※ 주의할 점, controller위치가 doit1 폴더 아래에 있어야 합니다. Doit1Application.java 파일에서 Controller를 찾게 되는데 자신의 폴더 하위를 스캔해서 인식하게 합니다.

 

 

5. 서버 실행 - gradle 빌드 실행

첫 번째, 메뉴 터미널(T) > 새 터미널을 클릭합니다. 하단에 터미널이 생성되면 .\gradlew.bat를 입력 후 엔터를 누릅니다.

이는 현재 프로젝트 내에 gradle을 실행할 수 있게 gradle을 설치하게 됩니다.(프로젝트 폴더 내 .gradle폴더가 생성됩니다.)

 

두 번째, 터미널에 .\gradlew bootRun을 입력하여 서버를 실행합니다.

 

세 번째, 브라우저를 통해 http://localhost:8080/을 입력하여 입력한 환영문구가 뜨는지 확인합니다.

네 잘 떴습니다. 하아 하하하 😆

다음 포스팅은 소스를 github에 올려보도록 하겠습니다. 

 

---

도움이 되셨다면 아래 공감, 구독 한번 눌러주세요. 궁금한 점은 댓글로 남겨주세요.

 

감사합니다.

😄