Spring Boot with STS(Spring Tool Suite)

스프링 프레임워크 개발을 위해서 보통은 이클립스를 많이 활용했습니다. 하지만 이번에 스프링 부트(Spring Boot)를 공부하게 되면서 이왕 별도의 IDE를 써보자는 생각 때문에 Spring Tool Suite(sts)를 사용해보려고 합니다. 본 포스팅은 sts의 설치 및 스프링 부트 프로젝트 실행까지 설명합니다. 설치 환경은 windows7 32bit 기준입니다.

Spring Tool Suite

다운로드

sts는 이클립스(Eclipes)를 기반으로하는 IDE입니다. 스프링 어플리케이션을 개발하는 것에 커스터마이징 되어 있지요. 다운로드는 https://spring.io/tools/sts 링크를 클릭하세요.

실행

다운로드 받은 파일을 압축 해제 이후 내부를 살펴봅시다. 저는 windows7 32bit 기반이고 다운로드 받은 파일명은 spring-tool-suite-3.6.4.RELEASE-e4.4.2-win32.zip입니다.

적절한 위치에 압축을 해제 한 뒤에 구조를 살펴보면 다음과 같습니다.

spring-tool-suite-3.6.4.RELEASE-e4.4.2-win32.zip
  ┗ sts-bundle
    ┗ legal
    ┗ pivotal-tc-server-developer-3.1.0.RELEASE
    ┗ sts-3.6.4.RELEASE

여기서 sts-3.6.4.RELEASE 가 IDE 디렉토리입니다. 해당 디렉토리를 적절한 위치에 이동 후 실행시켜봅시다. 실행파일은 STS.exe입니다. 처음 실행시키면 workspace 디렉토리를 정해달라는 프롬프트가 뜨는데 이것 역시 적절한 디렉토리를 설정합시다.

익숙한 이클립스의 화면이 보이면 sts의 실행까지 완료 되었습니다.

Spring Boot 프로젝트 만들기

프로젝트 생성[1/2]

[File]-[New]-[Spring Starter Project] 순으로 클릭해서 "New Spring Starter Project" 윈도우를 띄웁니다. 여러가지 입력할 내용이 보이는데 여기서는 다음과 같은 설정으로 진행합니다.

Name : demo
Type : Gradle Project
Packaging : Jar
Java Version : 1.7
Language : Java
Boot Version : 1.2.3
Group : org.test
Artifact : demo
Version : 0.0.1-SNAPSHOT
Description : Demo project for Spring Boot
Package : demo
Dependencies : Web

위의 설정 이후 [Next]를 클릭해서 다음단계로 넘어갑시다.

프로젝트 생성[2/2]

프로젝트를 생성할 위치를 결정하고 [Finish]를 클릭해서 프로젝트 생성을 완료합시다.

Gradle Project 선택시 오류

만약 "Can not use Gradle: STS Gradle Tooling is not installed. You can install it from the STS Dashboard."라는 오류 문구가 나온다면 Gradle 플러그인을 설치해야 합니다. 다음과 같은 순서로 실행해봅시다.

1. [Help] - [Dashboard] 를 클릭합니다.
2. 대시보드 하단의 "Help and Documentaion"에서 Extensions을 클릭합니다.
3. 검색창에서 "Gradle"을 입력합니다.
4. 검색 결과중 "Gradle Support"라 되어 있는 항목을 선택해 설치합니다.
5. sts를 재시작합니다.

더욱 자세한 설치 방법은 이곳에서 확인이 가능합니다.

Gradle Exception 오류

"Gradle Exception: Unable to start the daemon process." 같은 오류가 나온다면 Gradle 옵션을 설정해줘야 합니다. 다음과 같은 순서로 해결합시다.

1. [Window] - [Preferences] 선택
2. 좌측 [Gradle] 탭에서 [Argruments] 탭 선택
3. 오른쪽에서 JVM arguments 부분 "Use" 선택
4. -Xms128m -Xms256m 입력
5. 저장

포스팅 작성 당시 제가 겪었던 오류 메시지는 아래와 같습니다.

GradleException: Unable to start the daemon process. This problem might be caused by incorrect configuration of the daemon. For example, an unrecognized jvm option is used. Please refer to the user guide chapter on the daemon at http://gradle.org/docs/2.2.1/userguide/gradle_daemon.html Please read the following process output to find out more: ----------------------- Error occurred during initialization of VM Could not reserve enough space for object heap Error: Could not create the Java Virtual Machine. Error: A fatal exception has occurred. Program will exit. java.lang.reflect.InvocationTargetException

프로젝트 구조

프로젝트 생성이 끝났다면 sts의 좌측에 demo 프로젝트가 보일겁니다. demo 프로젝트의 구조는 다음과 같습니다.

demo
  ┖ .gradle
  ┖ .setting
  ┖ bin
  ┖ build
  ┖ src
  ┖ .classpath
  ┖ .project
  ┖ build.gradle

HelloController 추가하기

웹 애플리케이션 구동하기 전에 HelloController라는 이름으로 컨트롤러를 만듭시다. 위치는 demo/src/main/java/demo/HelloController.java 입니다. 코드는 다음과 같습니다.

package demo;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.RequestMapping;

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

Spring Boot App Start

이제 컨트롤러까지 추가를 했으니 Run 메뉴를 통해서 웹 어플리케이션을 실행하고 http://localhost:8080 을 접속해봅시다.

Hello World!

위의 문구가 보이면 제대로 처리가 된 것입니다. :)

Closing Remarks

Spring Boot와 Gradle의 조합이 참 깔끔하네요.