我的Java路上那些事兒

1.前言

Maven，發(fā)音是[`meivin]，"專家"的意思。它是一個很好的項(xiàng)目管理工具，很早就進(jìn)入了我的必備工具行列，但是這次為了把project1項(xiàng)目完全遷移并應(yīng)用maven，所以對maven進(jìn)行了一些深入的學(xué)習(xí)。寫這個學(xué)習(xí)筆記的目的，一個是為了自己備忘，二則希望能夠?yàn)槠渌藢W(xué)習(xí)使用maven 縮短一些時間。

2. maven概要

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

2.1 maven不是什么

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

1. maven不是ant，也不是make。
   我們以前接觸的構(gòu)建工具，需要寫一些詳細(xì)的步驟，比如： compile project1/src/*.java 等類似的語句。這些語句正是我們使用ant和make所要編寫的東西。maven采用了"約定優(yōu)于配置"的方法，一些開發(fā)常用的操作和步驟已經(jīng)固化在 maven中，所以使用者不再需要去編寫那些煩人的語句了。同時，maven內(nèi)置了開發(fā)流程的支持，它不僅能夠編譯，同樣能夠打包、發(fā)布，也能夠一氣呵成做完這些所有的步驟。
2. maven不是ivy
   依賴管理是maven的功能之一，雖然很多人包括我以前都是只用它的依賴管理功能，但是要深入運(yùn)用的話，我們就可以看到更多的內(nèi)容。更重要的是，maven在依賴關(guān)系中加入了scope的概念，進(jìn)一步細(xì)化了依賴關(guān)系的劃分。

2.2 maven是什么

maven將自己定位為一個項(xiàng)目管理工具。它負(fù)責(zé)管理項(xiàng)目開發(fā)過程中的幾乎所有的東西：

1. 版本
   maven有自己的版本定義和規(guī)則
2. 構(gòu)建
   maven支持許多種的應(yīng)用程序類型，對于每一種支持的應(yīng)用程序類型都定義好了一組構(gòu)建規(guī)則和工具集。
3. 輸出物管理
   maven可以管理項(xiàng)目構(gòu)建的產(chǎn)物，并將其加入到用戶庫中。這個功能可以用于項(xiàng)目組和其他部門之間的交付行為。
4. 依賴關(guān)系
   maven對依賴關(guān)系的特性進(jìn)行細(xì)致的分析和劃分，避免開發(fā)過程中的依賴混亂和相互污染行為
5. 文檔和構(gòu)建結(jié)果
   maven的site命令支持各種文檔信息的發(fā)布，包括構(gòu)建過程的各種輸出，javadoc，產(chǎn)品文檔等。
6. 項(xiàng)目關(guān)系
   一個大型的項(xiàng)目通常有幾個小項(xiàng)目或者模塊組成，用maven可以很方便地管理
7. 移植性管理
   maven可以針對不同的開發(fā)場景，輸出不同種類的輸出結(jié)果。

2.3 maven的生命周期

maven把項(xiàng)目的構(gòu)建劃分為不同的生命周期(lifecycle)，在我看來，劃分的已經(jīng)是非常仔細(xì)了，大家可以參考這里 。粗略一點(diǎn)的話，它這個過程(phase)包括：編譯、測試、打包、集成測試、驗(yàn)證、部署。maven中所有的執(zhí)行動作(goal)都需要指明自己在這個過程中的執(zhí)行位置，然后maven執(zhí)行的時候，就依照過程的發(fā)展依次調(diào)用這些goal進(jìn)行各種處理。

這個也是maven的一個基本調(diào)度機(jī)制。一般來說，位置稍后的過程都會依賴于之前的過程。當(dāng)然，maven同樣提供了配置文件，可以依照用戶要求，跳過某些階段。

2.4 maven的"約定優(yōu)于配置"

所謂的"約定優(yōu)于配置"，在maven中并不是完全不可以修改的，他們只是一些配置的默認(rèn)值而已。但是使用者除非必要，并不需要去修改那些約定內(nèi)容。maven默認(rèn)的文件存放結(jié)構(gòu)如下：

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

對maven來說，采用"約定優(yōu)于配置"的策略可以減少修改配置的工作量，也可以降低學(xué)習(xí)成本，更重要的是，給項(xiàng)目引入了統(tǒng)一的規(guī)范。

2.5 maven的版本規(guī)范

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

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

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

2.6 maven的組成部分

maven把整個maven管理的項(xiàng)目分為幾個部分，一個部分是源代碼，包括源代碼本身、相關(guān)的各種資源，一個部分則是單元測試用例，另外一部分則是各種maven的插件。對于這幾個部分，maven可以獨(dú)立管理他們，包括各種外部依賴關(guān)系。

2.7 maven的依賴管理

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

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

• groupId 必須
• artifactId 必須
• version 必須。
  這里的version可以用區(qū)間表達(dá)式來表示，比如(2.0,)表示>2.0，[2.0,3.0)表示2.0<=ver<3.0；多個條件之間用逗號分隔，比如[1,3),[5,7]。
• scope 作用域限制
• type 一般在pom引用依賴時候出現(xiàn)，其他時候不用
• optional 是否可選依賴

maven認(rèn)為，程序?qū)ν獠康囊蕾嚂S著程序的所處階段和應(yīng)用場景而變化，所以maven中的依賴關(guān)系有作用域(scope)的限制。在maven中，scope包含如下的取值：

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

2.8 多項(xiàng)目管理

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

按照這種格式存放，就是繼承方式，所有具體子項(xiàng)目的pom.xml都會繼承總項(xiàng)目pom的內(nèi)容，取值為子項(xiàng)目pom內(nèi)容優(yōu)先。

要設(shè)置繼承方式，首先要在總項(xiàng)目的pom中加入如下配置

其次在每個子項(xiàng)目中加入

即可。

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

2.9 屬性

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

• env
  暴露操作系統(tǒng)的環(huán)境變量，比如env.PATH
• project
  暴露POM中的內(nèi)容，用點(diǎn)號(.)的路徑來引用POM元素的值，比如${project.artifactId}。另外，java的系統(tǒng)屬性比如user.dir等，也暴露在這里。
• settings
  暴露maven的settings的信息，也可以用點(diǎn)號(.)來引用。maven把系統(tǒng)配置文件存放在maven的安裝目錄中，把用戶相關(guān)的配置文件存放在~/.m2/settings.xml(unix)或者%USERPROFILE%/.m2/settings.xml(windows)中。

2.10 maven的profile

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

activation節(jié)點(diǎn)中的激活條件中常見的有如下幾個：

1. os
   判斷操作系統(tǒng)相關(guān)的參數(shù)，它包含如下可以自由組合的子節(jié)點(diǎn)元素
   • message - 規(guī)則失敗之后顯示的消息
   • arch - 匹配cpu結(jié)構(gòu)，常見為x86
   • family - 匹配操作系統(tǒng)家族，常見的取值為：dos，mac，netware，os/2，unix，windows，win9x，os/400等
   • name - 匹配操作系統(tǒng)的名字
   • version - 匹配的操作系統(tǒng)版本號
   • display - 檢測到操作系統(tǒng)之后顯示的信息
2. jdk
   檢查jdk版本，可以用區(qū)間表示。
3. property
   檢查屬性值，本節(jié)點(diǎn)可以包含name和value兩個子節(jié)點(diǎn)。
4. file
   檢查文件相關(guān)內(nèi)容，包含兩個子節(jié)點(diǎn)：exists和missing，用于分別檢查文件存在和不存在兩種情況。

3. maven的操作和使用

maven的操作有兩種方式，一種是通過mvn命令行命令，一種是使用maven的eclipse插件。因?yàn)槭褂胑clipse的maven插件操作起來比較容易，這里就只介紹使用mvn命令行的操作。

3.1 maven的配置文件

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

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

3.2 創(chuàng)建新工程

要創(chuàng)建一個新的maven工程，我們需要給我們的工程指定幾個必要的要素，就是maven產(chǎn)品坐標(biāo)的幾個要素：groupId, artifactId，如果愿意，你也可以指定version和package名稱。我們先看一個簡單的創(chuàng)建命令：

首先看這里的命令行參數(shù)的傳遞結(jié)構(gòu)，怪異的 -D參數(shù)=值 的方式是 java.exe 要求的方式。這個命令創(chuàng)建一個web工程，目錄結(jié)構(gòu)是一個標(biāo)準(zhǔn)的maven結(jié)構(gòu)，如下：

大家要注意，這里目錄結(jié)構(gòu)的布局實(shí)際上是由參數(shù) archetypeArtifactId 來決定的，因?yàn)檫@里傳入的是 maven-archetype-webapp 如果我們傳入其他的就會創(chuàng)建不同的結(jié)構(gòu)，默認(rèn)值為 maven-archetype-quickstart ，有興趣的讀者可以參考更詳細(xì)的列表 ，我把部分常用的列表在這里：

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

3.3 maven的多項(xiàng)目管理

多項(xiàng)目管理是maven的主要特色之一，對于一個大型工程，用maven來管理他們之間復(fù)雜的依賴關(guān)系，是再好不過了。maven的項(xiàng)目配置之間的關(guān)系有兩種：繼承關(guān)系和引用關(guān)系。
maven默認(rèn)根據(jù)目錄結(jié)構(gòu)來設(shè)定pom的繼承關(guān)系，即下級目錄的pom默認(rèn)繼承上級目錄的pom。要設(shè)定兩者之間的關(guān)系很簡單，上級pom如下設(shè)置：

要記住的是，這里的module是目錄名，不是子工程的artifactId。子工程如下設(shè)置：

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

引用關(guān)系是另外一種復(fù)用的方式，maven中配置引用關(guān)系也很簡單，加入一個 type 為 pom 的依賴即可。

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

需要特別提出的是復(fù)用過程中，父項(xiàng)目的pom中可以定義 dependencyManagement 節(jié)點(diǎn)，其中存放依賴關(guān)系，但是這個依賴關(guān)系只是定義，不會真的產(chǎn)生效果，如果子項(xiàng)目想要使用這個依賴關(guān)系，可以在本身的 dependency 中添加一個簡化的引用

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

3.4 安裝庫文件到maven庫中

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

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

對于我們的工程輸出，如果需要放置到公司的repository中的話，可以通過配置pom來實(shí)現(xiàn)

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

3.5 maven的變量

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

1. 內(nèi)置屬性
   • ${basedir } represents the directory containing pom.xml
   • ${version } equivalent to ${project.version } or ${pom.version }
2. Pom/Project properties
   所有pom中的元素都可以用 project. 前綴進(jìn)行引用,以下是部分常用的
   • ${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
3. 本地用戶設(shè)定
   所有用的的 settings.xml 中的設(shè)定都可以通過 settings. 前綴進(jìn)行引用
   • ${settings.localRepository } refers to the path of the user's local repository.
   • ${maven.repo.local } also works for backward compatibility with maven1 ??
4. 環(huán)境變量
   系統(tǒng)的環(huán)境變量通過 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:
     <jvm>${java.home}../bin/java.exe</jvm>
5. java系統(tǒng)屬性
   所有JVM中定義的java系統(tǒng)屬性.
6. 用戶在pom中定義的自定義屬性
   <project>
   ...
   <properties>
   <my.filter.value>hello</my.filter.value>
   </properties>
   ...
   </project>
   

   則引用 ${my.filter.value } 就會得到值 hello
7. 上級工程的變量
   上級工程的pom中的變量用前綴 ${project.parent } 引用. 上級工程的版本也可以這樣引用: ${parent.version }.

3.6 maven的使用

我們已經(jīng)知道m(xù)aven預(yù)定義了許多的階段（phase），每個插件都依附于這些階段，并且在進(jìn)入某個階段的時候，調(diào)用運(yùn)行這些相關(guān)插件的功能。我們先來看完整的maven生命周期：

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

1. clean插件
   只包含一個goal叫做 clean:clean ，負(fù)責(zé)清理構(gòu)建時候創(chuàng)建的文件。 默認(rèn)清理的位置是如下幾個變量指定的路徑 project.build.directory, project.build.outputDirectory, project.build.testOutputDirectory, and project.reporting.outputDirectory 。
2. compiler插件
   包含2個goal，分別是 compiler:compile 和 compiler:testCompile 。可以到這里查看兩者的具體參數(shù)設(shè)置：compile , testCompile 。
3. surefire插件
   運(yùn)行單元測試用例的插件，并且能夠生成報表。包含一個goal為 surefire:test 。主要參數(shù)testSourceDirectory用來指定測試用例目錄，參考完整用法幫助
4. jar
   負(fù)責(zé)將工程輸出打包到j(luò)ar文件中。包含兩個goal，分別是 jar:jar , jar:test-jar 。兩個goal負(fù)責(zé)從classesDirectory或testClassesDirectory中獲取所有資源，然后輸出jar文件到outputDirectory中。
5. war
   負(fù)責(zé)打包成war文件。常用goal有 war:war ，負(fù)責(zé)從warSourceDirectory（默認(rèn)${basedir}/src/main/webapp）打包所有資源到outputDirectory中。
6. resources
   負(fù)責(zé)復(fù)制各種資源文件，常用goal有 resources:resources ，負(fù)責(zé)將資源文件復(fù)制到outputDirectory中，默認(rèn)為${project.build.outputDirectory}。
7. install
   負(fù)責(zé)將項(xiàng)目輸出(install:install)或者某個指定的文件(install:install-file)加入到本機(jī)庫%USERPROFILE%/.m2/repository中。可以用 install:help 尋求幫助。
8. deploy
   負(fù)責(zé)將項(xiàng)目輸出(deploy:deploy)或者某個指定的文件(deploy:deploy-file)加入到公司庫中。
9. site
   將工程所有文檔生成網(wǎng)站，生成的網(wǎng)站界面默認(rèn)和apache的項(xiàng)目站點(diǎn)類似，但是其文檔用doxia格式寫的，目前不支持docbook，需要用其他插件配合才能支持。需要指出的是，在maven 2.x系列中和maven3.x的site命令處理是不同的，在舊版本中，用 mvn site 命令可以生成reporting節(jié)點(diǎn)中的所有報表，但是在maven3中，reporting過時了，要把這些內(nèi)容作為 maven-site-plugin的configuration的內(nèi)容才行。詳細(xì)內(nèi)容可以參考http://www.wakaleo.com/blog/292-site-generation-in-maven-3
   

4. maven的使用問答

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

1. maven 自己的FAQ

兄弟們?nèi)绻衅渌麊栴}，歡迎跟帖提問！

4.1 依賴關(guān)系

1) 問：如何增加刪除一個依賴關(guān)系？

答：直接在pom文件中加入一個dependency節(jié)點(diǎn)，如果要刪除依賴，把對應(yīng)的dependency節(jié)點(diǎn)刪除即可。

2) 問：如何屏蔽一個依賴關(guān)系？比如項(xiàng)目中使用的libA依賴某個庫的1.0版，libB以來某個庫的2.0版，現(xiàn)在想統(tǒng)一使用2.0版，如何去掉1.0版的依賴？

答：設(shè)置exclusion即可。

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

答：加入一個特殊的依賴關(guān)系，使用system類型，如下：

但是要記住，發(fā)布的時候不會復(fù)制這個jar。需要手工配置，而且其他project依賴這個project的時候，會報告警告。如果沒有特殊要求，建議直接注冊發(fā)布到repository。

4) 問：在eclipse環(huán)境中同時使用maven builder和eclipse builder，并且設(shè)置項(xiàng)目依賴關(guān)系之后，為什么編譯會出現(xiàn)artifact找不到錯誤，但是直接使用命令行mvn構(gòu)建則一切正常？

答：在project屬性中去掉java build path中對其他 project 的依賴關(guān)系，直接在pom中設(shè)置依賴關(guān)系即可

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

答：使用 assembly 插件即可。

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

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

7)如何讓maven將工程依賴的jar復(fù)制到WEB-INF/lib目錄下？

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

修改pom.xml文件，將舊版jar的依賴內(nèi)容中的版本直接修改為新版本即可。

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) 問：如何使用變量替換？項(xiàng)目中的某個配置文件比如jdbc.properties使用了一些pom中的變量，如何在發(fā)布中使用包含真實(shí)內(nèi)容的最終結(jié)果文件？

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

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

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

這段代碼負(fù)責(zé)把resource文件中的內(nèi)容替換成適當(dāng)內(nèi)容

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

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

<project>
  [...]
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
        <version>2.8</version>
        <configuration>
          <skipTests>true</skipTests>
        </configuration>
      </plugin>
    </plugins>
  </build>
  [...]
</project>

4) 如果只想運(yùn)行單個測試用例，能否實(shí)現(xiàn)？

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

4.3 編譯

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

答：以下內(nèi)容設(shè)定編譯器編譯java1.5的代碼

2) 問：我的目錄是非標(biāo)準(zhǔn)的目錄結(jié)構(gòu)，如何設(shè)置讓maven支持？

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

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

設(shè)置一個變量即可

{code:xml}
<build>
  ...
    <plugin>
      <artifactId>maven-compiler-plugin</artifactId>
      <configuration>
        <encoding>UTF-8</encoding>
      </configuration>
    </plugin>
  ...
</build>
{code}

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

{code:xml}
<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>native-maven-plugin</artifactId>
    <extensions>true</extensions>
    <configuration>
</plugin>    
{code}

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

{code:xml}
<project>
  [...]
  <build>
    <plugins>
      <plugin>
        <artifactId>maven-assembly-plugin</artifactId>
        <configuration>
          <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
          </descriptorRefs>
        </configuration>
      </plugin>
    </plugins>
  </build>
  [...]
</project>
{code}

mvn assembly:assembly

. 問：我想把main/scripts中的內(nèi)容一起打包發(fā)布，如何做？

{code:xml}
<build>
  ...
  <resources>
    <resource>
      <filtering>true</filtering>
      <directory>src/main/command</directory>
      <includes>
        <include>run.bat</include>
        <include>run.sh</include>
      </includes>
      <targetPath>/abc</targetPath>
    </resource>
    <resource>
      <directory>src/main/scripts</directory>
    </resource>
  </resources>
  ...
</build>
{code}

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

{code:xml}
<plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>build-helper-maven-plugin</artifactId>
        <version>1.1</version>
        <executions>
          <execution>
            <id>add-source</id>
            <phase>generate-sources</phase>
            <goals>
              <goal>add-source</goal>
            </goals>
            <configuration>
              <sources>
                <source>src/config/java</source>
                <source>src/main/java</source>
                <source>src/member/java</source>
              </sources>
            </configuration>
          </execution>
        </executions>
      </plugin>
{code}

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

{code:xml}
<build>
  <sourceDirectory>http://www.cnblogs.com/src/java</sourceDirectory>
  <plugins>
    <plugin>
      <groupId>com.sun.enterprise</groupId>
      <artifactId>hk2-maven-plugin</artifactId>
      <configuration>
        <includes>
          <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>
        <excludes>
          <exclude>com/sun/enterprise/config/ConfigBeansFactory.java</exclude>
          <exclude>com/sun/enterprise/config/clientbeans/**</exclude>
        </excludes>
      </configuration>
    </plugin>
  </plugins>
  <resources>
    <resource>
      <directory>http://www.cnblogs.com/src/java</directory>
      <includes>
        <include>**/*.properties</include>
      </includes>
    </resource>
  </resources>
</build>
{code}

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

{code:xml}
<build>
  <sourceDirectory>src/java</sourceDirectory>
  <plugins>
    <plugin>
    <groupId>com.sun.enterprise</groupId>
    <artifactId>hk2-maven-plugin</artifactId>
    </plugin>
  </plugins>
</build>
{code}

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

hibernate3-maven-plugin

{code:xml}
        <plugin>
          <groupId>org.codehaus.mojo</groupId>
          <artifactId>hibernate3-maven-plugin</artifactId>
          <version>2.1</version>
          <configuration>
            <components>
              <component>
                <name>hbm2ddl</name>
                <implementation>annotationconfiguration</implementation>
              </component>
            </components>
          </configuration>
          <dependencies>
            <dependency>
              <groupId>hsqldb</groupId>
              <artifactId>hsqldb</artifactId>
              <version>${hsqldb.version}</version>
            </dependency>
          </dependencies>
        </plugin>
{code}

. 問：我能用maven支持eclipse RCP項(xiàng)目嗎？

答：當(dāng)然可以，你可以使用插件 Tycho，詳細(xì)內(nèi)容可以參考這里[http://mattiasholmqvist.se/2010/02/building-with-tycho-part-1-osgi-bundles/].

 <plugin>
  <groupid>org.sonatype.tycho</groupid>
  <artifactid>target-platform-configuration</artifactid>
  <version>0.7.0</version>
  <configuration>
    <resolver>p2</resolver>
  </configuration>
</plugin>
另外，老牌的pde-maven-plugin就不要用了，已經(jīng)好幾年沒見更新了。

4.4 ant互動

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

使用專門的antrun插件，并且在target標(biāo)簽內(nèi)部加入ant的代碼

      <plugin>
        <artifactId>maven-antrun-plugin</artifactId>
        <version>1.6</version>
        <executions>
          <execution>
            <phase> <!-- 生命周期階段 --> </phase>
            <configuration>
              <target>
                <!-- 加入target內(nèi)部的代碼 -->
              </target>
            </configuration>
            <goals>
              <goal>run</goal>
            </goals>
          </execution>
        </executions>
      </plugin>

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

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

<echo message="Dependency JAR Path: ${org.apache:common-util:jar}"/> 

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

• maven.compile.classpath
• maven.runtime.classpath
• maven.test.classpath
• maven.plugin.classpath

3）如何使用antrun插件運(yùn)行外部的build文件？

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

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-antrun-plugin</artifactId>
    <version>1.6</version>
    <executions>
        <execution>
            <id>compile</id>
            <phase>compile</phase>
            <configuration>
                <target>
                    <!-- 同時傳遞內(nèi)置的classpath給外部ant文件 -->
                    <property name="compile_classpath" refid="maven.compile.classpath"/>
                    <property name="runtime_classpath" refid="maven.runtime.classpath"/>
                    <property name="test_classpath" refid="maven.test.classpath"/>
                    <property name="plugin_classpath" refid="maven.plugin.classpath"/>
    
                    <ant antfile="${basedir}/build.xml">
                        <target name="test"/>
                    </ant>
                </target>
            </configuration>
            <goals>
                <goal>run</goal>
            </goals>
        </execution>
    </executions>
</plugin>

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

h4. 測試相關(guān)

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

<skip>true</skip>

{code:xml}
<project>
  [...]
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
        <configuration>
          <testFailureIgnore>true</testFailureIgnore>
        </configuration>
      </plugin>
    </plugins>
  </build>
  [...]
</project>
{code}

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

reporting

mvn site

build

{code:xml}
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-pmd-plugin</artifactId>
        <version>2.5</version>
      </plugin>
    </plugins>
{code}

{code:xml}
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-checkstyle-plugin</artifactId>
        <version>2.5</version>
      </plugin>
{code}

{code:xml}
      <build>
         <plugins>
            <plugin>
               <groupId>org.codehaus.mojo</groupId>
               <artifactId>simian-maven-plugin</artifactId>
               <version>1.6.1</version>
            </plugin>
         </plugins>
         ...
      </build>
{code}

{code:xml}
      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>jdepend-maven-plugin</artifactId>
        <version>2.0-beta-2</version>
      </plugin>
{code}

{code:xml}
      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>findbugs-maven-plugin</artifactId>
        <version>2.0.1</version>
      </plugin>
{code}

{code:xml}
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>2.7</version>
        <configuration>
          ...
        </configuration>
      </plugin>
{code}

{code:xml}
  <reporting>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-jxr-plugin</artifactId>
        <version>2.1</version>
      </plugin>
    </plugins>
  </reporting>
{code}

{code:xml|title=Cobertura }
      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>cobertura-maven-plugin</artifactId>
        <version>2.4</version>
        <configuration>
          <check>
            <branchRate>85</branchRate>
            <lineRate>85</lineRate>
            <haltOnFailure>true</haltOnFailure>
            <totalBranchRate>85</totalBranchRate>
            <totalLineRate>85</totalLineRate>
            <packageLineRate>85</packageLineRate>
            <packageBranchRate>85</packageBranchRate>
            <regexes>
              <regex>
                <pattern>com.example.reallyimportant.*</pattern>
                <branchRate>90</branchRate>
                <lineRate>80</lineRate>
              </regex>
              <regex>
                <pattern>com.example.boringcode.*</pattern>
                <branchRate>40</branchRate>
                <lineRate>30</lineRate>
              </regex>
            </regexes>
          </check>
        </configuration>
        <executions>
          <execution>
            <goals>
              <goal>clean</goal>
              <goal>check</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
{code}

{code:xml|title=EMMA}
  <reporting>
    ...
    <plugins>
      ...
      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>emma-maven-plugin</artifactId>
        <version>1.0-alpha-3-SNAPSHOT</version>
      </plugin>
      ...
    </plugins>
    ...
  </reporting>
{code}

{code:xml}
  <reporting>
    <plugins>
      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>javancss-maven-plugin</artifactId>
        <version>2.0-beta-2</version>
      </plugin>
    </plugins>
  </reporting>
{code}

. 問：profile能夠設(shè)置為某個變量不存在的條件下激活？

{code:xml}
<activation>
        <property>
          <name>!environment.type</name>
        </property>
      </activation>
{code}

. 問：其他部署到服務(wù)器的方式和配置怎么配？

{code:xml}
<distributionManagement>
  <repository>
    <id>proficio-repository<id>
    <name>Proficio Repository<name>
    <url>file://${basedir}/target/deploy<url>
  <repository>
<distributionManagement>
{code}

{code:xml}
<distributionManagement>
  <repository>
    <id>proficio-repository<id>
    <name>Proficio Repository<name>
    <url>scp://sshserver.yourcompany.com/deploy<url>
  <repository>
<distributionManagement>
{code}

{code:xml}
<distributionManagement>
  <repository>
    <id>proficio-repositoryi<d>
    <name>Proficio Repository<name>
    <url>sftp://ftpserver.yourcompany.com/deploy<url>
  <repository>
<distributionManagement>
{code}

{code:xml}
<distributionManagement>
  <repository>
    <id>proficio-repository<id>
    <name>Proficio Repository<name>
    <url>scpexe://sshserver.yourcompany.com/deploy<url>
  <repository>
<distributionManagement>
<build>
  <extensions>
    <extension>
      <groupId>org.apache.maven.wagon<groupId>
      <artifactId>wagon-ssh-external<artifactId>
      <version>1.0-alpha-6<version>
    <extension>
  <extensions>
<build>
{code}

{code:xml}
<distributionManagement>
  <repository>
    <id>proficio-repository<id>
    <name>Proficio Repository<name>
    <url>ftp://ftpserver.yourcompany.com/deploy<url>
  <repository>
<distributionManagement>
<build>
  <extensions>
    <extension>
      <groupId>org.apache.maven.wagongroupId>
      <artifactId>wagon-ftpartifactId>
      <version>1.0-alpha-6version>
    <extension>
  <extensions>
<build>
{code}

. 問：我用maven輸出site，如何設(shè)置輸出為utf8編碼？

{code:xml}
...
  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-site-plugin</artifactId>
    <version>2.0-beta-6</version>
    <configuration>
      <outputEncoding>UTF-8</outputEncoding>
    </configuration>
  </plugin>
  ...
{code}

. 問：