一個Maven2工程的核心就是這一個pom.xml，它包含了你的工程詳細資訊，如：版本、配置、依賴、測試、專案成員等等。學習maven2主要就是學習如何配置pom.xml。

一個簡單的而完全可操作的pom.xml如下所示：

<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion> <!--maven2-->
<groupId>ctzj_bss</groupId> <!-- 這個專案所屬組的id，一般是專案所在的公司或組織的域名 -->
<artifactId>NRC</artifactId> <!-- 專案的id,和groupId一起組成這個專案的一個唯一id，以用在別的maven2工程中 -->
<packaging>jar</packaging> <!-- 最後這個工程的打包型別,在這裡是打成jar包 -->
<version>1.0</version> <!-- 版本號 -->
<name>kenan nrc batch</name> <!-- 專案名, 區別於artifactId-->
<description>insert a nrc in kenan db</description> <!-- 專案描述,會出現在生成的工程站點上 -->
<build> <!-- 專案的構建資訊 -->
<sourceDirectory>src</sourceDirectory>
<testSourceDirectory>test</testSourceDirectory>
<outputDirectory>target\classes</outputDirectory>
<testOutputDirectory>target\test-classes</testOutputDirectory>
<directory>target</directory> <!-- 構建後生成檔案(jar,site等)所在位置 -->
</build>
<dependencies> <!-- 專案的依賴外接包,maven的優勢之一 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>
<reporting> <!-- 專案報表,有很多外掛可供選擇 -->
<outputDirectory>target/site</outputDirectory>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
</plugin>
</plugins>
</reporting>
</project>


在你配置了你的pom檔案後，你就可以使用如下命令來執行maven2

mvn compiler:compile 編譯你的原檔案
mvn jar:jar 打包
mvn site:site 生成專案站點


接下來逐個介紹pom.xml的各個要素

developor,organization and mail lit
build
dependencies
reporting

1.developor,organization and mail list

可以在pom中加入開發人員列表,專案所屬組織資訊,郵件列表,這些資訊會出現在生成的專案站點上

<organization>
<name>CTZJ BSS</name>
</organization>
<developers>
<developer>
<name>Chen Lin</name>
<organization>ZJHCsoft</organization>
<email>

[email protected]</email>
</developer>
</developers>
<mailingLists>
<mailingList>
<name>${pom.name} Dev List</name>
</mailingList>
<mailingList>
<name>${pom.name} User List</name>
</mailingList>
</mailingLists>

2. build

配置專案的構建資訊,主要有指定目錄,包括原始碼、測試原始碼、輸出目錄、資源目錄等.如果沒有特殊需求以上的pom已經足夠了

3. dependencies

配置專案要用到的jar包.自認為maven對jar包的管理是它的一個重要特色.下面是一個jar包的配置:

<dependency>
<groupId>concurrent</groupId>
<artifactId>concurrent</artifactId>
<version>1.3.4</version>
<scope>compile</scope>
</dependency>

groupId: 沒有特定的含義,一般來自同一組織的jar包會有相同的groupId值
artifactId: 這個jar的id,一般是這個jar包的名稱
version: jar包的版本號,一般情況下,artifactId-version.jar就是這個jar包的檔名
scope: 這個jar所影響的範圍,compile指它會在編譯原始碼時用到.還有test,provide,runtime等值

如果你不知道jar包的groupId和artifactId，可以到http://www.mavenregistry.com/ 進行查詢

一旦指定後,當你進行編譯時，它就會到你的本地資源庫

另,如果你引入本地包，則需要先行將它安裝到本地資料庫(repository),使用如下命令

mvn install:install-file -DgroupId=%groupId% -DartifactId=%artifactId% -DgeneratePom=true -Dfile=%file% -Dpackaging=jar -Dversion=%version%

4. reporting

通過使用相應的report plug-in可以生成各種各樣的report.如javadoc,junit test report,程式碼檢查等

常用的常見有

<plugin>
<groupId>org.apache.maven.plugins</groupId> <!--java doc -->
<artifactId>maven-javadoc-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId> <!-- 程式碼檢查 -->
<artifactId>maven-checkstyle-plugin</artifactId>
<configuration>
<configLocation>config/sun_checks.xml</configLocation>
</configuration>
</plugin>
<plugin>
<groupId>org.codehaus.mojo</groupId> <!-- test 結果報表 -->
<artifactId>surefire-report-maven-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.codehaus.mojo</groupId> <!-- 原始碼的HTML化 -->
<artifactId>jxr-maven-plugin</artifactId>
</plugin>

在maven的官方網站有可以找到更多的report plugin


最後一個比較完整的pom.xml看起來像這樣：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<name>CutoverModule</name>
<groupId>ctzj_batch</groupId>
<artifactId>eai_cutover</artifactId>
<url>http://134.98.83.137:8081/scarab/issues</url>
<inceptionYear>2006</inceptionYear>
<organization>
<name>CTZJ BSS</name>
<url>http://www.zjhcsoft.com</url>
</organization>
<version>1.0</version>
<description>97 cutover batch module:invoke eai-adapter to update the phone number or value of
c4/c5</description>
<developers>
<developer>
<name>Chen Lin</name>
<organization>ZJHCSoft</organization>
<email>

