Eclipse + Gradle 構建 Java Web 專案：從零到自動化依賴管理

Eclipse + Gradle 構建 Java Web 專案：從零到自動化依賴管理

Gradle 以 Groovy/Kotlin DSL 取代冗長 XML，配合 Eclipse Buildship 插件，讓 Java Web 專案的依賴管理、多模組構建、IDE 整合變得優雅高效。本文記錄完整搭建流程。

一、環境準備

1. 下載 Gradle 二進制包，解壓配置 GRADLE_HOME、PATH
2. Eclipse 安裝 Buildship：Help → Eclipse Marketplace → 搜索 Gradle → Install

二、創建 Gradle 專案

1. File → New → Other → Gradle → Gradle Project
2. 指定專案名、Gradle 發佈版本 (Wrapper 推薦)、JDK 路徑
3. 專案結構自動生成 build.gradle、settings.gradle

三、轉為 Dynamic Web Module

右鍵專案 → Properties → Project Facets → 勾選 Dynamic Web Module (版本 3.1+)，自動生成 web.xml、WEB-INF 目錄。

四、配置 build.gradle 依賴管理

plugins { id 'java' id 'war' }  // war 插件支援 Web 打包

repositories { jcenter() }  // 包含 mavenCentral，速度更快

dependencies {
    // Struts2
    implementation 'org.apache.struts:struts2-core:2.3.24.1'
    implementation 'org.apache.struts:struts2-spring-plugin:2.3.24.1'
    implementation 'org.apache.struts:struts2-json-plugin:2.3.24.1'
    // Spring 4.2
    implementation 'org.springframework:spring-core:4.2.3.RELEASE'
    implementation 'org.springframework:spring-web:4.2.3.RELEASE'
    implementation 'org.springframework:spring-orm:4.2.3.RELEASE'
    implementation 'org.springframework:spring-aop:4.2.3.RELEASE'
    implementation 'org.springframework:spring-aspects:4.2.3.RELEASE'
    implementation 'org.springframework:spring-jdbc:4.2.3.RELEASE'
    // Hibernate 5
    implementation 'org.hibernate:hibernate-core:5.0.1.Final'
    // Common
    implementation 'org.slf4j:slf4j-api:1.7.13'
    testImplementation 'junit:junit:4.12'
}

五、自動下載與 IDE 同步

Eclipse 右側 Gradle Tasks 視圖 → build → 雙擊 compileJava 或點擊 Refresh Gradle Project，Gradle 自動解析依賴圖、下載 JAR 到本地倉庫 (~/.gradle/caches)，並更新 Eclipse Classpath。

六、優勢總結

• DSL 簡潔易讀，告別 XML 地獄
• 傳遞性依賴自動解析，版本衝突可視化
• Wrapper 機制保證團隊構建環境一致
• 增量編譯、構建緩存大幅提速
• 原生支援多模組、發佈、測試報表