我的Java路上那些事兒

1.前言

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

2. maven概要

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

2.1 maven不是什么

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

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

2.2 maven是什么

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

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

2.3 maven的生命周期

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

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

2.4 maven的"約定優于配置"

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

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

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

2.5 maven的版本規范

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

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"。各個部分的含義和處理邏輯如下說明：

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包含如下的取值：

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

2.8 多項目管理

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

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

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

其次在每個子項目中加入

即可。

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

2.9 屬性

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

• 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節點中的激活條件中常見的有如下幾個：

1. os
   判斷操作系統相關的參數，它包含如下可以自由組合的子節點元素
   • message - 規則失敗之后顯示的消息
   • arch - 匹配cpu結構，常見為x86
   • family - 匹配操作系統家族，常見的取值為：dos，mac，netware，os/2，unix，windows，win9x，os/400等
   • name - 匹配操作系統的名字
   • version - 匹配的操作系統版本號
   • display - 檢測到操作系統之后顯示的信息
2. jdk
   檢查jdk版本，可以用區間表示。
3. property
   檢查屬性值，本節點可以包含name和value兩個子節點。
4. 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參數=值 的方式是 java.exe 要求的方式。這個命令創建一個web工程，目錄結構是一個標準的maven結構，如下：

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

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

3.3 maven的多項目管理

多項目管理是maven的主要特色之一，對于一個大型工程，用maven來管理他們之間復雜的依賴關系，是再好不過了。maven的項目配置之間的關系有兩種：繼承關系和引用關系。
maven默認根據目錄結構來設定pom的繼承關系，即下級目錄的pom默認繼承上級目錄的pom。要設定兩者之間的關系很簡單，上級pom如下設置：

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

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

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

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

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

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

3.4 安裝庫文件到maven庫中

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

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

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

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

3.5 maven的變量

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

1. 內置屬性
   • ${basedir } represents the directory containing pom.xml
   • ${version } equivalent to ${project.version } or ${pom.version }
2. 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
3. 本地用戶設定
   所有用的的 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 ??
4. 環境變量
   系統的環境變量通過 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系統屬性
   所有JVM中定義的java系統屬性.
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的使用

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

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

1. clean插件
   只包含一個goal叫做 clean:clean ，負責清理構建時候創建的文件。 默認清理的位置是如下幾個變量指定的路徑 project.build.directory, project.build.outputDirectory, project.build.testOutputDirectory, and project.reporting.outputDirectory 。
2. compiler插件
   包含2個goal，分別是 compiler:compile 和 compiler:testCompile 。可以到這里查看兩者的具體參數設置：compile , testCompile 。
3. surefire插件
   運行單元測試用例的插件，并且能夠生成報表。包含一個goal為 surefire:test 。主要參數testSourceDirectory用來指定測試用例目錄，參考完整用法幫助
4. jar
   負責將工程輸出打包到jar文件中。包含兩個goal，分別是 jar:jar , jar:test-jar 。兩個goal負責從classesDirectory或testClassesDirectory中獲取所有資源，然后輸出jar文件到outputDirectory中。
5. war
   負責打包成war文件。常用goal有 war:war ，負責從warSourceDirectory（默認${basedir}/src/main/webapp）打包所有資源到outputDirectory中。
6. resources
   負責復制各種資源文件，常用goal有 resources:resources ，負責將資源文件復制到outputDirectory中，默認為${project.build.outputDirectory}。
7. install
   負責將項目輸出(install:install)或者某個指定的文件(install:install-file)加入到本機庫%USERPROFILE%/.m2/repository中。可以用 install:help 尋求幫助。
8. deploy
   負責將項目輸出(deploy:deploy)或者某個指定的文件(deploy:deploy-file)加入到公司庫中。
9. 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可以參考

1. maven 自己的FAQ

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

4.1 依賴關系

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

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

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

答：設置exclusion即可。

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

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

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

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

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

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

答：使用 assembly 插件即可。

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

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

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中的變量，如何在發布中使用包含真實內容的最終結果文件？

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

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

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

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

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

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

<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) 如果只想運行單個測試用例，能否實現？

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

4.3 編譯

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

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

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

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

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

設置一個變量即可

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

. 問：我的項目除了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中的內容一起打包發布，如何做？

{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}

. 問：我的項目是一個純的html組成的項目，沒有任何的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項目嗎？

答：當然可以，你可以使用插件 Tycho，詳細內容可以參考這里[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就不要用了，已經好幾年沒見更新了。

4.4 ant互動

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

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

      <plugin>
        <artifactId>maven-antrun-plugin</artifactId>
        <version>1.6</version>
        <executions>
          <execution>
            <phase> <!-- 生命周期階段 --> </phase>
            <configuration>
              <target>
                <!-- 加入target內部的代碼 -->
              </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還預定義了四個classpath的引用，他們是

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

3）如何使用antrun插件運行外部的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>
                    <!-- 同時傳遞內置的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. 測試相關

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

<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能夠設置為某個變量不存在的條件下激活？

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

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

{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，如何設置輸出為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}

. 問：