Gradle: 활용한 Spring Boot 프로젝트 설정 및 실행 가이드

🎯 왜 이 조합이 최고일까?

Spring Boot 덕분에 Java 애플리케이션 개발이 훨씬 간편해졌어요. 복잡한 설정 없이 빠르게 개발할 수 있고, 성능도 꽤 괜찮아서 요즘 대세죠. 그런데 여기에 Gradle까지 활용하면? 빌드 속도가 확 빨라지고, 관리도 훨씬 쉬워지는 완벽한 조합이 됩니다! 이 가이드에서는 어렵지 않게 Spring Boot 프로젝트를 Gradle로 설정하는 법을 설명해드릴게요. 따라오기만 하면 됩니다! 😊

 

---

 

Gradle: 활용한 Spring Boot 프로젝트 설정 및 실행 가이드

 

1. Spring Boot 프로젝트 시작하기

Step 1: Spring Tool Suite(STS) 실행하기

STS(스프링 툴 스위트)는 Spring 프로젝트를 편리하게 개발할 수 있도록 도와주는 IDE예요. 아직 설치하지 않았다면 여기에서 다운로드 후 설치하세요!

 

STS를 실행한 후:

1. File 메뉴에서 New → Spring Starter Project 선택!

 

Step 2: 프로젝트 설정하기

1. 프로젝트 이름: spring-boot-demo
2. 빌드 시스템: 기본값 Maven을 Gradle로 변경
3. Gradle 버전: 최신 버전 선택 (최신이 최고!)
4. 패키징 방식: JAR (필요한 모든 것 포함해서 실행 가능하게!)
5. Java 버전: 현재 사용 중인 버전 선택
6. 그룹 이름: com.bharath.gradle
7. 패키지 이름: 그룹 이름과 동일하게 설정
8. Next 클릭하고 진행!

 

Step 3: 필요한 기능 추가하기

이제 프로젝트에 필수적인 기능을 추가할 차례예요:

1. 검색창에 Spring Web 입력
2. Spring Web 선택 (REST API 만들려면 필수!)
3. 데이터베이스까지 다룰 거라면 Spring Data JPA 추가 (선택사항)
4. Finish 클릭하면 프로젝트 생성 완료!

 

---

 

2. 프로젝트 내부 구조 한눈에 보기

프로젝트를 생성하면 여러 폴더가 보일 거예요:

• src/main/java : Java 코드 작성 공간
• src/main/resources : 설정 파일 및 정적 리소스 저장소
• build.gradle : Gradle 설정 파일 (핵심!)
• gradlew, gradlew.bat : Gradle 실행용 스크립트
• gradle/ : Gradle 관련 설정 모음
• settings.gradle : 프로젝트 설정 파일

 

💡 build.gradle 핵심 체크포인트

필수 플러그인!

plugins {
    id 'org.springframework.boot' version '3.0.0'
    id 'io.spring.dependency-management' version '1.0.11.RELEASE'
    id 'java'
}

• org.springframework.boot: Spring Boot 기능 추가
• io.spring.dependency-management: 의존성 자동 관리
• java: Java 프로젝트 선언

 

필요한 의존성 추가!

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

• spring-boot-starter-web: REST API 개발 필수!
• spring-boot-starter-test: JUnit 포함한 테스트 기능 제공

 

저장소 설정!

repositories {
    mavenCentral()
}

• 필요한 라이브러리는 Maven Central에서 자동으로 가져옴!

 

---

 

3. 프로젝트 빌드 & 실행하기

Step 1: Gradle 작업 실행하기

Gradle은 프로젝트를 빌드하거나 실행할 때 사용하는 다양한 작업(Task)을 제공합니다.

1. STS에서 Gradle Tasks 창을 엽니다.
2. 프로젝트를 확장해서 필요한 작업을 확인하세요.

 

Step 2: 애플리케이션 빌드!

터미널(또는 명령 프롬프트)에서 실행하면 됩니다:

gradle build

 

JAR 파일을 생성하려면:

gradle bootJar

 

완성된 JAR 파일은 build/libs/ 폴더에 저장됩니다!

 

Step 3: 애플리케이션 실행!

gradle bootRun

STS에서 bootRun 작업을 더블 클릭해도 실행 가능합니다!

 

실행이 성공하면 이런 메시지가 나타날 거예요:

Tomcat started on port 8080

 

이제 브라우저에서 http://localhost:8080/hello로 접속해보세요!

 

---

 

4. 간단한 REST 컨트롤러 만들기

1. src/main/java/com/bharath/gradle 폴더로 이동
2. 새로운 Java 클래스 HelloGradleController 생성
3. 코드 추가!

package com.bharath.gradle;

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

@RestController
@RequestMapping("/hello")
public class HelloGradleController {
    @GetMapping
    public String hello() {
        return "Spring Boot와 Gradle, 정말 편하죠?";
    }
}

4. 애플리케이션 재실행 (gradle bootRun)
5. 브라우저에서 http://localhost:8080/hello 접속!

 

결과:

Spring Boot와 Gradle, 정말 편하죠?

 

---

 

5. Gradle의 의존성 관리!

Spring Boot의 Dependency Management Plugin 덕분에 의존성을 편리하게 관리할 수 있어요.

• 자동 의존성 해결: 필요한 라이브러리를 알아서 가져옴!
• 버전 관리: 최신 버전 유지!
• BOM (Bill of Materials): 종속성 버전을 일정하게 유지!

 

Gradle의 External Libraries에서 추가된 라이브러리를 직접 확인할 수 있습니다.