Springboot 빌드 및 실행하기

"시작이 반이다"라는 말이 있듯이, 어떠한 일을 하고자 마음먹었을 때, 당장 시작하는 것만으로도 상당한 진전이 있습니다. 개발환경도 프로그래밍 언어를 익히기 전에, 환경설정 및 프로젝트 빌드 환경 구축하는 것만으로 진도가 많이 나간 것입니다. 

본 포스팅에서는 SpringBoot 프로젝트 빌드 환경 구축 및 실행하는 방법에 관하여 글을 작성합니다.

스프링 부트 프로젝트 빌드, 실행하기

SpringBoot 초기 환경 설정이 작성되어 있는 프로젝트를 spring.io 사이트에서 다운로드하여 IntelliJ로 스프링 부트를 실행하는 것이 실습의 주요 목적입니다. 본 실습은 Java 프로그래밍 언어, IntelliJ IDEA를 통해 진행하므로, 두 가지 언어 및 IDE에 익숙해진다면, SpringBoot를 사용하는데 편할 것 같습니다.

스프링 부트 초기 환경만 설정되어 있는 프로젝트를 다운로드하기 위해서는 https://start.spring.io/ 사이트에 접속하여 다운로드를 할 수 있습니다. 

Spring.io에서 initializr를 통해 프로젝트를 다운로드할 수 있는데, 설정 메뉴를 보시면 Maven 또는 Gradle로 프로젝트 빌드 방법을 선택할 수 도 있으며, 또한 Java 이외에 Kotlin, Groovy라는 프로그래밍 언어로 선택하실 수 있습니다.

Springboot 프로젝트 다운로드

저는 Gradle, Java를 선택하고 프로젝트를 다운로드하였습니다. 이를 IntelliJ로 프로젝트를 열어보면 Gradle빌드에 관련된 build.gradle, gradlew 파일이 있고, src/main/java 폴더에 java로 작성된 소스파일이 있다는 것을 볼 수 있습니다.

Springboot Main 함수

com.example.demo 아래에 있는 DemoApplication을 마우스로 우클릭하면, "Run 'DemoApplication.main()" 메뉴가 있는데 이를 클릭하면 SpringBoot가 실행됩니다.

Springboot Main함수 실행

Springboot 실행 로그

Springboot가 실행되었지만, 웹서버로서 동작은 하지 않습니다. SpringBoot를 활용하여 웹서버 애플리케이션을 개발하기 위해서는 build.gradle파일에서 dependencies 항목에 "org.springframework.boot:spring-boot-starter-web"를 추가해주셔야 웹 서버 애플리케이션으로서 동작을 합니다.

dependencies {
	implementation 'org.springframework.boot:spring-boot-starter-web'
	testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

start-web을 추가한 후, 프로젝트를 close 한 뒤 다시 open 하면 grandle에 명시된 dependecies에 적힌 라이브러리가 자동으로 다운로드됩니다. 그 이후로, springboot에서 사용하는 REST API 구현에 필요한 다양한 함수, 어노테이션을 사용하실 수 있습니다. 

간단한 웹 애플리케이션으로 /hello URL 호출 시, hello 문자열을 출력하는 웹 서버 애플리케이션을 제작해보겠습니다. 아래와 같이 TestController를 작성해줍니다.

TestController 작성

package com.example.demo;

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

/* TestController.java */
@RestController
public class TestController {
    @GetMapping("/hello")
    public String hello(@RequestParam(value = "name", defaultValue = "World") String name) {
        return String.format("Hello  %s!",name);
    }
}

만든 후 DemoApplication을 다시 실행하면, Tomcat started on port(s): 8080 (http) with context path라는 로그를 보실 수 있습니다. 웹서버로 유명한 Tomcat이 실행되었다는 뜻이며, SpringBoot에는 내장된 Tomcat이 있으므로 별도로 Apache Tomcat을 설치하지 않으셔도 웹서버를 실행할 수 있습니다.

애플리케이션 실행 후 웹 브라우저에서 http://localhost:8080/hello에 접속해보면 아래와 같이 Hello World 문자열이 출력되는 것을 볼 수 있습니다.

이제 여러분은 Gradle 빌드 환경에 Java로 작성된 SpringBoot 애플리케이션을 실행할 수 있습니다.