빌드 도구 — Maven과 Gradle 이해하기

[소스 코드] → 컴파일 → 테스트 → 패키징 → 배포
                ↑
         외부 라이브러리 다운로드 & 클래스패스 설정

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0">
    <modelVersion>4.0.0</modelVersion>

    <!-- GAV 좌표: 이 프로젝트의 고유 식별자 -->
    <groupId>com.example</groupId>      <!-- 조직/그룹 ID -->
    <artifactId>my-app</artifactId>     <!-- 프로젝트 이름 -->
    <version>1.0.0</version>            <!-- 버전 -->
    <packaging>jar</packaging>          <!-- 패키징 방식 -->

    <!-- Java 버전 설정 -->
    <properties>
        <maven.compiler.source>21</maven.compiler.source>
        <maven.compiler.target>21</maven.compiler.target>
    </properties>

    <!-- 의존성 목록 -->
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>3.2.0</version>
        </dependency>
        <!-- 테스트에서만 사용 -->
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter</artifactId>
            <version>5.10.1</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

my-app/
├── pom.xml
├── src/
│   ├── main/
│   │   ├── java/          ← 소스 코드
│   │   └── resources/     ← 설정 파일
│   └── test/
│       ├── java/          ← 테스트 코드
│       └── resources/     ← 테스트용 설정 파일
└── target/                ← 빌드 결과물 (자동 생성)

validate → compile → test → package → verify → install → deploy

# 실무에서 자주 쓰는 명령어
mvn compile                    # 컴파일만
mvn test                       # 테스트까지
mvn clean package              # 깨끗하게 빌드 후 패키징 (가장 많이 씀)
mvn clean package -DskipTests  # 테스트 건너뛰기 (급할 때만)

my-app → spring-boot-starter-web → spring-webmvc → spring-core

plugins {
    id 'java'
    id 'org.springframework.boot' version '3.2.0'
    id 'io.spring.dependency-management' version '1.1.4'
}

group = 'com.example'
version = '1.0.0'

// 자바 21 사용
java {
    sourceCompatibility = JavaVersion.VERSION_21
}

repositories {
    mavenCentral()  // Maven Central에서 의존성 다운로드
}

dependencies {
    // 컴파일 + 런타임에 사용
    implementation 'org.springframework.boot:spring-boot-starter-web'
    // 컴파일 시에만 (Lombok은 런타임에 불필요)
    compileOnly 'org.projectlombok:lombok'
    annotationProcessor 'org.projectlombok:lombok'
    // 런타임에만 필요
    runtimeOnly 'com.mysql:mysql-connector-j'
    // 테스트에서만 사용
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

tasks.named('test') {
    useJUnitPlatform()
}

<!-- Maven: 5줄 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <version>3.2.0</version>
</dependency>

// Gradle: 1줄
implementation 'org.springframework.boot:spring-boot-starter-web:3.2.0'

모듈 A (library)
├── api: commons-lang3         → 모듈 B에서도 사용 가능
└── implementation: guava      → 모듈 B에서 사용 불가

모듈 B (application)
└── implementation: 모듈 A

# 자주 쓰는 명령어
./gradlew build        # 컴파일 + 테스트 + jar 생성
./gradlew clean build  # 깨끗하게 다시 빌드
./gradlew bootRun      # Spring Boot 실행
./gradlew dependencies # 의존성 트리 확인

// 커스텀 태스크 정의
tasks.register('hello') {
    doLast {
        println '안녕하세요, Gradle!'
    }
}

my-app
├── A (guava 31.0)        ← 깊이 1: 선택됨
└── B → C (guava 30.0)    ← 깊이 2: 무시됨

// Gradle
implementation('com.example:library-a:1.0.0') {
    exclude group: 'com.google.guava', module: 'guava'
}

<!-- Maven -->
<dependency>
    <groupId>com.example</groupId>
    <artifactId>library-a</artifactId>
    <version>1.0.0</version>
    <exclusions>
        <exclusion>
            <groupId>com.google.guava</groupId>
            <artifactId>guava</artifactId>
        </exclusion>
    </exclusions>
</dependency>

// Gradle: BOM 사용
dependencies {
    implementation platform('org.springframework.boot:spring-boot-dependencies:3.2.0')
    implementation 'org.springframework.boot:spring-boot-starter-web'  // 버전 생략 가능
}

// Gradle: 특정 버전을 강제
configurations.all {
    resolutionStrategy {
        force 'com.google.guava:guava:31.1-jre'
    }
}

my-project/
├── settings.gradle          ← 모듈 목록 정의
├── build.gradle             ← 루트 (공통 설정)
├── core/                    ← 공통 모듈 (엔티티, 유틸)
│   ├── build.gradle
│   └── src/
├── api/                     ← API 서버 모듈
│   ├── build.gradle
│   └── src/
└── batch/                   ← 배치 모듈
    ├── build.gradle
    └── src/

// settings.gradle — 모듈 등록
rootProject.name = 'my-project'
include 'core', 'api', 'batch'

// 루트 build.gradle — 공통 설정
subprojects {
    apply plugin: 'java'
    group = 'com.example'
    version = '1.0.0'

    java { sourceCompatibility = JavaVersion.VERSION_21 }
    repositories { mavenCentral() }

    dependencies {
        compileOnly 'org.projectlombok:lombok'
        annotationProcessor 'org.projectlombok:lombok'
        testImplementation 'org.springframework.boot:spring-boot-starter-test'
    }
}

// api/build.gradle — 하위 모듈
plugins { id 'org.springframework.boot' }

dependencies {
    // 같은 프로젝트의 core 모듈 의존
    implementation project(':core')
    implementation 'org.springframework.boot:spring-boot-starter-web'
    runtimeOnly 'com.mysql:mysql-connector-j'
}

my-project/
├── gradlew              ← Linux/Mac용 실행 스크립트
├── gradlew.bat          ← Windows용 실행 스크립트
└── gradle/wrapper/
    ├── gradle-wrapper.jar
    └── gradle-wrapper.properties   ← Gradle 버전 정보

# gradle-wrapper.properties
distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip

# 버전 업그레이드도 간단하다
./gradlew wrapper --gradle-version 8.6