Maven 常見問題解答

maven常見問題問答

1.前言

Maven，發音是[`meivin]，"專家"的意思。它是一個很好的項目管理工具，很早就進入了我的必備工具行列，但是這次爲了把project1項目完全遷移並應用maven，所以對maven進行了一些深入的學習。寫這個學習筆記的目的，一個是爲了自己備忘，二則希望能夠爲其他人學習使用maven 縮短一些時間。

2. maven概要

首先我把maven的概念快速的梳理一下，讓我們快速地建立起一個比較精確的maven應用場景。

2.1 maven不是什麼

讀書時候要先限定範圍，避免一些有害的遐想。要說maven不是什麼，我們可以從如下幾個要點來展開

maven不是ant，也不是make。

我們以前接觸的構建工具，需要寫一些詳細的步驟，比如： compile project1/src/*.java 等類似的語句。這些語句正是我們使用ant和make所要編寫的東西。maven採用了"約定優於配置"的方法，一些開發常用的操作和步驟已經固化在 maven中，所以使用者不再需要去編寫那些煩人的語句了。同時，maven內置了開發流程的支持，它不僅能夠編譯，同樣能夠打包、發佈，也能夠一氣呵成做完這些所有的步驟。

maven不是ivy

依賴管理是maven的功能之一，雖然很多人包括我以前都是隻用它的依賴管理功能，但是要深入運用的話，我們就可以看到更多的內容。更重要的是，maven在依賴關係中加入了scope的概念，進一步細化了依賴關係的劃分。

2.2 maven是什麼

maven將自己定位爲一個項目管理工具。它負責管理項目開發過程中的幾乎所有的東西：

版本

maven有自己的版本定義和規則

構建

maven支持許多種的應用程序類型，對於每一種支持的應用程序類型都定義好了一組構建規則和工具集。

輸出物管理

maven可以管理項目構建的產物，並將其加入到用戶庫中。這個功能可以用於項目組和其他部門之間的交付行爲。

依賴關係

maven對依賴關係的特性進行細緻的分析和劃分，避免開發過程中的依賴混亂和相互污染行爲

文檔和構建結果

maven的site命令支持各種文檔信息的發佈，包括構建過程的各種輸出，javadoc，產品文檔等。

項目關係

一個大型的項目通常有幾個小項目或者模塊組成，用maven可以很方便地管理

移植性管理

maven可以針對不同的開發場景，輸出不同種類的輸出結果。

2.3 maven的生命週期

maven把項目的構建劃分爲不同的生命週期(lifecycle)，在我看來，劃分的已經是非常仔細了，大家可以參考這裏。粗略一點的話，它這個過程(phase)包括：編譯、測試、打包、集成測試、驗證、部署。maven中所有的執行動作(goal)都需要指明自己在這個過程中的執行位置，然後maven執行的時候，就依照過程的發展依次調用這些goal進行各種處理。

這個也是maven的一個基本調度機制。一般來說，位置稍後的過程都會依賴於之前的過程。當然，maven同樣提供了配置文件，可以依照用戶要求，跳過某些階段。

2.4 maven的"約定優於配置"

所謂的"約定優於配置"，在maven中並不是完全不可以修改的，他們只是一些配置的默認值而已。但是使用者除非必要，並不需要去修改那些約定內容。maven默認的文件存放結構如下：

/項目目錄

pom.xml 用於maven的配置文件

/src 源代碼目錄

/src/main 工程源代碼目錄

/src/main/java 工程java源代碼目錄

/src/main/resource 工程的資源目錄

/src/test 單元測試目錄

/src/test/java

/target 輸出目錄，所有的輸出物都存放在這個目錄下

/target/classes 編譯之後的class文件

每一個階段的任務都知道怎麼正確完成自己的工作，比如compile任務就知道從src/main/java下編譯所有的java文件，並把它的輸出class文件存放到target/classes中。

對maven來說，採用"約定優於配置"的策略可以減少修改配置的工作量，也可以降低學習成本，更重要的是，給項目引入了統一的規範。

2.5 maven的版本規範

maven使用如下幾個要素來唯一定位某一個輸出物： groupId:artifactId:packaging:version 。比如 org.springframework:spring:2.5 。每個部分的解釋如下：

groupId

團體，公司，小組，組織，項目，或者其它團體。團體標識的約定是，它以創建這個項目的組織名稱的逆向域名(reverse domain name)開頭。來自Sonatype的項目有一個以com.sonatype開頭的groupId，而Apache Software的項目有以org.apache開頭的groupId。

artifactId

在groupId下的表示一個單獨項目的唯一標識符。比如我們的tomcat, commons等。不要在artifactId中包含點號(.)。

version

一個項目的特定版本。發佈的項目有一個固定的版本標識來指向該項目的某一個特定的版本。而正在開發中的項目可以用一個特殊的標識，這種標識給版本加上一個"SNAPSHOT"的標記。

雖然項目的打包格式也是Maven座標的重要組成部分，但是它不是項目唯一標識符的一個部分。一個項目的 groupId:artifactId:version使之成爲一個獨一無二的項目；你不能同時有一個擁有同樣的groupId, artifactId和version標識的項目。

packaging

項目的類型，默認是jar，描述了項目打包後的輸出。類型爲jar的項目產生一個JAR文件，類型爲war的項目產生一個web應用。

classifier

很少使用的座標，一般都可以忽略classifiers。如果你要發佈同樣的代碼，但是由於技術原因需要生成兩個單獨的構件，你就要使用一個分類器（classifier）。例如，如果你想要構建兩個單獨的構件成JAR，一個使用Java 1.4編譯器，另一個使用Java 6編譯器，你就可以使用分類器來生成兩個單獨的JAR構件，它們有同樣的groupId:artifactId:version組合。如果你的項目使用本地擴展類庫，你可以使用分類器爲每一個目標平臺生成一個構件。分類器常用於打包構件的源碼，JavaDoc或者二進制集合。

maven有自己的版本規範，一般是如下定義 <major version>.<minor version>.<incremental version>-<qualifier> ，比如1.2.3-beta-01。要說明的是，maven自己判斷版本的算法是major,minor,incremental部分用數字比較，qualifier部分用字符串比較，所以要小心 alpha-2和alpha-15的比較關係，最好用 alpha-02的格式。

maven在版本管理時候可以使用幾個特殊的字符串 SNAPSHOT ,LATEST ,RELEASE 。比如"1.0-SNAPSHOT"。各個部分的含義和處理邏輯如下說明：

SNAPSHOT

如果一個版本包含字符串"SNAPSHOT"，Maven就會在安裝或發佈這個組件的時候將該符號展開爲一個日期和時間值，轉換爲UTC時間。例如，"1.0-SNAPSHOT"會在2010年5月5日下午2點10分發布時候變成1.0-20100505-141000-1。

這個詞只能用於開發過程中，因爲一般來說，項目組都會頻繁發佈一些版本，最後實際發佈的時候，會在這些snapshot版本中尋找一個穩定的，用於正式發佈，比如1.4版本發佈之前，就會有一系列的1.4-SNAPSHOT，而實際發佈的1.4，也是從中拿出來的一個穩定版。

LATEST

指某個特定構件的最新發布，這個發佈可能是一個發佈版，也可能是一個snapshot版，具體看哪個時間最後。

RELEASE

指最後一個發佈版。

2.6 maven的組成部分

maven把整個maven管理的項目分爲幾個部分，一個部分是源代碼，包括源代碼本身、相關的各種資源，一個部分則是單元測試用例，另外一部分則是各種maven的插件。對於這幾個部分，maven可以獨立管理他們，包括各種外部依賴關係。

2.7 maven的依賴管理

依賴管理一般是最吸引人使用maven的功能特性了，這個特性讓開發者只需要關注代碼的直接依賴，比如我們用了spring，就加入spring依賴說明就可以了，至於spring自己還依賴哪些外部的東西，maven幫我們搞定。

任意一個外部依賴說明包含如下幾個要素：groupId, artifactId, version, scope, type, optional。其中前3個是必須的，各自含義如下：

groupId 必須

artifactId 必須

version 必須。

這裏的version可以用區間表達式來表示，比如(2.0,)表示>2.0，[2.0,3.0)表示2.0<=ver<3.0；多個條件之間用逗號分隔，比如[1,3),[5,7]。

scope 作用域限制

type 一般在pom引用依賴時候出現，其他時候不用

optional 是否可選依賴

maven認爲，程序對外部的依賴會隨着程序的所處階段和應用場景而變化，所以maven中的依賴關係有作用域(scope)的限制。在maven中，scope包含如下的取值：

compile（編譯範圍）

compile是默認的範圍；如果沒有提供一個範圍，那該依賴的範圍就是編譯範圍。編譯範圍依賴在所有的classpath中可用，同時它們也會被打包。

provided（已提供範圍）

provided依賴只有在當JDK或者一個容器已提供該依賴之後才使用。例如，如果你開發了一個web應用，你可能在編譯classpath中需要可用的Servlet API來編譯一個servlet，但是你不會想要在打包好的WAR中包含這個Servlet API；這個Servlet API JAR由你的應用服務器或者servlet容器提供。已提供範圍的依賴在編譯classpath（不是運行時）可用。它們不是傳遞性的，也不會被打包。

runtime（運行時範圍）

runtime依賴在運行和測試系統的時候需要，但在編譯的時候不需要。比如，你可能在編譯的時候只需要JDBC API JAR，而只有在運行的時候才需要JDBC驅動實現。

test（測試範圍）

test範圍依賴在一般的編譯和運行時都不需要，它們只有在測試編譯和測試運行階段可用。測試範圍依賴在之前的???中介紹過。

system（系統範圍）

system範圍依賴與provided類似，但是你必須顯式的提供一個對於本地系統中JAR文件的路徑。這麼做是爲了允許基於本地對象編譯，而這些對象是系統類庫的一部分。這樣的構件應該是一直可用的，Maven也不會在倉庫中去尋找它。如果你將一個依賴範圍設置成系統範圍，你必須同時提供一個systemPath元素。注意該範圍是不推薦使用的（你應該一直儘量去從公共或定製的Maven倉庫中引用依賴）。

另外，代碼有代碼自己的依賴，各個maven使用的插件也可以有自己的依賴關係。依賴也可以是可選的，比如我們代碼中沒有任何cache依賴，但是hibernate可能要配置cache，所以該cache的依賴就是可選的。

2.8 多項目管理

maven的多項目管理也是非常強大的。一般來說，maven要求同一個工程的所有子項目都放置到同一個目錄下，每一個子目錄代表一個項目，比如

總項目/

pom.xml 總項目的pom配置文件

子項目1/

pom.xml 子項目1的pom文件

子項目2/

pom.xml 子項目2的pom文件

按照這種格式存放，就是繼承方式，所有具體子項目的pom.xml都會繼承總項目pom的內容，取值爲子項目pom內容優先。

要設置繼承方式，首先要在總項目的pom中加入如下配置

<module>simple-weather</module>

<module>simple-webapp</module>

</modules>

其次在每個子項目中加入

<groupId>org.sonatype.mavenbook.ch06</groupId>

<artifactId>simple-parent</artifactId>

</parent>

即可。

當然，繼承不是唯一的配置文件共用方式，maven還支持引用方式。引用pom的方式更簡單，在依賴中加入一個type爲pom的依賴即可。

<description>This is a project requiring JDBC</description>

...

...

<groupId>org.sonatype.mavenbook</groupId>

<artifactId>persistence-deps</artifactId>

</dependency>

</dependencies>

</project>

2.9 屬性

用戶可以在maven中定義一些屬性，然後在其他地方用${xxx}進行引用。比如：

...

<var1>value1</var1>

</properties>

</project>

maven提供了三個隱式的變量，用來訪問系統環境變量、POM信息和maven的settings：

env

暴露操作系統的環境變量，比如env.PATH

project

暴露POM中的內容，用點號(.)的路徑來引用POM元素的值，比如${project.artifactId}。另外，java的系統屬性比如user.dir等，也暴露在這裏。

settings

暴露maven的settings的信息，也可以用點號(.)來引用。maven把系統配置文件存放在maven的安裝目錄中，把用戶相關的配置文件存放在~/.m2/settings.xml(unix)或者%USERPROFILE%/.m2/settings.xml(windows)中。

2.10 maven的profile

profile是maven的一個重要特性，它可以讓maven能夠自動適應外部的環境變化，比如同一個項目，在linux下編譯linux的版本，在win下編譯win的版本等。一個項目可以設置多個profile，也可以在同一時間設置多個profile被激活（active）的。自動激活的 profile的條件可以是各種各樣的設定條件，組合放置在activation節點中，也可以通過命令行直接指定。profile包含的其他配置內容可以覆蓋掉pom定義的相應值。如果認爲profile設置比較複雜，可以將所有的profiles內容移動到專門的 profiles.xml 文件中，不過記得和pom.xml放在一起。

activation節點中的激活條件中常見的有如下幾個：

判斷操作系統相關的參數，它包含如下可以自由組合的子節點元素

message - 規則失敗之後顯示的消息

arch - 匹配cpu結構，常見爲x86

family - 匹配操作系統家族，常見的取值爲：dos，mac，netware，os/2，unix，windows，win9x，os/400等

name - 匹配操作系統的名字

version - 匹配的操作系統版本號

display - 檢測到操作系統之後顯示的信息

jdk

檢查jdk版本，可以用區間表示。

property

檢查屬性值，本節點可以包含name和value兩個子節點。

file

檢查文件相關內容，包含兩個子節點：exists和missing，用於分別檢查文件存在和不存在兩種情況。

3. maven的操作和使用

maven的操作有兩種方式，一種是通過mvn命令行命令，一種是使用maven的eclipse插件。因爲使用eclipse的maven插件操作起來比較容易，這裏就只介紹使用mvn命令行的操作。

3.1 maven的配置文件

maven的主執行程序爲mvn.bat，linux下爲mvn.sh，這兩個程序都很簡單，它們的共同用途就是收集一些參數，然後用 java.exe來運行maven的Main函數。maven同樣需要有配置文件，名字叫做settings.xml，它放在兩個地方，一個是maven 安裝目錄的conf目錄下，對所有使用該maven的用戶都起作用，我們稱爲主配置文件，另外一個放在 %USERPROFILE%/.m2/settings.xml下，我們成爲用戶配置文件，只對當前用戶有效，且可以覆蓋主配置文件的參數內容。還有就是項目級別的配置信息了，它存放在每一個maven管理的項目目錄下，叫pom.xml，主要用於配置項目相關的一些內容，當然，如果有必要，用戶也可以在 pom中寫一些配置，覆蓋住配置文件和用戶配置文件的設置參數內容。

一般來說，settings文件配置的是比如repository庫路徑之類的全局信息，具體可以參考官方網站的文章。

3.2 創建新工程

要創建一個新的maven工程，我們需要給我們的工程指定幾個必要的要素，就是maven產品座標的幾個要素：groupId, artifactId，如果願意，你也可以指定version和package名稱。我們先看一個簡單的創建命令：

d:/work/temp>mvn archetype:create -DgroupId=com.abc -DartifactId=product1 -DarchetypeArtifactId=maven-archetype-webapp

首先看這裏的命令行參數的傳遞結構，怪異的 -D參數=值的方式是 java.exe 要求的方式。這個命令創建一個web工程，目錄結構是一個標準的maven結構，如下：

D:.

└─mywebapp

│ pom.xml

│

└─src

└─main

├─resources

└─webapp

│ index.jsp

│

└─WEB-INF

web.xml

大家要注意，這裏目錄結構的佈局實際上是由參數 archetypeArtifactId 來決定的，因爲這裏傳入的是 maven-archetype-webapp 如果我們傳入其他的就會創建不同的結構，默認值爲 maven-archetype-quickstart ，有興趣的讀者可以參考更詳細的列表，我把部分常用的列表在這裏：

Artifact Group Version Repository Description

maven-archetype-j2ee-simple org.apache.maven.archetypes A simple J2EE Java application

maven-archetype-marmalade-mojo org.apache.maven.archetypes A Maven plugin development project using marmalade

maven-archetype-plugin org.apache.maven.archetypes A Maven Java plugin development project

maven-archetype-portlet org.apache.maven.archetypes A simple portlet application

maven-archetype-profiles org.apache.maven.archetypes

maven-archetype-quickstart org.apache.maven.archetypes

maven-archetype-simple org.apache.maven.archetypes

maven-archetype-site-simple org.apache.maven.archetypes A simple site generation project

maven-archetype-site org.apache.maven.archetypes A more complex site project

maven-archetype-webapp org.apache.maven.archetypes A simple Java web application

maven-archetype-har net.sf.maven-har 0.9 Hibernate Archive

maven-archetype-sar net.sf.maven-sar 0.9 JBoss Service Archive

大家可以參考更詳細的 archetype:create 幫助和 archtype參考信息。

3.3 maven的多項目管理

多項目管理是maven的主要特色之一，對於一個大型工程，用maven來管理他們之間複雜的依賴關係，是再好不過了。maven的項目配置之間的關係有兩種：繼承關係和引用關係。

maven默認根據目錄結構來設定pom的繼承關係，即下級目錄的pom默認繼承上級目錄的pom。要設定兩者之間的關係很簡單，上級pom如下設置：

<module>ABCCommon</module>

<module>ABCCore</module>

<module>ABCTools</module>

</modules>

要記住的是，這裏的module是目錄名，不是子工程的artifactId。子工程如下設置：

<groupId>com.abc.product1</groupId>

<artifactId>abc-product1</artifactId>

<version>1.0.0-SNAPSHOT</version>

</parent>

<artifactId>abc-my-module2</artifactId>

這樣兩者就相互關聯起來了，繼承關係就設定完畢，所有父工程的配置內容都會自動在子工程中生效，除非子工程有相同的配置覆蓋。如果你不喜歡層層遞進的目錄結構來實現繼承，也可以在parent中加入 <relativePath>../a-parent/pom.xml</relativePath> 來制定parent項目的相對目錄。繼承關係通常用在項目共同特性的抽取上，通過抽取公共特性，可以大幅度減少子項目的配置工作量。

引用關係是另外一種複用的方式，maven中配置引用關係也很簡單，加入一個 type 爲 pom 的依賴即可。

<groupId>org.sonatype.mavenbook</groupId>

<artifactId>persistence-deps</artifactId>

</dependency>

但是無論是父項目還是引用項目，這些工程都必須用 mvn install 或者 mvn deploy 安裝到本地庫才行，否則會報告依賴沒有找到，eclipse編譯時候也會出錯。

需要特別提出的是複用過程中，父項目的pom中可以定義 dependencyManagement 節點，其中存放依賴關係，但是這個依賴關係只是定義，不會真的產生效果，如果子項目想要使用這個依賴關係，可以在本身的 dependency 中添加一個簡化的引用

<groupId>org.springframework</groupId>

<artifactId>spring</artifactId>

</dependency>

這種方法可以避免版本號滿天飛的情況。

3.4 安裝庫文件到maven庫中

在maven中一般都會用到安裝庫文件的功能，一則是我們常用的hibernate要使用jmx庫，但是因爲sun的license限制，所以無法將其直接包含在repository中。所以我們使用mvn命令把jar安裝到我們本地的repository中

mvn install:install-file -DgroupId=com.sun.jdmk -DartifactId=jmxtools -Dversion=1.2.1 -Dpackaging=jar -Dfile=/path/to/file

如果我們想把它安裝到公司的repository中，需要使用命令

mvn deploy:deploy-file -DgroupId=com.sun.jdmk -DartifactId=jmxtools -Dversion=1.2.1 -Dpackaging=jar -Dfile=/path/to/file -Durl=http://xxx.ss.com/sss.xxx -DrepositoryId=release-repo

對於我們的工程輸出，如果需要放置到公司的repository中的話，可以通過配置pom來實現

<id>mycompany-repository</id>

<name>MyCompany Repository</name>

<url>scp://repository.mycompany.com/repository/maven2</url>

</repository>

</distributionManagement>

這裏使用的scp方式提交庫文件，還有其他方式可以使用，請參考faq部分。然後記得在你的settings.xml中加入這一內容

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0

http://maven.apache.org/xsd/settings-1.0.0.xsd">

...

<id>mycompany-repository</id>

<username>jvanzyl</username>

<privateKey>/path/to/identity</privateKey>

<passphrase>my_key_passphrase</passphrase>

</server>

</servers>

...

</settings>

3.5 maven的變量

maven定義了很多變量屬性,參考這裏 http://docs.codehaus.org/display/MAVENUSER/MavenPropertiesGuide

內置屬性

${basedir } represents the directory containing pom.xml

${version } equivalent to ${project.version } or ${pom.version }

Pom/Project properties

所有pom中的元素都可以用 project. 前綴進行引用,以下是部分常用的

${project.build.directory } results in the path to your "target" dir, this is the same as ${pom.project.build.directory }

${project.build. outputD irectory } results in the path to your "target/classes" dir

${project.name } refers to the name of the project.

${project.version } refers to the version of the project.

${project.build.finalName } refers to the final name of the file created when the built project is packaged

本地用戶設定

所有用的的 settings.xml 中的設定都可以通過 settings. 前綴進行引用

${settings.localRepository } refers to the path of the user's local repository.

${maven.repo.local } also works for backward compatibility with maven1 ??

環境變量

系統的環境變量通過 env. 前綴引用

${env.M2_HOME } returns the Maven2 installation path.

${java.home } specifies the path to the current JRE_HOME environment use with relative paths to get for example:

java系統屬性

所有JVM中定義的java系統屬性.

用戶在pom中定義的自定義屬性

...

<my.filter.value>hello</my.filter.value>

</properties>

...

</project>

則引用 ${my.filter.value } 就會得到值 hello

上級工程的變量

上級工程的pom中的變量用前綴 ${project.parent } 引用. 上級工程的版本也可以這樣引用: ${parent.version }.

3.6 maven的使用

我們已經知道maven預定義了許多的階段（phase），每個插件都依附於這些階段，並且在進入某個階段的時候，調用運行這些相關插件的功能。我們先來看完整的maven生命週期：

生命週期階段描述

validate 驗證項目是否正確，以及所有爲了完整構建必要的信息是否可用

generate-sources 生成所有需要包含在編譯過程中的源代碼

process-sources 處理源代碼，比如過濾一些值

generate-resources 生成所有需要包含在打包過程中的資源文件

process-resources 複製並處理資源文件至目標目錄，準備打包

compile 編譯項目的源代碼

process-classes 後處理編譯生成的文件，例如對Java類進行字節碼增強（bytecode enhancement）

generate-test-sources 生成所有包含在測試編譯過程中的測試源碼

process-test-sources 處理測試源碼，比如過濾一些值

generate-test-resources 生成測試需要的資源文件

process-test-resources 複製並處理測試資源文件至測試目標目錄

test-compile 編譯測試源碼至測試目標目錄

test 使用合適的單元測試框架運行測試。這些測試應該不需要代碼被打包或發佈

prepare-package 在真正的打包之前，執行一些準備打包必要的操作。這通常會產生一個包的展開的處理過的版本（將會在Maven 2.1+中實現）

package 將編譯好的代碼打包成可分發的格式，如JAR，WAR，或者EAR

pre-integration-test 執行一些在集成測試運行之前需要的動作。如建立集成測試需要的環境

integration-test 如果有必要的話，處理包併發布至集成測試可以運行的環境

post-integration-test 執行一些在集成測試運行之後需要的動作。如清理集成測試環境。

verify 執行所有檢查，驗證包是有效的，符合質量規範

install 安裝包至本地倉庫，以備本地的其它項目作爲依賴使用

deploy 複製最終的包至遠程倉庫，共享給其它開發人員和項目（通常和一次正式的發佈相關）

maven核心的插件列表可以參考 http://maven.apache.org/plugins/index.html 。這裏僅列舉幾個常用的插件及其配置參數：

clean插件

只包含一個goal叫做 clean:clean ，負責清理構建時候創建的文件。默認清理的位置是如下幾個變量指定的路徑 project.build.directory, project.build.outputDirectory, project.build.testOutputDirectory, and project.reporting.outputDirectory 。

compiler插件

包含2個goal，分別是 compiler:compile 和 compiler:testCompile 。可以到這裏查看兩者的具體參數設置：compile , testCompile 。

surefire插件

運行單元測試用例的插件，並且能夠生成報表。包含一個goal爲 surefire:test 。主要參數testSourceDirectory用來指定測試用例目錄，參考完整用法幫助

jar

負責將工程輸出打包到jar文件中。包含兩個goal，分別是 jar:jar , jar:test-jar 。兩個goal負責從classesDirectory或testClassesDirectory中獲取所有資源，然後輸出jar文件到outputDirectory中。

war

負責打包成war文件。常用goal有 war:war ，負責從warSourceDirectory（默認${basedir}/src/main/webapp）打包所有資源到outputDirectory中。

resources

負責複製各種資源文件，常用goal有 resources:resources ，負責將資源文件複製到outputDirectory中，默認爲${project.build.outputDirectory}。

install

負責將項目輸出(install:install)或者某個指定的文件(install:install-file)加入到本機庫%USERPROFILE%/.m2/repository中。可以用 install:help 尋求幫助。

deploy

負責將項目輸出(deploy:deploy)或者某個指定的文件(deploy:deploy-file)加入到公司庫中。

site

將工程所有文檔生成網站，生成的網站界面默認和apache的項目站點類似，但是其文檔用doxia格式寫的，目前不支持docbook，需要用其他插件配合才能支持。需要指出的是，在maven 2.x系列中和maven3.x的site命令處理是不同的，在舊版本中，用 mvn site 命令可以生成reporting節點中的所有報表，但是在maven3中，reporting過時了，要把這些內容作爲 maven-site-plugin的configuration的內容才行。詳細內容可以參考http://www.wakaleo.com/blog/292-site-generation-in-maven-3

4. maven的使用問答

除了以下的幾個faq條目之外，還有一些faq可以參考

maven 自己的FAQ

兄弟們如果有其他問題，歡迎跟帖提問！

4.1 依賴關係

1) 問：如何增加刪除一個依賴關係？

答：直接在pom文件中加入一個dependency節點，如果要刪除依賴，把對應的dependency節點刪除即可。

2) 問：如何屏蔽一個依賴關係？比如項目中使用的libA依賴某個庫的1.0版，libB以來某個庫的2.0版，現在想統一使用2.0版，如何去掉1.0版的依賴？

答：設置exclusion即可。

<groupId>org.hibernate</groupId>

<artifactId>hibernate</artifactId>

<groupId>javax.transaction</groupId>

</exclusion>

</exclusions>

</dependency>

3) 問：我有一些jar文件要依賴，但是我又不想把這些jar去install到mvn的repository中去，怎麼做配置？

答：加入一個特殊的依賴關係，使用system類型，如下：

<artifactId>my-tools</artifactId>

<scope>system</scope>

<systemPath>${basedir}/lib/mylib1.jar</systemPath>

</dependency>

但是要記住，發佈的時候不會複製這個jar。需要手工配置，而且其他project依賴這個project的時候，會報告警告。如果沒有特殊要求，建議直接註冊發佈到repository。

4) 問：在eclipse環境中同時使用maven builder和eclipse builder，並且設置項目依賴關係之後，爲什麼編譯會出現artifact找不到錯誤，但是直接使用命令行mvn構建則一切正常？

答：在project屬性中去掉java build path中對其他 project 的依賴關係，直接在pom中設置依賴關係即可

<groupId>com.abc.project1</groupId>

<artifactId>abc-project1-common</artifactId>

<version>${project.version}</version>

</dependency>

另外，保證沒有其他錯誤。

5) 問：我想讓輸出的jar包自動包含所有的依賴

答：使用 assembly 插件即可。

<artifactId>maven-assembly-plugin</artifactId>

<descriptorRef>jar-with-dependencies</descriptorRef>

</descriptorRefs>

</configuration>

</plugin>

6) 問：我的測試用例依賴於其他工程的測試用例，如何設置？

答：maven本身在發佈的時候，可以發佈單純的jar，也可以同時發佈xxx-tests.jar和xxx-javadoc.jar（大家經常在repository中可以看到類似的東西）。我們自己的項目A要同時輸出test.jar可以做如下的設置

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-jar-plugin</artifactId>

<goals>

</goals>

</execution>

</executions>

</plugin>

然後在其他需要引用的工程B中做如下的dependency設置

<version>${project.version}</version>

</dependency>

7)如何讓maven將工程依賴的jar複製到WEB-INF/lib目錄下？

8)我剛剛更新了一下我的nexus庫，但是我無法在eclipse中用m2eclipse找到我新增的庫文件

修改pom.xml文件，將舊版jar的依賴內容中的版本直接修改爲新版本即可。

9）我要的jar最新版不在maven的中央庫中，我怎麼辦？

將依賴的文件安裝到本地庫，用如下命令可以完成：

mvn install:install-file

-Dfile=<path-to-file>

-DgroupId=<group-id>

-DartifactId=<artifact-id>

-Dversion=<version>

-Dpackaging=<packaging>

-DgeneratePom=true

Where: <path-to-file> the path to the file to load

<group-id> the group that the file should be registered under

<artifact-id> the artifact name for the file

<version> the version of the file

<packaging> the packaging of the file e.g. jar

10）

4.2 變量

1) 問：如何使用變量替換？項目中的某個配置文件比如jdbc.properties使用了一些pom中的變量，如何在發佈中使用包含真實內容的最終結果文件？

答：使用資源過濾功能，比如：

...

<jdbc.driverClassName>com.mysql.jdbc.Driver</jdbc.driverClassName>

<jdbc.url>jdbc:mysql://localhost:3306/development_db</jdbc.url>

<jdbc.username>dev_user</jdbc.username>

<jdbc.password>s3cr3tw0rd</jdbc.password>

</properties>

...

<build>

<directory>src/main/resources</directory>

</resource>

</resources>

</build>

...

<id>production</id>

<jdbc.driverClassName>oracle.jdbc.driver.OracleDriver</jdbc.driverClassName>

<jdbc.url>jdbc:oracle:thin:@proddb01:1521:PROD</jdbc.url>

<jdbc.username>prod_user</jdbc.username>

<jdbc.password>s00p3rs3cr3t</jdbc.password>

</properties>

</profile>

</profiles>

</project>

2) 問： maven-svn-revision-number-plugin 插件說明

答： maven-svn-revision-number-plugin 可以從 SVN 中獲取版本號，並將其變成環境變量，交由其他插件或者profile使用，詳細幫助在這裏。一般和resource的filter機制同時使用

<groupId>com.google.code.maven-svn-revision-number-plugin</groupId>

<artifactId>maven-svn-revision-number-plugin</artifactId>

<goals>

<goal>revision</goal>

</goals>

</execution>

</executions>

<entry>

<prefix>prefix</prefix>

</entry>

</entries>

</configuration>

</plugin>

</plugins>

這段代碼負責把resource文件中的內容替換成適當內容

repository = ${prefix.repository}

path = ${prefix.path}

revision = ${prefix.revision}

mixedRevisions = ${prefix.mixedRevisions}

committedRevision = ${prefix.committedRevision}

status = ${prefix.status}

specialStatus = ${prefix.specialStatus}

3）我的程序有些單元測試有錯誤，如何忽略測試步驟？

有好幾種方法都可以實現跳過單元測試步驟，一種是給mvn增加命令行參數 -Dmaven.test.skip=true 或者 -DskipTests=true ；另外一種是給surefire插件增加參數，如下：

[...]

<build>

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-surefire-plugin</artifactId>

</configuration>

</plugin>

</plugins>

</build>

[...]

</project>

4) 如果只想運行單個測試用例，能否實現？

可以，運行時候增加命令行參數 -Dtest=MyTest 即可，其中MyTest是所需要運行的單元測試用例名稱，但是不需要包含package部分。

4.3 編譯

1) 問：如何給插件指派參數？比如我要設置一些編譯參數

答：以下內容設定編譯器編譯java1.5的代碼

...

<build>

...

<artifactId>maven-compiler-plugin</artifactId>

</configuration>

</plugin>

</plugins>

...

</build>

...

</project>

要設置其他插件的參數也可以，請參考對應插件的幫助信息

2) 問：我的目錄是非標準的目錄結構，如何設置讓maven支持？

答：指定source目錄和test-source目錄即可。

<build>

<directory>target</directory>

<scriptSourceDirectory>js/scripts</scriptSourceDirectory>

</build>

這個例子把源代碼設置成了src目錄，測試代碼在test目錄，所以輸出到bin目錄。這裏要注意，directory如果也設置成bin目錄的話，maven打包的時候會引起死循環，因爲directory是所有工作存放的地方，默認包含outputDirectory定義的目錄在內。

3) 我源代碼是UTF8格式的，我如何在maven中指定？

設置一個變量即可

...

<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

</properties>

...

</project>

{color:blue}以上是官方給出的解決方案，但是經過嘗試這樣只能影響到resource處理時候的編碼{color}，真正有用的是如下配置：

{code:xml}

<build>

...

<artifactId>maven-compiler-plugin</artifactId>

</configuration>

</plugin>

...

</build>

{code}

. 問：我的項目除了main/java目錄之外，還加了其他的c++目錄，想要一併編譯，如何做？

答：使用native插件，具體配置方法參考[http://mojo.codehaus.org/maven-native/native-maven-plugin/]

{code:xml}

<groupId>org.codehaus.mojo</groupId>

<artifactId>native-maven-plugin</artifactId>

</plugin>

{code}

. 問：我想要把工程的所有依賴的jar都一起打包，怎麼辦？

答：首先修改maven的配置文件，給maven-assembly-plugin增加一個jar-with-dependencies的描述。

{code:xml}

[...]

<build>

<artifactId>maven-assembly-plugin</artifactId>

<descriptorRef>jar-with-dependencies</descriptorRef>

</descriptorRefs>

</configuration>

</plugin>

</plugins>

</build>

[...]

</project>

{code}

然後使用命令打包即可：

mvn assembly:assembly

. 問：我想把main/scripts中的內容一起打包發佈，如何做？

答：在pom中配置額外的資源目錄。如果需要的話，還可以指定資源目錄的輸出位置

{code:xml}

<build>

...

<directory>src/main/command</directory>

</includes>

</resource>

<directory>src/main/scripts</directory>

</resource>

</resources>

...

</build>

{code}

. 問：我有多個源代碼目錄，但是maven只支持一個main src和一個test src，怎麼辦？

答：使用另外一個插件，並仿照如下配置pom

{code:xml}

<groupId>org.codehaus.mojo</groupId>

<artifactId>build-helper-maven-plugin</artifactId>

<id>add-source</id>

<phase>generate-sources</phase>

<goals>

<goal>add-source</goal>

</goals>

<source>src/config/java</source>

<source>src/member/java</source>

</sources>

</configuration>

</execution>

</executions>

</plugin>

{code}

. 問：我的源代碼目錄中有一部分文件我不想讓maven編譯，怎麼做？

答：使用一個maven插件，然後使用includes和excludes。同理，也可以處理資源的過濾。

{code:xml}

<build>

<sourceDirectory>http://www.cnblogs.com/src/java</sourceDirectory>

<groupId>com.sun.enterprise</groupId>

<artifactId>hk2-maven-plugin</artifactId>

<include>com/sun/logging/LogDomains.*</include>

<include>com/sun/enterprise/util/OS.java</include>

<include>com/sun/enterprise/util/io/FileUtils.java</include>

<include>com/sun/enterprise/util/zip/**</include>

<include>com/sun/enterprise/util/i18n/**</include>

<include>com/sun/enterprise/deployment/backend/IASDeploymentException.java</include>

</includes>

<exclude>com/sun/enterprise/config/ConfigBeansFactory.java</exclude>

<exclude>com/sun/enterprise/config/clientbeans/**</exclude>

</excludes>

</configuration>

</plugin>

</plugins>

<directory>http://www.cnblogs.com/src/java</directory>

<include>**/*.properties</include>

</includes>

</resource>

</resources>

</build>

{code}

. 問：我的項目是一個純的html組成的項目，沒有任何的java代碼，怎麼跳過編譯過程？

答：配置如下

{code:xml}

<build>

<groupId>com.sun.enterprise</groupId>

<artifactId>hk2-maven-plugin</artifactId>

</plugin>

</plugins>

</build>

{code}

. 問：我的工程裏用hibernate，想在編譯時候自動生成ddl，如何做？

答：添加插件

hibernate3-maven-plugin

，按照如下配置：

{code:xml}

<groupId>org.codehaus.mojo</groupId>

<artifactId>hibernate3-maven-plugin</artifactId>

<implementation>annotationconfiguration</implementation>

</component>

</components>

</configuration>

<groupId>hsqldb</groupId>

<artifactId>hsqldb</artifactId>

<version>${hsqldb.version}</version>

</dependency>

</dependencies>

</plugin>

{code}

. 問：我能用maven支持eclipse RCP項目嗎？

答：當然可以，你可以使用插件 Tycho，詳細內容可以參考這裏[http://mattiasholmqvist.se/2010/02/building-with-tycho-part-1-osgi-bundles/].

<groupid>org.sonatype.tycho</groupid>

<artifactid>target-platform-configuration</artifactid>

</configuration>

</plugin>

另外，老牌的pde-maven-plugin就不要用了，已經好幾年沒見更新了。

4.4 ant互動

1) 如何在maven編譯時候運行ant腳本？

使用專門的antrun插件，並且在target標籤內部加入ant的代碼

<artifactId>maven-antrun-plugin</artifactId>

</target>

</configuration>

<goals>

</goals>

</execution>

</executions>

</plugin>

2）如何在ant腳本中引用maven的classpath？

maven給每一個依賴都生成了一個屬性，格式爲"groupId:artifactId[:classifier]:type"，比如，如果一下例子就顯示依賴的org.apache.common-util的jar文件路徑

另外，maven還預定義了四個classpath的引用，他們是

maven.compile.classpath

maven.runtime.classpath

maven.test.classpath

maven.plugin.classpath

3）如何使用antrun插件運行外部的build文件？

很簡單，直接在antrun裏邊使用ant指令即可，如下：

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-antrun-plugin</artifactId>

<id>compile</id>

<phase>compile</phase>

</ant>

</target>

</configuration>

<goals>

</goals>

</execution>

</executions>

</plugin>

. 問：如何在ant中使用maven的功能？

答：使用ant的[maven task|http://maven.apache.org/ant-tasks/index.html]，不過只有ant 1.6以上和jdk 1.5環境才支持。

h4. 測試相關

. 問：如何忽略某個階段的結果？比如單元測試不一定要全正確

答：給插件增加testFailureIgnore參數，並設置爲false。如果要屏蔽該階段，則用

{code:xml}

[...]

<build>

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-surefire-plugin</artifactId>

</configuration>

</plugin>

</plugins>

</build>

[...]

</project>

{code}

. 問：我如何在maven中加入PMD，CheckStyle，JDepend等檢查功能？

答：加入PMD檢查，以下代碼如果在

reporting

節點中加入則在

mvn site

中執行，如果在

build

節點中加入，則在build的時候自動運行檢查。詳細配置參考[pmd插件使用說明|http://maven.apache.org/plugins/maven-pmd-plugin/]

{code:xml}

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-pmd-plugin</artifactId>

</plugin>

</plugins>

{code}

加入 checkstyle 檢查，詳細配置參考[checkstyle插件使用說明|http://maven.apache.org/plugins/maven-checkstyle-plugin/]，同樣注意放置在reporting和build節點中的區別（所有報表類插件都要同樣注意）：

{code:xml}

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-checkstyle-plugin</artifactId>

</plugin>

{code}

加入 simian 的支持，simian是一個支持代碼相似度檢查的工具，目前有maven插件，也有checkstyle的插件。它不僅可以檢查java，甚至可以支持文本文件的檢查。詳細幫助信息參考[這裏|http://www.redhillconsulting.com.au/products/simian/]。simian 的 maven插件在[這裏|http://mojo.codehaus.org/simian-report-maven-plugin/introduction.html]

{code:xml}

<build>

<groupId>org.codehaus.mojo</groupId>

<artifactId>simian-maven-plugin</artifactId>

</plugin>

</plugins>

...

</build>

{code}

加入 jdepend 檢查，詳細配置參考[jdepend使用說明|http://mojo.codehaus.org/jdepend-maven-plugin/]，

{code:xml}

<groupId>org.codehaus.mojo</groupId>

<artifactId>jdepend-maven-plugin</artifactId>

</plugin>

{code}

加入 findbugz 檢查，詳細配置參考[findbugz使用說明|http://mojo.codehaus.org/findbugs-maven-plugin/usage.html]，

{code:xml}

<groupId>org.codehaus.mojo</groupId>

<artifactId>findbugs-maven-plugin</artifactId>

</plugin>

{code}

加入javadoc生成，詳細配置參考[javadoc usage|http://maven.apache.org/plugins/maven-javadoc-plugin/usage.html]

{code:xml}

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-javadoc-plugin</artifactId>

...

</configuration>

</plugin>

{code}

加入 jxr 支持，JXR是一個生成java代碼交叉引用和源代碼的html格式的工具，詳細配置信息參考[jxr usage|http://maven.apache.org/plugins/maven-jxr-plugin/]。注意，jxr沒有必要在build階段運行。

{code:xml}

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-jxr-plugin</artifactId>

</plugin>

</plugins>

</reporting>

{code}

加入 Cobertura 支持，它是一個代碼覆蓋率工具，可以用來評估具有相應測試的源代碼的比率。詳細幫助在[這裏|http://mojo.codehaus.org/cobertura-maven-plugin/index.html]。另外一個功能相似的軟件是[EMMA|http://emma.sourceforge.net/samples.html],詳細的幫助在[這裏|http://mojo.codehaus.org/emma-maven-plugin/usage.html]。兩個產品的比較文章在[這裏|http://www.topcoder.com/tc?module=Static&d1=features&d2=030107]，個人傾向於都要用，因爲給出的指標不一樣，都有參考作用。

{code:xml|title=Cobertura }

<groupId>org.codehaus.mojo</groupId>

<artifactId>cobertura-maven-plugin</artifactId>

<check>

<regex>

<pattern>com.example.reallyimportant.*</pattern>

</regex>

<regex>

<pattern>com.example.boringcode.*</pattern>

</regex>

</regexes>

</check>

</configuration>

<goals>

<goal>clean</goal>

<goal>check</goal>

</goals>

</execution>

</executions>

</plugin>

{code}

{code:xml|title=EMMA}

...

...

<groupId>org.codehaus.mojo</groupId>

<artifactId>emma-maven-plugin</artifactId>

<version>1.0-alpha-3-SNAPSHOT</version>

</plugin>

...

</plugins>

...

</reporting>

{code}

添加 javaNCSS 插件，它是一個java代碼的度量工具，詳細參考在[這裏|http://mojo.codehaus.org/javancss-maven-plugin/]。

{code:xml}

<groupId>org.codehaus.mojo</groupId>

<artifactId>javancss-maven-plugin</artifactId>

</plugin>

</plugins>

</reporting>

{code}

h4. profile相關

. 問：profile能夠設置爲某個變量不存在的條件下激活？

答：使用！前綴，請看示例：

{code:xml}

<name>!environment.type</name>

</property>

</activation>

{code}

h4. 部署相關

. 問：其他部署到服務器的方式和配置怎麼配？

答：本文摘自 [http://blog.csdn.net/zyxnetxz/archive/2009/05/18/4199348.aspx]{panel} *Distribution Management* 用於配置分發管理，配置相應的產品發佈信息,主要用於發佈，在執行mvn deploy後表示要發佈的位置 *# 配置到文件系統

{code:xml}

<id>proficio-repository<id>

<name>Proficio Repository<name>

<url>file://${basedir}/target/deploy<url>

{code}

*# 使用ssh2配置

{code:xml}

<id>proficio-repository<id>

<name>Proficio Repository<name>

<url>scp://sshserver.yourcompany.com/deploy<url>

{code}

*# 使用sftp配置

{code:xml}

<id>proficio-repositoryi<d>

<name>Proficio Repository<name>

<url>sftp://ftpserver.yourcompany.com/deploy<url>

{code}

*# 使用外在的ssh配置編譯擴展用於指定使用wagon外在ssh提供，用於提供你的文件到相應的遠程服務器。

{code:xml}

<id>proficio-repository<id>

<name>Proficio Repository<name>

<url>scpexe://sshserver.yourcompany.com/deploy<url>

<build>

<groupId>org.apache.maven.wagon<groupId>

<artifactId>wagon-ssh-external<artifactId>

<version>1.0-alpha-6<version>

<build>

{code}

*# 使用ftp配置

{code:xml}

<id>proficio-repository<id>

<name>Proficio Repository<name>

<url>ftp://ftpserver.yourcompany.com/deploy<url>

<build>

<groupId>org.apache.maven.wagongroupId>

<artifactId>wagon-ftpartifactId>

<version>1.0-alpha-6version>

<build>

{code}

{panel} h4. 插件配置

. 問：我用maven輸出site，如何設置輸出爲utf8編碼？

答：配置site插件的編碼設置

{code:xml}

...

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-site-plugin</artifactId>

</configuration>

</plugin>

...

{code}

Maven 常見問題解答

Linux 認清makefile

轉：嵌入式開發前景新手必備知識

Maven 常見問題解答

Linux下玩轉PSP開發（1）

開始有些相信星座理論了，處女座的朋友可以看看

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結