Maven 2 實戰指南：從安裝到部署的完整流程

Maven 2 核心體驗流程

Maven 是一款深化 Ant 並擁有完整專案整合策略的 Java 專案管理工具，當前版本為 2.0.2。本文記錄從安裝、配置到日常操作的完整實踐步驟。

1. 安裝與環境配置

1. 從 Maven 官網下載並解壓縮。
2. 配置環境變數 MAVEN_HOME 並加入 PATH。
3. 執行 mvn --version 驗證安裝成功。

2. 三層配置架構

• 專案層：pom.xml，針對單一專案配置。
• 安裝層：${MAVEN_HOME}/conf/settings.xml，全域安裝配置。
• 使用者層：${user.home}/.m2/settings.xml，個人化配置（本地倉庫、Proxy 等）。

建議優先配置使用者層。範例設定本地倉庫至 d:/repo 並配置 HTTP Proxy：

<localRepository>d:/repo</localRepository>
<proxies>
  <proxy>
    <id>proxy1</id>
    <active>true</active>
    <protocol>http</protocol>
    <host>222.136.91.1</host>
    <port>80</port>
    <nonProxyHosts></nonProxyHosts>
  </proxy>
</proxies>

修改後複製一份至 ${user.home}/.m2。

3. 建立新專案

mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-app

• 自動從遠端倉庫下載必要 JAR 至本地倉庫。
• 產生標準目錄結構（src/main/java, src/test/java）、HelloWorld 範例與 pom.xml。

pom.xml 包含專案物件模型 (POM)，是 Maven 工作的基本單元。

4. 生命週期核心指令

5. 資源檔案管理與過濾

• 主資源：${basedir}/src/main/resources 內容打包至 JAR 根目錄。
• 測試資源：${basedir}/src/test/resources，透過 getClass().getResourceAsStream() 讀取。

資源過濾 允許在資源檔中使用屬性替換。需在 pom.xml 啟用：

<build>
  <resources>
    <resource>
      <directory>src/main/resources</directory>
      <filtering>true</filtering>
    </resource>
  </resources>
  <filters>
    <filter>src/main/filters/filter.properties</filter>
  </filters>
</build>

支援來源：pom.xml 專案屬性（${pom.name}）、settings.xml、外部屬性檔、系統屬性（${java.version}）、命令列參數（-Dcommand.line.prop=value）。

6. 依賴管理

在 pom.xml 宣告依賴：

<dependency>
  <groupId>log4j</groupId>
  <artifactId>log4j</artifactId>
  <version>1.2.12</version>
  <scope>compile</scope>
</dependency>

• scope：compile（預設）、test（僅測試）、provided、runtime 等。
• 查找座標：Google site:www.ibiblio.org maven2 log4j 或瀏覽 Maven 中央倉庫索引。

7. 部署至遠端倉庫

1. settings.xml 配置 <servers> 認證資訊（ID、username、private key/password）。
2. pom.xml 配置 <distributionManagement> 指定遠端 Repository URL (SCP/HTTP)。
3. 執行 mvn deploy。

Eclipse 整合 (m2eclipse)

• 更新站點：https://m2eclipse.codehaus.org/update
• 安裝教學與使用 Demo 參考官網 Flash 演示。

延伸參考資源

• Maven 官方網站
• developerWorks 中國：Maven 2 新特性專題