Maven pom.xml配置详解

POM是项目对象模型(Project Object Model)的简称，它是Maven项目中的文件，使用XML表示，名称叫做pom.xml。在Maven中，一个Project往往包含一个配置文件，包括了开发者需要遵循的规则，缺陷管理系统，组织和licenses，项目的url，项目的依赖性，以及其他所有的项目相关因素。

[html] view plain copy

1. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
2.   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">  
3.      <modelVersion>4.0.0</modelVersion>  
4.   
5.      <!-- 基本设置 -->  
6.      <groupId>...</groupId>  
7.      <artifactId>...</artifactId>  
8.      <version>...</version>  
9.      <packaging>...</packaging>  
10.      <dependencies>...</dependencies>  
11.      <parent>...</parent>  
12.      <dependencyManagement>...</dependencyManagement>  
13.      <modules>...</modules>  
14.      <properties>...</properties>  
15.   
16.      <!-- 构建过程的设置 -->  
17.      <build>...</build>  
18.      <reporting>...</reporting>  
19.   
20.      <!-- 项目信息设置 -->  
21.      <name>...</name>  
22.      <description>...</description>  
23.      <url>...</url>  
24.      <inceptionYear>...</inceptionYear>  
25.      <licenses>...</licenses>  
26.      <organization>...</organization>  
27.      <developers>...</developers>  
28.      <contributors>...</contributors>  
29.   
30.      <!-- 环境设置 -->  
31.      <issueManagement>...</issueManagement>  
32.      <ciManagement>...</ciManagement>  
33.      <mailingLists>...</mailingLists>  
34.      <scm>...</scm>  
35.      <prerequisites>...</prerequisites>  
36.      <repositories>...</repositories>  
37.      <pluginRepositories>...</pluginRepositories>  
38.      <distributionManagement>...</distributionManagement>  
39.      <profiles>...</profiles>  
40.  </project>  

1. POM模型信息设置

modelVersion：指定了当前POM模型的版本，对于Maven2及Maven3来说，它只能是4.0.0。

2.  Maven坐标设置

groupId（必选）：定义了项目属于哪个组，这个组往往和项目所在的组织或公司存在关联，譬如如果你的公司是zing，有一个项目为app，那么groupId就应该是com.zing.app。
artifactId（必选）：定义了当前Maven项目在组中唯一的ID。
version（必选）：指定了项目当前的版本。
packaging：指定打包类型，可以是war，jar，pom等形式，当不定义packaging的时候，Maven 会使用默认值jar。
classifier: 该元素用来帮助定义构建输出的一些附件。附属构件与主构件对应，如主构件为app-0.0.1-SNAPSHOT.jar，该项目可能还会通过一些插件生成如app-0.0.1-SNAPSHOT-javadoc.jar，app-0.0.1-SNAPSHOT-sources.jar, 这样附属构件也就拥有了自己唯一的坐标。

3. 项目信息设置

name：项目名称
url：项目主页的URL
description：项目的详细描述
inceptionYear：创始年份
Licenses：许可协议
Organization：组织信息
Developers：开发者信息
Contributors：贡献者信息

4. 继承关系设置

[html] view plain copy

1. <parent>  
2.   <groupId>org.zing.app</groupId>  
3.   <artifactId>app-parent</artifactId>  
4.   <version>1.0</version>  
5.   <relativePath>../app-parent</relativePath>  
6. </parent>  

relativePath：设置父项目的pom.xml文件的相对路径。默认值为../pom.xml。

在主pom中可以把依赖通过<dependecyManagement>引起来，表示子pom可能会用到的jar包依赖

[html] view plain copy

1. <dependencyManagement>  
2.    <dependencies>  
3.       <dependency>  
4.           <groupId>javax.servlet</groupId>  
5.           <artifactId>servlet-api</artifactId>  
6.           <version>2.5</version>  
7.       </dependency>  
8.    </dependencies>  
9. </dependencyManagement>  

子pom如果需要引用该jar包，则直接引用即可，不需要加入<version>，便于统一管理。

5. 依赖关系设置

[html] view plain copy

1. <dependencies>  
2.   <dependency>  
3.     <groupId>junit</groupId>  
4.     <artifactId>junit</artifactId>  
5.     <version>4.0</version>  
6.     <type>jar</type>  
7.     <scope>test</scope>  
8.     <optional>true</optional>  
9.   </dependency>  
10.   ...  
11. </dependencies>  

groupId, artifactId, version：描述了依赖的项目唯一标志
type：相应的依赖产品包形式，如jar，war
scope：用于限制相应的依赖范围，compile、provided、runtime、test、system:需要外在提供相应得元素。通过systemPath来取得
optional: 可选依赖，如果将optional设置为true，那么依赖该项目的另外项目将不会得到此依赖的传递。
exclusions：排除依赖，exclusions可以包含一个或者多个exclusion子元素，因此可以排除一个或者多个传递性依赖。声明exclusion的时候只需要groupId和artifactId，而不需要version元素，这是因为只需要groupId和artifactId就能唯一定位依赖图中的某个依赖。

6. 多重模块设置

一个项目有多个模块组成。

[html] view plain copy

1. <project>  
2.   <groupId>org.zing.app</groupId>  
3.   <artifactId>app-parent</artifactId>  
4.   <version>1.0</version>  
5.   <modules>  
6.     <module>app-core<module>  
7.     <module>app-api<module>  
8.   </modules>  
9. </project>  

modules：每个module的值就是maven项目的artifactId 如 <artifactId>app-core</artifactId>

7. build配置项的设置

（1） build可以在两处出现

[html] view plain copy

1. <project>  
2.   <!-- 项目级别的构建 -->  
3.   <build>...</build>  
4.   <profiles>  
5.     <profile>  
6.       <!-- 特殊的构建 -->  
7.       <build>...</build>  
8.     </profile>  
9.   </profiles>  
10. </project>  

（2）bulid的基本元素

[html] view plain copy

