Spring Boot 프로젝트, Maven에서 Gradle로 쉽고 빠르게 전환하기!

Spring Boot를 사용하다 보면 빌드 도구로 Maven을 쓸지, Gradle을 선택할지 고민될 때가 있어요. 대부분 Maven이 기본이긴 하지만, Gradle이 점점 인기를 끌고 있어요. 이유는 간단하죠! 더 빠르고, 유연하고, 설정도 간편하니까요.

Maven 프로젝트를 Gradle로 바꿔야 하는데 어떻게 해야 할지 막막하다면, 걱정하지 마세요! 오늘은 쿠폰 서비스와 상품 서비스라는 두 가지 마이크로서비스를 예제로 삼아, 변환하는 과정을 쉽게 설명해 드릴게요.

 

---

 

Spring Boot 프로젝트, Maven에서 Gradle로 쉽고 빠르게 전환하기!

 

왜 Maven 대신 Gradle을 써야 할까요?

Gradle이 더 낫다고 하는 이유가 뭘까요? 한 번 살펴볼까요?

• 더 빠른 빌드 속도! Gradle은 변경된 부분만 다시 빌드하기 때문에 시간을 절약할 수 있어요.
• 간결한 설정 파일 Maven의 XML 형식보다 Gradle의 Groovy/Kotlin 기반 설정이 훨씬 직관적이고 깔끔해요.
• 똑똑한 의존성 관리 패키지 충돌을 더 효과적으로 해결할 수 있어요.
• 확장성과 유연성 Gradle은 다양한 플러그인을 쉽게 추가할 수 있어요.

 

자, 이제 본격적으로 변환 작업을 시작해 볼까요?

 

---

 

1단계: 쿠폰 서비스(Maven) 준비하기

1.1 쿠폰 서비스란?

이 서비스는 할인 쿠폰을 제공하는 마이크로서비스예요. 간단히 말해, 사용자가 쿠폰을 적용하면 제품 가격이 낮아지는 시스템입니다. 먼저 프로젝트를 다운로드하고 파일 구조를 확인해 보세요!

 

1.2 pom.xml 파일 분석하기

Maven 프로젝트에서 가장 중요한 파일이 바로 pom.xml이죠. 여기에는 필요한 의존성이 정의되어 있어요.

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>

    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
    </dependency>
</dependencies>

 

• Spring Boot Starter Web: REST API 개발을 쉽게 할 수 있도록 도와줘요.
• Spring Boot Starter Data JPA: Hibernate를 활용한 데이터베이스 연동이 가능해요.
• MySQL Connector: MySQL과 연결하는 데 필요한 라이브러리예요.

 

1.3 데이터베이스 설정 살펴보기

데이터베이스 연결 설정을 확인하려면 src/main/resources/application.properties 파일을 열어보세요.

spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=root
spring.jpa.hibernate.ddl-auto=update
server.port=9091

 

이 설정을 적용하면 mydb라는 MySQL 데이터베이스를 사용할 수 있어요. 기본 포트는 9091로 설정되어 있습니다.

 

---

 

2단계: Maven에서 Gradle로 변환하기

2.1 Gradle CLI로 간단하게 변환하기

이제 본격적으로 Gradle로 바꿔볼까요? 터미널을 열고 프로젝트 폴더로 이동한 후, 다음 명령어를 입력하면 끝!

gradle init

 

이 명령어를 실행하면:

• Maven의 pom.xml을 Gradle의 설정 파일로 변환해 줍니다.
• build.gradle과 settings.gradle이 자동으로 생성됩니다.
• Gradle 실행을 위한 gradlew 파일도 추가됩니다.

 

2.2 build.gradle 파일 확인하기

변환이 끝났다면, build.gradle 파일을 열어서 필요한 의존성이 잘 들어갔는지 확인해 주세요.

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

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'mysql:mysql-connector-java'
}

 

2.3 Gradle로 실행해보기

이제 Gradle을 활용해 프로젝트를 실행해볼까요? 아래 명령어를 입력하세요.

gradle bootRun

 

포트 9091에서 정상적으로 실행된다면 변환이 성공적으로 완료된 거예요!

 

---

 

3단계: 상품 서비스도 Gradle로 변환하기

상품 서비스는 쿠폰 서비스와 연결되어 쿠폰을 적용하는 기능을 담당하는 또 다른 마이크로서비스입니다. 이 과정도 거의 동일하니 빠르게 진행할게요!

3.1 Gradle 변환 실행

gradle init

 

3.2 build.gradle 수정하기

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'mysql:mysql-connector-java'
}

 

3.3 실행 테스트

gradle bootRun

 

상품 서비스가 9090에서 정상 작동하고, 쿠폰 서비스와 연동이 잘 되면 변환이 성공한 거예요!

 

---

 

마무리하며...

Maven에서 Gradle로 바꾸는 게 어렵다고 생각하셨나요? 막상 해보면 의외로 간단해요. gradle init 한 줄 입력하고, build.gradle만 살짝 수정하면 끝이니까요!

Gradle을 사용하면 빌드 속도도 빨라지고, 설정도 더 유연해져서 개발하는 동안 스트레스 받을 일이 확 줄어들어요. 다음 프로젝트에서도 꼭 활용해 보세요! 필요할 때 언제든 다시 참고할 수 있도록 이 가이드를 저장해 두는 것도 좋은 방법이겠죠? 😉