Maven 專案建構工具配置與使用完整教程

Maven 專案建構工具配置與使用完整教程

Maven 是一個用 Java 開發的專案建構工具，能將編譯、測試、部署、文檔生成等流程自動化，大幅減輕開發人員的繁瑣配置工作。

1. Maven 是什麼？

專案物件模型為核心，透過 POM (Project Object Model) XML 檔案描述專案所需資源（原始碼、依賴、測試等），實現建構生命週期的標準化管理。

2. 安裝 Maven

• 官網下載：https://maven.apache.org/download.cgi
• 設定環境變數 M2_HOME 指向安裝目錄。
• 終端執行 mvn --version 驗證安裝成功。

3. Maven 核心概念

POM 文件結構

<project xmlns="https://maven.apache.org/POM/4.0.0" ...>
  <modelVersion>4.0.0</modelVersion>
  <groupId>...</groupId>
  <artifactId>...</artifactId>
  <version>...</version>
  <packaging>...</packaging>
  <dependencies>...</dependencies>
  <build>...</build>
  <properties>...</properties>
  <modules>...</modules>
  <profiles>...</profiles>
</project>

Maven 坐標

• groupId：組織或專案唯一 ID，通常用 Java 包根名稱（如 com.pastqing）。
• artifactId：專案名稱（如 web-pay），倉庫中 groupId 目錄下的子目錄名。
• version：專案發布版本號。

建構產物路徑：MAVEN_REPO/com/pastqing/web-pay/1.0/web-pay-1.0.jar

4. Hello World Java 專案實戰

# 產生專案骨架
mvn archetype:generate
# 打包專案
mvn package
# 執行 JAR
java -cp target/helloWorld-1.0-SNAPSHOT.jar com.pastqing.App

5. Java Web 專案與 Tomcat 整合

在 pom.xml 加入 Tomcat 插件：

<plugin>
  <groupId>org.apache.tomcat.maven</groupId>
  <artifactId>tomcat7-maven-plugin</artifactId>
  <version>2.2</version>
  <configuration>
    <url>https://localhost:8080/manager/text</url>
    <server>tomcat7</server>
    <username>admin</username>
    <password>admin</password>
  </configuration>
</plugin>

• 啟動內嵌 Tomcat：mvn tomcat7:run
• 部署到外部 Tomcat：mvn tomcat7:redeploy

6. 多模組專案建構

父 POM 定義模組

<packaging>pom</packaging>
<modules>
  <module>Education-parent</module>
  <module>Education-core</module>
  <module>Education-entity</module>
  <module>Education-web</module>
</modules>

子模組繼承父 POM

<parent>
  <groupId>com.EducationCloud</groupId>
  <artifactId>EducationCloud-parent</artifactId>
  <version>1.0-SNAPSHOT</version>
  <relativePath></relativePath>
</parent>

依賴與插件統一管理

• dependencyManagement：父模組統一定義版本，子模組引用時可省略版本號。
• pluginManagement：統一管理編譯、打包等插件配置。
• properties：定義常量（如 JDK 版本、編碼），引用時用 ${jdkVersion}。

以上操作均可在 IDE 中圖形化完成，更加便捷。