1. <build>  
2.   <defaultGoal>install</defaultGoal>  
3.   <directory>${basedir}/target</directory>  
4.   <finalName>${artifactId}-${version}</finalName>  
5.   <filters>  
6.     <filter>filters/filter1.properties</filter>  
7.   </filters>  
8.   <resources>  
9.     ...  
10.   </resources>  
11.   <testResources>  
12.     ...  
13.   </testResources>  
14.   <plugins>  
15.     ...  
16.   </plugins>  
17.   ...  
18. </build>  

defaultGoal: 定义默认的目标或者阶段。
directory: build输出的目录，默认是 ${basedir}/target。
finalName: 产生的构件的文件名，默认值是${artifactId}-${version}。
filter: 定义用于替换相应的属性文件（设置所有placehold的值），使用maven定义的属性。
resources：资源列表，项目中需要指定的资源，resources可以包含一个或者多个resource子元素
testResources: 测试资源列表。

（3） resources

[html] view plain copy

1. <resources>  
2.   <resource>  
3.     <targetPath>META-INF/plexus</targetPath>  
4.     <filtering>false</filtering>  
5.     <directory>${basedir}/src/main/plexus</directory>  
6.     <includes>  
7.       <include>configuration.xml</include>  
8.     </includes>  
9.     <excludes>  
10.       <exclude>**/*.properties</exclude>  
11.     </excludes>  
12.   </resource>  
13. </resources>  

targetPath: 指定目标路径，用于放置资源，用于build
filtering: 是否替换资源中的属性placehold
directory: 资源所在的位置
includes: 包括那些资源
excludes: 排除的资源

（4）plugins

[html] view plain copy

1. <plugins>  
2.   <plugin>  
3.     <groupId>org.apache.maven.plugins</groupId>  
4.     <artifactId>maven-jar-plugin</artifactId>  
5.     <version>2.0</version>  
6.     <extensions>false</extensions>  
7.     <inherited>true</inherited>  
8.     <configuration>  
9.       <classifier>test</classifier>  
10.     </configuration>  
11.     <dependencies>...</dependencies>  
12.     <executions>...</executions>  
13.   </plugin>  
14. </plugins>  

extensions: true or false，是否装载插件扩展。默认false
inherited: true or false，是否此插件配置将会应用于poms，那些继承于此的项目
configuration: 指定插件配置
dependencies: 插件需要依赖的包
executions: 用于配置execution目标，一个插件可以有多个execution目标。
executions的基本配置：

[html] view plain copy

1. <plugin>  
2.     <artifactId>maven-antrun-plugin</artifactId>  
3.     <executions>  
4.       <execution>  
5.         <id>echodir</id>  
6.         <goals>  
7.           <goal>run</goal>  
8.         </goals>  
9.         <phase>verify</phase>  
10.         <configuration>  
11.           <tasks>  
12.             <echo>Build Dir: ${project.build.directory}</echo>  
13.           </tasks>  
14.         </configuration>  
15.       </execution>  
16.     </executions>  
17.   </plugin>  

id:规定execution 的唯一标志
goals: 表示目标
phase: 表示阶段，目标将会在什么阶段执行
inherited: 和上面的元素一样，设置false maven将会拒绝执行继承给子插件
configuration: 表示此执行的配置属性

（5）扩展元素
xxxDirectory，设置各种目录结构

[html] view plain copy

1. <build>  
2.   <sourceDirectory>${basedir}/src/main/java</sourceDirectory>  
3.   <scriptSourceDirectory>${basedir}/src/main/scripts</scriptSourceDirectory>  
4.   <testSourceDirectory>${basedir}/src/test/java</testSourceDirectory>  
5.   <outputDirectory>${basedir}/target/classes</outputDirectory>  
6.   <testOutputDirectory>${basedir}/target/test-classes</testOutputDirectory>  
7.   ...  
8. </build>  

Extensions，表示需要使用的扩展插件。

[html] view plain copy

1. <project>  
2.   <build>  
3.     ...  
4.     <extensions>  
5.       <extension>  
6.         <groupId>org.apache.maven.wagon</groupId>  
7.         <artifactId>wagon-ftp</artifactId>  
8.         <version>1.0-alpha-3</version>  
9.       </extension>  
10.     </extensions>  
11.     ...  
12.   </build>  
13. </project>  

（6）Reporting
用于在site阶段输出报表。特定的maven插件能输出相应的定制和配置报表。

[html] view plain copy

1. <reporting>  
2.   <plugins>  
3.     <plugin>  
4.       <outputDirectory>${basedir}/target/site</outputDirectory>  
5.       <artifactId>maven-project-info-reports-plugin</artifactId>  
6.       <reportSets>  
7.         <reportSet></reportSet>  
8.       </reportSets>  
9.     </plugin>  
10.   </plugins>  
11. </reporting>  

Report Sets用于配置不同的目标，应用于不同的报表

[html] view plain copy

1. <reporting>  
2.   <plugins>  
3.     <plugin>  
4.       ...  
5.       <reportSets>  
6.         <reportSet>  
7.           <id>sunlink</id>  
8.           <reports>  
9.             <report>javadoc</report>  
10.           </reports>  
11.           <inherited>true</inherited>  
12.           <configuration>  
13.             <links>  
14.               <link>http://java.sun.com/j2se/1.5.0/docs/api/</link>  
15.             </links>  
16.           </configuration>  
17.         </reportSet>  
18.       </reportSets>  
19.     </plugin>  
20.   </plugins>  
21. </reporting>  

7. 环境设置

（1）Issue Management
定义相关的bug跟踪系统，如bugzilla,testtrack,clearQuest等。

[html] view plain copy

1. <issueManagement>  
2.   <system>Bugzilla</system>  
3.   <url>http://127.0.0.1/bugzilla</url>  
4. </issueManagement>  

（2）ciManagement（Continuous Integration Management）
连续整合管理，基于triggers或者timings

[html] view plain copy

1. <ciManagement>  
2.   <system>continuum</system>  
3.   <url>http://127.0.0.1:8080/continuum</url>  
4.   <notifiers>  
5.     <notifier>  
6.       <type>mail</type>  
7.       <sendOnError>true</sendOnError>  
8.       <sendOnFailure>true</sendOnFailure>  
9.       <sendOnSuccess>false</sendOnSuccess>  
10.       <sendOnWarning>false</sendOnWarning>  
11.       <configuration><address>continuum@127.0.0.1</address></configuration>  
12.     </notifier>  
13.   </notifiers>  
14. </ciManagement>  

（3）Mailing Lists

[html] view plain copy

1. <mailingLists>  
2.   <mailingList>  
3.     <name>User List</name>  
4.     <subscribe>user-subscribe@127.0.0.1</subscribe>  
5.     <unsubscribe>user-unsubscribe@127.0.0.1</unsubscribe>  
6.     <post>user@127.0.0.1</post>  
7.     <archive>http://127.0.0.1/user/</archive>  
8.     <otherArchives>  
9.       <otherArchive>http://base.google.com/base/1/127.0.0.1</otherArchive>  
10.     </otherArchives>  
11.   </mailingList>  
12. </mailingLists>  

（4）SCM
软件配置管理，如cvs 和svn

[html] view plain copy

1. <scm>  
2.   <connection>scm:svn:http://127.0.0.1/svn/my-project</connection>  
3.   <developerConnection>scm:svn:https://127.0.0.1/svn/my-project</developerConnection>  
4.   <tag>HEAD</tag>  
5.   <url>http://127.0.0.1/websvn/my-project</url>  
6. </scm>  

（5） Repositories
配置同setting.xml中的开发库

（6）Plugin Repositories
配置同repositories

（7） Distribution Management
用于配置分发管理，配置相应的产品发布信息，主要用于发布，在执行mvn deploy后表示要发布的位置

[html] view plain copy

1. <!--配置到文件系统 -->  
2. <distributionManagement>  
3.   <repository>  
4.     <id>proficio-repository</id>  
5.     <name>Proficio Repository</name>  
6.     <url>file://${basedir}/target/deploy</url>  
7.   </repository>  
8. </distributionManagement>  
9. <!--使用ssh2配置 -->  
10. <distributionManagement>  
11.   <repository>  
12.     <id>proficio-repository</id>  
13.     <name>Proficio Repository</name>  
14.     <url>scp://sshserver.yourcompany.com/deploy</url>  
15.   </repository>  
16. </distributionManagement>  
17. <!--使用sftp配置 -->  
18. <distributionManagement>  
19.   <repository>  
20.     <id>proficio-repository</id>  
21.     <name>Proficio Repository</name>  
22.     <url>sftp://ftpserver.yourcompany.com/deploy</url>  
23.   </repository>  
24. </distributionManagement>  

repository 对应于你的开发库，用户信息通过settings.xml中的server取得。


（8）Profiles
类似于settings.xml中的profiles，但是比setting.xml元素多

[html] view plain copy

1. <profiles>  
2.   <profile>  
3.     <id>test</id>  
4.     <activation>...</activation>  
5.     <build>...</build>  
6.     <modules>...</modules>  
7.     <repositories>...</repositories>  
8.     <pluginRepositories>...</pluginRepositories>  
9.     <dependencies>...</dependencies>  
10.     <reporting>...</reporting>  
11.     <dependencyManagement>...</dependencyManagement>  
12.     <distributionManagement>...</distributionManagement>  
13.   </profile>  
14. </profiles>  

8. pom.xml

[html] view plain copy

1. <project xmlns="http://maven.apache.org/POM/4.0.0"  
2.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
3.     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">  
4.     <!--父项目的坐标。如果项目中没有规定某个元素的值，那么父项目中的对应值即为项目的默认值。 坐标包括group ID，artifact ID和 version。-->  
5.     <parent>  
6.      <!--被继承的父项目的构件标识符-->  
7.      <artifactId/>  
8.      <!--被继承的父项目的全球唯一标识符-->  
9.      <groupId/>  
10.      <!--被继承的父项目的版本-->  
11.      <version/>  
12.      <!--父项目的pom.xml文件的相对路径。相对路径允许你选择一个不同的路径。默认值是../pom.xml。Maven首先在构建当前项目的地方寻找父项目的pom，其次在文件系统的这个位置（relativePath位置），然后在本地仓库，最后在远程仓库寻找父项目的pom。-->  
13.      <relativePath/>  
14.  </parent>  
15.  <!--声明项目描述符遵循哪一个POM模型版本。模型本身的版本很少改变，虽然如此，但它仍然是必不可少的，这是为了当Maven引入了新的特性或者其他模型变更的时候，确保稳定性。-->  
16.     <modelVersion>4.0.0</modelVersion>  
17.     <!--项目的全球唯一标识符，通常使用全限定的包名区分该项目和其他项目。并且构建时生成的路径也是由此生成， 如com.mycompany.app生成的相对路径为：/com/mycompany/app-->  
18.     <groupId>asia.banseon</groupId>  
19.     <!--构件的标识符，它和group ID一起唯一标识一个构件。换句话说，你不能有两个不同的项目拥有同样的artifact ID和groupID；在某个特定的group ID下，artifact ID也必须是唯一的。构件是项目产生的或使用的一个东西，Maven为项目产生的构件包括：JARs，源码，二进制发布和WARs等。-->  
20.     <artifactId>banseon-maven2</artifactId>  
21.     <!--项目产生的构件类型，例如jar、war、ear、pom。插件可以创建他们自己的构件类型，所以前面列的不是全部构件类型-->  
22.     <packaging>jar</packaging>  
23.     <!--项目当前版本，格式为:主版本.次版本.增量版本-限定版本号-->  
24.     <version>1.0-SNAPSHOT</version>  
25.     <!--项目的名称, Maven产生的文档用-->  
26.     <name>banseon-maven</name>  
27.     <!--项目主页的URL, Maven产生的文档用-->  
28.     <url>http://www.baidu.com/banseon</url>  
29.     <!--项目的详细描述, Maven 产生的文档用。  当这个元素能够用HTML格式描述时（例如，CDATA中的文本会被解析器忽略，就可以包含HTML标签）， 不鼓励使用纯文本描述。如果你需要修改产生的web站点的索引页面，你应该修改你自己的索引页文件，而不是调整这里的文档。-->  
30.     <description>A maven project to study maven.</description>  
31.     <!--描述了这个项目构建环境中的前提条件。-->  
32.  <prerequisites>  
33.   <!--构建该项目或使用该插件所需要的Maven的最低版本-->  
34.     <maven/>  
35.  </prerequisites>  
36.  <!--项目的问题管理系统(Bugzilla, Jira, Scarab,或任何你喜欢的问题管理系统)的名称和URL，本例为 jira-->  
37.     <issueManagement>  
38.      <!--问题管理系统（例如jira）的名字，-->  
39.         <system>jira</system>  
40.         <!--该项目使用的问题管理系统的URL-->  
41.         <url>http://jira.baidu.com/banseon</url>  
42.     </issueManagement>  
43.     <!--项目持续集成信息-->  
44.  <ciManagement>  
45.   <!--持续集成系统的名字，例如continuum-->  
46.   <system/>  
47.   <!--该项目使用的持续集成系统的URL（如果持续集成系统有web接口的话）。-->  
48.   <url/>  
49.   <!--构建完成时，需要通知的开发者/用户的配置项。包括被通知者信息和通知条件（错误，失败，成功，警告）-->  
50.   <notifiers>  
51.    <!--配置一种方式，当构建中断时，以该方式通知用户/开发者-->  
52.    <notifier>  
53.     <!--传送通知的途径-->  
54.     <type/>  
55.     <!--发生错误时是否通知-->  
56.     <sendOnError/>  
57.     <!--构建失败时是否通知-->  
58.     <sendOnFailure/>  
59.     <!--构建成功时是否通知-->  
60.     <sendOnSuccess/>  
61.     <!--发生警告时是否通知-->  
62.     <sendOnWarning/>  
63.     <!--不赞成使用。通知发送到哪里-->  
64.     <address/>  
65.     <!--扩展配置项-->  
66.     <configuration/>  
67.    </notifier>  
68.   </notifiers>  
69.  </ciManagement>  
70.  <!--项目创建年份，4位数字。当产生版权信息时需要使用这个值。-->  
71.     <inceptionYear/>  
72.     <!--项目相关邮件列表信息-->  
73.     <mailingLists>  
74.      <!--该元素描述了项目相关的所有邮件列表。自动产生的网站引用这些信息。-->  
75.         <mailingList>  
76.          <!--邮件的名称-->  
77.             <name>Demo</name>  
78.             <!--发送邮件的地址或链接，如果是邮件地址，创建文档时，mailto: 链接会被自动创建-->  
79.             <post>[e-mail]</post>  
80.             <!--订阅邮件的地址或链接，如果是邮件地址，创建文档时，mailto: 链接会被自动创建-->  
81.             <subscribe>[e-mail]</subscribe>  
82.             <!--取消订阅邮件的地址或链接，如果是邮件地址，创建文档时，mailto: 链接会被自动创建-->  
83.             <unsubscribe>[e-mail]</unsubscribe>  
84.             <!--你可以浏览邮件信息的URL-->  
85.             <archive>http:/hi.baidu.com/banseon/demo/dev/</archive>  
86.         </mailingList>  
87.     </mailingLists>  
88.     <!--项目开发者列表-->  
89.     <developers>  
90.      <!--某个项目开发者的信息-->  
91.         <developer>  
92.          <!--SCM里项目开发者的唯一标识符-->  
93.             <id>HELLO WORLD</id>  
94.             <!--项目开发者的全名-->  
95.             <name>banseon</name>  
96.             <!--项目开发者的email-->  
97.             <email>[e-mail]</email>  
98.             <!--项目开发者的主页的URL-->  
99.             <url/>  
100.             <!--项目开发者在项目中扮演的角色，角色元素描述了各种角色-->  
101.             <roles>  
102.                 <role>Project Manager</role>  
103.                 <role>Architect</role>  
104.             </roles>  
105.             <!--项目开发者所属组织-->  
106.             <organization>demo</organization>  
107.             <!--项目开发者所属组织的URL-->  
108.             <organizationUrl>http://hi.baidu.com/banseon</organizationUrl>  
109.             <!--项目开发者属性，如即时消息如何处理等-->  
110.             <properties>  
111.                 <dept>No</dept>  
112.             </properties>  
113.             <!--项目开发者所在时区， -11到12范围内的整数。-->  
114.             <timezone>-5</timezone>  
115.         </developer>  
116.     </developers>  
117.     <!--项目的其他贡献者列表-->  
118.     <contributors>  
119.      <!--项目的其他贡献者。参见developers/developer元素-->  
120.      <contributor>  
121.    <name/><email/><url/><organization/><organizationUrl/><roles/><timezone/><properties/>  
122.      </contributor>  
123.     </contributors>  
124.     <!--该元素描述了项目所有License列表。 应该只列出该项目的license列表，不要列出依赖项目的 license列表。如果列出多个license，用户可以选择它们中的一个而不是接受所有license。-->  
125.     <licenses>  
126.      <!--描述了项目的license，用于生成项目的web站点的license页面，其他一些报表和validation也会用到该元素。-->  
127.         <license>  
128.          <!--license用于法律上的名称-->  
129.             <name>Apache 2</name>  
130.             <!--官方的license正文页面的URL-->  
131.             <url>http://www.baidu.com/banseon/LICENSE-2.0.txt</url>  
132.             <!--项目分发的主要方式：  
133.               repo，可以从Maven库下载  
134.               manual， 用户必须手动下载和安装依赖-->  
135.             <distribution>repo</distribution>  
136.             <!--关于license的补充信息-->  
137.             <comments>A business-friendly OSS license</comments>  
138.         </license>  
139.     </licenses>  
140.     <!--SCM(Source Control Management)标签允许你配置你的代码库，供Maven web站点和其它插件使用。-->  
141.     <scm>  
142.         <!--SCM的URL,该URL描述了版本库和如何连接到版本库。欲知详情，请看SCMs提供的URL格式和列表。该连接只读。-->  
143.         <connection>  
144.             scm:svn:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk)  
145.         </connection>  
146.         <!--给开发者使用的，类似connection元素。即该连接不仅仅只读-->  
147.         <developerConnection>  
148.             scm:svn:http://svn.baidu.com/banseon/maven/banseon/dao-trunk  
149.         </developerConnection>  
150.         <!--当前代码的标签，在开发阶段默认为HEAD-->  
151.         <tag/>  
152.         <!--指向项目的可浏览SCM库（例如ViewVC或者Fisheye）的URL。-->  
153.         <url>http://svn.baidu.com/banseon</url>  
154.     </scm>  
155.     <!--描述项目所属组织的各种属性。Maven产生的文档用-->  
156.     <organization>  
157.      <!--组织的全名-->  
158.         <name>demo</name>  
159.         <!--组织主页的URL-->  
160.         <url>http://www.baidu.com/banseon</url>  
161.     </organization>  
162.     <!--构建项目需要的信息-->  
163.     <build>  
164.      <!--该元素设置了项目源码目录，当构建项目的时候，构建系统会编译目录里的源码。该路径是相对于pom.xml的相对路径。-->  
165.   <sourceDirectory/>  
166.   <!--该元素设置了项目脚本源码目录，该目录和源码目录不同：绝大多数情况下，该目录下的内容 会被拷贝到输出目录(因为脚本是被解释的，而不是被编译的)。-->  
167.   <scriptSourceDirectory/>  
168.   <!--该元素设置了项目单元测试使用的源码目录，当测试项目的时候，构建系统会编译目录里的源码。该路径是相对于pom.xml的相对路径。-->  
169.   <testSourceDirectory/>  
170.   <!--被编译过的应用程序class文件存放的目录。-->  
171.   <outputDirectory/>  
172.   <!--被编译过的测试class文件存放的目录。-->  
173.   <testOutputDirectory/>  
174.   <!--使用来自该项目的一系列构建扩展-->  
175.   <extensions>  
176.    <!--描述使用到的构建扩展。-->  
177.    <extension>  
178.     <!--构建扩展的groupId-->  
179.     <groupId/>  
180.     <!--构建扩展的artifactId-->  
181.     <artifactId/>  
182.     <!--构建扩展的版本-->  
183.     <version/>  
184.    </extension>  
185.   </extensions>  
186.   <!--当项目没有规定目标（Maven2 叫做阶段）时的默认值-->  
187.   <defaultGoal/>  
188.   <!--这个元素描述了项目相关的所有资源路径列表，例如和项目相关的属性文件，这些资源被包含在最终的打包文件里。-->  
189.   <resources>  
190.    <!--这个元素描述了项目相关或测试相关的所有资源路径-->  
191.    <resource>  
192.     <!--描述了资源的目标路径。该路径相对target/classes目录（例如${project.build.outputDirectory}）。举个例子，如果你想资源在特定的包里(org.apache.maven.messages)，你就必须该元素设置为org/apache/maven/messages。然而，如果你只是想把资源放到源码目录结构里，就不需要该配置。-->  
193.     <targetPath/>  
194.     <!--是否使用参数值代替参数名。参数值取自properties元素或者文件里配置的属性，文件在filters元素里列出。-->  
195.     <filtering/>  
196.     <!--描述存放资源的目录，该路径相对POM路径-->  
197.     <directory/>  
198.     <!--包含的模式列表，例如**/*.xml.-->  
199.     <includes/>  
200.     <!--排除的模式列表，例如**/*.xml-->  
201.     <excludes/>  
202.    </resource>  
203.   </resources>  
204.   <!--这个元素描述了单元测试相关的所有资源路径，例如和单元测试相关的属性文件。-->  
205.   <testResources>  
206.    <!--这个元素描述了测试相关的所有资源路径，参见build/resources/resource元素的说明-->  
207.    <testResource>  
208.     <targetPath/><filtering/><directory/><includes/><excludes/>  
209.    </testResource>  
210.   </testResources>  
211.   <!--构建产生的所有文件存放的目录-->  
212.   <directory/>  
213.   <!--产生的构件的文件名，默认值是${artifactId}-${version}。-->  
214.   <finalName/>  
215.   <!--当filtering开关打开时，使用到的过滤器属性文件列表-->  
216.   <filters/>  
217.   <!--子项目可以引用的默认插件信息。该插件配置项直到被引用时才会被解析或绑定到生命周期。给定插件的任何本地配置都会覆盖这里的配置-->  
218.   <pluginManagement>  
219.    <!--使用的插件列表 。-->  
220.    <plugins>  
221.     <!--plugin元素包含描述插件所需要的信息。-->  
222.     <plugin>  
223.      <!--插件在仓库里的group ID-->  
224.      <groupId/>  
225.      <!--插件在仓库里的artifact ID-->  
226.      <artifactId/>  
227.      <!--被使用的插件的版本（或版本范围）-->  
228.      <version/>  
229.      <!--是否从该插件下载Maven扩展（例如打包和类型处理器），由于性能原因，只有在真需要下载时，该元素才被设置成enabled。-->  
230.      <extensions/>  
231.      <!--在构建生命周期中执行一组目标的配置。每个目标可能有不同的配置。-->  
232.      <executions>  
233.       <!--execution元素包含了插件执行需要的信息-->  
234.       <execution>  
235.        <!--执行目标的标识符，用于标识构建过程中的目标，或者匹配继承过程中需要合并的执行目标-->  
236.        <id/>  
237.        <!--绑定了目标的构建生命周期阶段，如果省略，目标会被绑定到源数据里配置的默认阶段-->  
238.        <phase/>  
239.        <!--配置的执行目标-->  
240.        <goals/>  
241.        <!--配置是否被传播到子POM-->  
242.        <inherited/>  
243.        <!--作为DOM对象的配置-->  
244.        <configuration/>  
245.       </execution>  
246.      </executions>  
247.      <!--项目引入插件所需要的额外依赖-->  
248.      <dependencies>  
249.       <!--参见dependencies/dependency元素-->  
250.       <dependency>  
251.        ......  
252.       </dependency>  
253.      </dependencies>  
254.      <!--任何配置是否被传播到子项目-->  
255.      <inherited/>  
256.      <!--作为DOM对象的配置-->  
257.      <configuration/>  
258.     </plugin>  
259.    </plugins>  
260.   </pluginManagement>  
261.   <!--使用的插件列表-->  
262.   <plugins>  
263.    <!--参见build/pluginManagement/plugins/plugin元素-->  
264.    <plugin>  
265.     <groupId/><artifactId/><version/><extensions/>  
266.     <executions>  
267.      <execution>  
268.       <id/><phase/><goals/><inherited/><configuration/>  
269.      </execution>  
270.     </executions>  
271.     <dependencies>  
272.      <!--参见dependencies/dependency元素-->  
273.      <dependency>  
274.       ......  
275.      </dependency>  
276.     </dependencies>  
277.     <goals/><inherited/><configuration/>  
278.    </plugin>  
279.   </plugins>  
280.  </build>  
281.  <!--在列的项目构建profile，如果被激活，会修改构建处理-->  
282.  <profiles>  
283.   <!--根据环境参数或命令行参数激活某个构建处理-->  
284.   <profile>  
285.    <!--构建配置的唯一标识符。即用于命令行激活，也用于在继承时合并具有相同标识符的profile。-->  
286.    <id/>  
287.    <!--自动触发profile的条件逻辑。Activation是profile的开启钥匙。profile的力量来自于它  
288.    能够在某些特定的环境中自动使用某些特定的值；这些环境通过activation元素指定。activation元素并不是激活profile的唯一方式。-->  
289.    <activation>  
290.     <!--profile默认是否激活的标志-->  
291.     <activeByDefault/>  
292.     <!--当匹配的jdk被检测到，profile被激活。例如，1.4激活JDK1.4，1.4.0_2，而!1.4激活所有版本不是以1.4开头的JDK。-->  
293.     <jdk/>  
294.     <!--当匹配的操作系统属性被检测到，profile被激活。os元素可以定义一些操作系统相关的属性。-->  
295.     <os>  
296.      <!--激活profile的操作系统的名字-->  
297.      <name>Windows XP</name>  
298.      <!--激活profile的操作系统所属家族(如 'windows')-->  
299.      <family>Windows</family>  
300.      <!--激活profile的操作系统体系结构 -->  
301.      <arch>x86</arch>  
302.      <!--激活profile的操作系统版本-->  
303.      <version>5.1.2600</version>  
304.     </os>  
305.     <!--如果Maven检测到某一个属性（其值可以在POM中通过${名称}引用），其拥有对应的名称和值，Profile就会被激活。如果值  
306.     字段是空的，那么存在属性名称字段就会激活profile，否则按区分大小写方式匹配属性值字段-->  
307.     <property>  
308.      <!--激活profile的属性的名称-->  
309.      <name>mavenVersion</name>  
310.      <!--激活profile的属性的值-->  
311.      <value>2.0.3</value>  
312.     </property>  
313.     <!--提供一个文件名，通过检测该文件的存在或不存在来激活profile。missing检查文件是否存在，如果不存在则激活  
314.     profile。另一方面，exists则会检查文件是否存在，如果存在则激活profile。-->  
315.     <file>  
316.      <!--如果指定的文件存在，则激活profile。-->  
317.      <exists>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</exists>  
318.      <!--如果指定的文件不存在，则激活profile。-->  
319.      <missing>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</missing>  
320.     </file>  
321.    </activation>  
322.    <!--构建项目所需要的信息。参见build元素-->  
323.    <build>  
324.      ...  
325.    </build>  
326.    <!--模块（有时称作子项目） 被构建成项目的一部分。列出的每个模块元素是指向该模块的目录的相对路径-->  
327.    <modules>  
328.    <modules/>  
329.    <!--发现依赖和扩展的远程仓库列表。-->  
330.    <repositories>  
331.     <!--参见repositories/repository元素-->  
332.     <repository>  
333.      <releases>  
334.       <enabled/><updatePolicy/><checksumPolicy/>  
335.      </releases>  
336.      <snapshots>  
337.       <enabled/><updatePolicy/><checksumPolicy/>  
338.      </snapshots>  
339.      <id/><name/><url/><layout/>  
340.     </repository>  
341.    </repositories>  
342.    <!--发现插件的远程仓库列表，这些插件用于构建和报表-->  
343.    <pluginRepositories>  
344.     <!--包含需要连接到远程插件仓库的信息.参见repositories/repository元素-->  
345.     <pluginRepository>  
346.      <releases>  
347.       <enabled/><updatePolicy/><checksumPolicy/>  
348.      </releases>  
349.      <snapshots>  
350.       <enabled/><updatePolicy/><checksumPolicy/>  
351.      </snapshots>  
352.      <id/><name/><url/><layout/>  
353.     </pluginRepository>  
354.    </pluginRepositories>  
355.    <!--该元素描述了项目相关的所有依赖。 这些依赖组成了项目构建过程中的一个个环节。它们自动从项目定义的仓库中下载。要获取更多信息，请看项目依赖机制。-->  
356.    <dependencies>  
357.     <!--参见dependencies/dependency元素-->  
358.     <dependency>  
359.      ......  
360.     </dependency>  
361.    </dependencies>  
362.    <!--不赞成使用. 现在Maven忽略该元素.-->  
363.    <reports/>  
364.    <!--该元素包括使用报表插件产生报表的规范。当用户执行“mvn site”，这些报表就会运行。 在页面导航栏能看到所有报表的链接。参见reporting元素-->  
365.    <reporting>  
366.     ......  
367.    </reporting>  
368.    <!--参见dependencyManagement元素-->  
369.    <dependencyManagement>  
370.     <dependencies>  
371.      <!--参见dependencies/dependency元素-->  
372.      <dependency>  
373.       ......  
374.      </dependency>  
375.     </dependencies>  
376.    </dependencyManagement>  
377.    <!--参见distributionManagement元素-->  
378.    <distributionManagement>  
379.     ......  
380.    </distributionManagement>  
381.    <!--参见properties元素-->  
382.    <properties/>  
383.   </profile>  
384.  </profiles>  
385.  <!--模块（有时称作子项目） 被构建成项目的一部分。列出的每个模块元素是指向该模块的目录的相对路径-->  
386.  <modules/>  
387.     <!--发现依赖和扩展的远程仓库列表。-->  
388.     <repositories>  
389.      <!--包含需要连接到远程仓库的信息-->  
390.         <repository>  
391.          <!--如何处理远程仓库里发布版本的下载-->  
392.          <releases>  
393.           <!--true或者false表示该仓库是否为下载某种类型构件（发布版，快照版）开启。 -->  
394.     <enabled/>  
395.     <!--该元素指定更新发生的频率。Maven会比较本地POM和远程POM的时间戳。这里的选项是：always（一直），daily（默认，每日），interval：X（这里X是以分钟为单位的时间间隔），或者never（从不）。-->  
396.     <updatePolicy/>  
397.     <!--当Maven验证构件校验文件失败时该怎么做：ignore（忽略），fail（失败），或者warn（警告）。-->  
398.     <checksumPolicy/>  
399.    </releases>  
400.    <!--如何处理远程仓库里快照版本的下载。有了releases和snapshots这两组配置，POM就可以在每个单独的仓库中，为每种类型的构件采取不同的策略。例如，可能有人会决定只为开发目的开启对快照版本下载的支持。参见repositories/repository/releases元素-->  
401.    <snapshots>  
402.     <enabled/><updatePolicy/><checksumPolicy/>  
403.    </snapshots>  
404.    <!--远程仓库唯一标识符。可以用来匹配在settings.xml文件里配置的远程仓库-->  
405.    <id>banseon-repository-proxy</id>  
406.    <!--远程仓库名称-->  
407.             <name>banseon-repository-proxy</name>  
408.             <!--远程仓库URL，按protocol://hostname/path形式-->  
409.             <url>http://192.168.1.169:9999/repository/</url>  
410.             <!--用于定位和排序构件的仓库布局类型-可以是default（默认）或者legacy（遗留）。Maven 2为其仓库提供了一个默认的布局；然而，Maven 1.x有一种不同的布局。我们可以使用该元素指定布局是default（默认）还是legacy（遗留）。-->  
411.             <layout>default</layout>  
412.         </repository>  
413.     </repositories>  
414.     <!--发现插件的远程仓库列表，这些插件用于构建和报表-->  
415.     <pluginRepositories>  
416.      <!--包含需要连接到远程插件仓库的信息.参见repositories/repository元素-->  
417.   <pluginRepository>  
418.    ......  
419.   </pluginRepository>  
420.  </pluginRepositories>  
421.   
422.     <!--该元素描述了项目相关的所有依赖。 这些依赖组成了项目构建过程中的一个个环节。它们自动从项目定义的仓库中下载。要获取更多信息，请看项目依赖机制。-->  
423.     <dependencies>  
424.         <dependency>  
425.    <!--依赖的group ID-->  
426.             <groupId>org.apache.maven</groupId>  
427.             <!--依赖的artifact ID-->  
428.             <artifactId>maven-artifact</artifactId>  
429.             <!--依赖的版本号。 在Maven 2里, 也可以配置成版本号的范围。-->  
430.             <version>3.8.1</version>  
431.             <!--依赖类型，默认类型是jar。它通常表示依赖的文件的扩展名，但也有例外。一个类型可以被映射成另外一个扩展名或分类器。类型经常和使用的打包方式对应，尽管这也有例外。一些类型的例子：jar，war，ejb-client和test-jar。如果设置extensions为 true，就可以在plugin里定义新的类型。所以前面的类型的例子不完整。-->  
432.             <type>jar</type>  
433.             <!--依赖的分类器。分类器可以区分属于同一个POM，但不同构建方式的构件。分类器名被附加到文件名的版本号后面。例如，如果你想要构建两个单独的构件成JAR，一个使用Java 1.4编译器，另一个使用Java 6编译器，你就可以使用分类器来生成两个单独的JAR构件。-->  
434.             <classifier></classifier>  
435.             <!--依赖范围。在项目发布过程中，帮助决定哪些构件被包括进来。欲知详情请参考依赖机制。  
436.                 - compile ：默认范围，用于编译  
437.                 - provided：类似于编译，但支持你期待jdk或者容器提供，类似于classpath  
438.                 - runtime: 在执行时需要使用  
439.                 - test:    用于test任务时使用  
440.                 - system: 需要外在提供相应的元素。通过systemPath来取得  
441.                 - systemPath: 仅用于范围为system。提供相应的路径  
442.                 - optional:   当项目自身被依赖时，标注依赖是否传递。用于连续依赖时使用-->  
443.             <scope>test</scope>  
444.             <!--仅供system范围使用。注意，不鼓励使用这个元素，并且在新的版本中该元素可能被覆盖掉。该元素为依赖规定了文件系统上的路径。需要绝对路径而不是相对路径。推荐使用属性匹配绝对路径，例如${java.home}。-->  
445.             <systemPath></systemPath>  
446.             <!--当计算传递依赖时， 从依赖构件列表里，列出被排除的依赖构件集。即告诉maven你只依赖指定的项目，不依赖项目的依赖。此元素主要用于解决版本冲突问题-->  
447.             <exclusions>  
448.              <exclusion>  
449.                     <artifactId>spring-core</artifactId>  
450.                     <groupId>org.springframework</groupId>  
451.                 </exclusion>  
452.             </exclusions>  
453.             <!--可选依赖，如果你在项目B中把C依赖声明为可选，你就需要在依赖于B的项目（例如项目A）中显式的引用对C的依赖。可选依赖阻断依赖的传递性。-->  
454.             <optional>true</optional>  
455.         </dependency>  
456.     </dependencies>  
457.     <!--不赞成使用. 现在Maven忽略该元素.-->  
458.     <reports></reports>  
459.     <!--该元素描述使用报表插件产生报表的规范。当用户执行“mvn site”，这些报表就会运行。 在页面导航栏能看到所有报表的链接。-->  
460.  <reporting>  
461.   <!--true，则，网站不包括默认的报表。这包括“项目信息”菜单中的报表。-->  
462.   <excludeDefaults/>  
463.   <!--所有产生的报表存放到哪里。默认值是${project.build.directory}/site。-->  
464.   <outputDirectory/>  
465.   <!--使用的报表插件和他们的配置。-->  
466.   <plugins>  
467.    <!--plugin元素包含描述报表插件需要的信息-->  
468.    <plugin>  
469.     <!--报表插件在仓库里的group ID-->  
470.     <groupId/>  
471.     <!--报表插件在仓库里的artifact ID-->  
472.     <artifactId/>  
473.     <!--被使用的报表插件的版本（或版本范围）-->  
474.     <version/>  
475.     <!--任何配置是否被传播到子项目-->  
476.     <inherited/>  
477.     <!--报表插件的配置-->  
478.     <configuration/>  
479.     <!--一组报表的多重规范，每个规范可能有不同的配置。一个规范（报表集）对应一个执行目标 。例如，有1，2，3，4，5，6，7，8，9个报表。1，2，5构成A报表集，对应一个执行目标。2，5，8构成B报表集，对应另一个执行目标-->  
480.     <reportSets>  
481.      <!--表示报表的一个集合，以及产生该集合的配置-->  
482.      <reportSet>  
483.       <!--报表集合的唯一标识符，POM继承时用到-->  
484.       <id/>  
485.       <!--产生报表集合时，被使用的报表的配置-->  
486.       <configuration/>  
487.       <!--配置是否被继承到子POMs-->  
488.       <inherited/>  
489.       <!--这个集合里使用到哪些报表-->  
490.       <reports/>  
491.      </reportSet>  
492.     </reportSets>  
493.    </plugin>  
494.   </plugins>  
495.  </reporting>  
496.  <!--继承自该项目的所有子项目的默认依赖信息。这部分的依赖信息不会被立即解析,而是当子项目声明一个依赖（必须描述group ID和artifact ID信息），如果group ID和artifact ID以外的一些信息没有描述，则通过group ID和artifact ID匹配到这里的依赖，并使用这里的依赖信息。-->  
497.  <dependencyManagement>  
498.   <dependencies>  
499.    <!--参见dependencies/dependency元素-->  
500.    <dependency>  
501.     ......  
502.    </dependency>  
503.   </dependencies>  
504.  </dependencyManagement>  
505.     <!--项目分发信息，在执行mvn deploy后表示要发布的位置。有了这些信息就可以把网站部署到远程服务器或者把构件部署到远程仓库。-->  
506.     <distributionManagement>  
507.         <!--部署项目产生的构件到远程仓库需要的信息-->  
508.         <repository>  
509.          <!--是分配给快照一个唯一的版本号（由时间戳和构建流水号）？还是每次都使用相同的版本号？参见repositories/repository元素-->  
510.    <uniqueVersion/>  
511.    <id>banseon-maven2</id>  
512.    <name>banseon maven2</name>  
513.             <url>file://${basedir}/target/deploy</url>  
514.             <layout/>  
515.   </repository>  
516.   <!--构件的快照部署到哪里？如果没有配置该元素，默认部署到repository元素配置的仓库，参见distributionManagement/repository元素-->  
517.   <snapshotRepository>  
518.    <uniqueVersion/>  
519.    <id>banseon-maven2</id>  
520.             <name>Banseon-maven2 Snapshot Repository</name>  
521.             <url>scp://svn.baidu.com/banseon:/usr/local/maven-snapshot</url>  
522.    <layout/>  
523.   </snapshotRepository>  
524.   <!--部署项目的网站需要的信息-->  
525.         <site>  
526.          <!--部署位置的唯一标识符，用来匹配站点和settings.xml文件里的配置-->  
527.             <id>banseon-site</id>  
528.             <!--部署位置的名称-->  
529.             <name>business api website</name>  
530.             <!--部署位置的URL，按protocol://hostname/path形式-->  
531.             <url>  
532.                 scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web  
533.             </url>  
534.         </site>  
535.   <!--项目下载页面的URL。如果没有该元素，用户应该参考主页。使用该元素的原因是：帮助定位那些不在仓库里的构件（由于license限制）。-->  
536.   <downloadUrl/>  
537.   <!--如果构件有了新的group ID和artifact ID（构件移到了新的位置），这里列出构件的重定位信息。-->  
538.   <relocation>  
539.    <!--构件新的group ID-->  
540.    <groupId/>  
541.    <!--构件新的artifact ID-->  
542.    <artifactId/>  
543.    <!--构件新的版本号-->  
544.    <version/>  
545.    <!--显示给用户的，关于移动的额外信息，例如原因。-->  
546.    <message/>  
547.   </relocation>  
548.   <!--给出该构件在远程仓库的状态。不得在本地项目中设置该元素，因为这是工具自动更新的。有效的值有：none（默认），converted（仓库管理员从Maven 1 POM转换过来），partner（直接从伙伴Maven 2仓库同步过来），deployed（从Maven 2实例部署），verified（被核实时正确的和最终的）。-->  
549.   <status/>  
550.     </distributionManagement>  
551.     <!--以值替代名称，Properties可以在整个POM中使用，也可以作为触发条件（见settings.xml配置文件里activation元素的说明）。格式是<name>value</name>。-->  
552.     <properties/>  
553. </project>  

http://maven.apache.org/pom.html

http://blog.csdn.net/longeremmy/article/details/9670619