[email protected]</email>
</developer>
</developers>
<mailingLists>
<mailingList>
<name>${pom.name} Dev List</name>
</mailingList>
</mailingLists>
<build>
<sourceDirectory>src</sourceDirectory>
<testSourceDirectory>test</testSourceDirectory>
<outputDirectory>target\classes</outputDirectory>
<testOutputDirectory>target\test-classes</testOutputDirectory>
<directory>target</directory>
<plugins>
<plugin>
<artifactId>maven-clean-plugin</artifactId>
<version>2.1</version>
</plugin>
<plugin>
<artifactId>maven-resources-plugin</artifactId>
<version>2.1</version>
</plugin>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>2.0</version>
</plugin>
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.1.2</version>
</plugin>
<plugin>
<artifactId>maven-jar-plugin</artifactId>
<version>2.0</version>
</plugin>
<plugin>
<artifactId>maven-install-plugin</artifactId>
<version>2.1</version>
</plugin>
</plugins>
</build>
<ciManagement>
<system>continuum</system>
<url>http://localhost:8080/continuum/servlet/continuum</url>
</ciManagement>
<scm>
<connection>scm:local|E:/eclipseworkshop|EAIBatch</connection>
</scm>
<dependencies>
<dependency>
<groupId>ctzj_batch</groupId>
<artifactId>Eaiadapter</artifactId>
<version>1.0</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>ctzj_batch</groupId>
<artifactId>ta</artifactId>
<version>1.0</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>ctzj_batch</groupId>
<artifactId>grnds-common</artifactId>
<version>4.1</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>concurrent</groupId>
<artifactId>concurrent</artifactId>
<version>1.3.4</version>
<scope>compile</scope>
</dependency>
</dependencies>
<reporting>
<outputDirectory>target/site</outputDirectory>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-checkstyle-plugin</artifactId>
<configuration>
<configLocation>config/sun_checks.xml</configLocation>
</configuration>
</plugin>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>surefire-report-maven-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>jxr-maven-plugin</artifactId>
</plugin>
</plugins>
</reporting>
</project>






maven的POM結構
[ 作者： | 來源：| 點選數： <script src="maven的POM結構-教程-原始碼-下載.files/Click.htm" type="text/javascript"></script> 65 ]
<!-- 參加開發的人員 -->
<developers>
<developer>
<name>Dave Blackett (Jetspeed logos)</name>
<id/>
<email>

[email protected]</email>
<organization/>
</developer>
......
</developers>

******專案相關性部分******與一箇中央構件資源庫一起使用，將消除幾個常見的構建問題

<!---------------------------------------------------- -->
<!-- 專案相關性部分 -->
<!---------------------------------------------------- -->

<!--build過程中maven依據之建立classpath，並且maven會到remote repository自動下載這些dependencies ，如type是jar，下載的檔案就是<artifactId>-<version>.jar-->
<dependencies>

<!-- 專案依賴JAR檔案 "activation-1.0.1.jar"，檔案在Maven repository
的activation/jars子目錄，並且如果資源庫中找不到，maven會在自動從maven.repo.remote下載(《maven安裝使用》中提到的修改是因為maven的預設設定遠端資源庫無法連線上)-->
<dependency>
<id>activation</id>
<version>1.0.1</version>
<properties>
<war.bundle.jar>true</war.bundle.jar>
</properties>
</dependency>
</dependencies>


groupId 告訴 Maven 資源庫內哪個子目錄中包含相關性檔案。
artifactId 告訴 Maven 該構件的唯一標識。如果是jar檔案，可以理解為去掉字尾和版本號的檔名 。
version 表示相關性的版本號。
jar （可選的）表示相關性的 JAR 檔案。在絕大多數情況下，可以從相關性的 <artifactId> 和 <version> 構造 JAR 檔案的名稱。
type （可選的）相關性的型別；如 jar 和分發版等。預設值是 jar。
url 可選的）相關性專案的 URL，在相關性是在因特網上找到的第三方庫時非常有用。
properties dependency還有properties可以設定，具體要參照各自引用的plugin


******專案構建部分******
<!---------------------------------------------------- -->
<!-- 專案build和reports部分 -->
<!---------------------------------------------------- -->

<build>
<!-- (OPTIONAL) 定義原始檔位置. -->
<sourceDirectory>src/java</sourceDirectory>

<!-- (OPTIONAL) 定義單元測試原始檔位置. -->
<unitTestSourceDirectory>test/java</unitTestSourceDirectory>

<!-- (OPTIONAL) 單元測試用例檔案模式. -->
<unitTest>
<!-- 排除測試 -->
<excludes>
<exclude>org/apache/jetspeed/services/registry/TestRegistryCategories.java</exclude>
......
</excludes>
<!-- 包含測試 -->
<includes>
<include>**/Test*.java</include>
</includes>
<!-- 單元測試使用的資源 -->
<resources>
<resource>
<!-- 資源位置，project.xml的相對路徑 -->
<directory>${basedir}/src/java</directory>
<!-- 排除檔案 -->
<excludes>
<exclude>**/*.java</exclude>
</excludes>
<!-- 包含檔案 -->
<includes>
<include>org/apache/jetspeed/modules/localization/JetspeedLocalization_*.properties</include>
</includes>
</resource>
.......
</resources>
</unitTest>

<!-- 專案使用的資源，結構與單元測試使用的資源結構相同 -->
<resources>
<resource>
......
</resource>
.......
</resources>

<!-- (OPTIONAL) 使用maven site生成站點的時候被引用，並以指定的順序排列在導航條內，report指定生成報告的plugin -->
<reports>
<report>
<report>maven-tasklist-plugin</report>
<report>maven-changelog-plugin</report>
<report>maven-javadoc-plugin</report>