我们先看一个简单的例子:



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 <!-- maven model version -->
4 <modelVersion>4.0.0</modelVersion>
5 <!-- project group id & artifact id -->
6 <groupId>com.freesoft.mvn-webapp</groupId>
7 <artifactId>mvnwebapp</artifactId>
8 <!-- packing type -->
9 <packaging>war</packaging>
10 <!-- version -->
11 <version>1.0-SNAPSHOT</version>
12 <name>mvnwebapp Maven Webapp</name>
13 <url>http://maven.apache.org</url>
14
15
16 <dependencies>
17
18 <!-- JUnit -->
19 <dependency>
20 <groupId>junit</groupId>
21 <artifactId>junit</artifactId>
22 <version>4.11</version>
23 <scope>test</scope>
24 </dependency>
25
26 </dependencies>
27
28
29 <build>
30 <finalName>mvnwebapp</finalName>
31 <pluginManagement>
32 <plugins>
33 <plugin>
34 <groupId>org.apache.tomcat.maven</groupId>
35 <artifactId>tomcat7-maven-plugin</artifactId>
36 <version>2.1</version>
37 <configuration>
38 <tomcat-url>http://localhost:8080/manager/html</tomcat-url>
39 <server>tomcat_localtest</server>
40 </configuration>
41 </plugin>
42 </plugins>
43 </pluginManagement>
44 </build>
45
46 <properties>
47 <struts.version>2.3.15</struts.version>
48 <mysql.version>5.1.29</mysql.version>
49 <hibernate.version>4.3.1.Final</hibernate.version>
50 </properties>
51 </project>


 

下面分段讲解。


1. 基本信息

 

modelVersion

Maven模块版本,目前我们一般都取值4.0.0

groupId

整个系统的名称。

artifactId

子模块名称。

packaging

打包类型,可取值:jar,war等等,这个配置用于package的phase,具体可以参见package运行的时候启动的plugin,后面有机会我们会讲述如何配置打包的插件。

 

2. dependencies

依赖关系。实际上pom之间存在好三种关系:继承、依赖、聚合。我们先讲依赖,这也是最重要的关系。

 

groupId

依赖项的groupId

artifactId

依赖项的artifactId

version

依赖项的版本

scope

依赖项的适用范围:

  • compile,缺省值,适用于所有阶段,会随着项目一起发布。
  • provided,类似compile,期望JDK、容器或使用者会提供这个依赖。如servlet.jar。
  • runtime,只在运行时使用,如JDBC驱动,适用运行和测试阶段。
  • test,只在测试时使用,用于编译和运行测试代码。不会随项目发布。
  • system,类似provided,需要显式提供包含依赖的jar,Maven不会在Repository中查找它。

之前例子里的junit就只用在了test中。

exclusions

排除项目中的依赖冲突时使用。

 

2.1 关于排除依赖冲突

我们可能经常会遇到这样一个问题:我们的项目有两个依赖项:A & B,而且A和B同时依赖了C,但不是同一个版本。那么我们怎么办呢?


2.1.1 添加检查插件



1 <reporting>
2 <plugins>
3 <plugin>
4 <groupId>org.apache.maven.plugins</groupId>
5 <artifactId>maven-project-info-reports-plugin</artifactId>
6 </plugin>
7 </plugins>
8 </reporting>


然后运行:mvn project-info-reports:dependencies,来查看依赖项报告。


2.1.2 去除依赖项

如果我们需要在某个dependency中去除某个依赖项,直接这样即可:



1 <!-- Struts2 -->
2 <dependency>
3 <groupId>org.apache.struts</groupId>
4 <artifactId>struts2-core</artifactId>
5 <version>${struts.version}</version>
6 <exclusions>
7 <exclusion>
8 <groupId>org.freemarker</groupId>
9 <artifactId>freemarker</artifactId>
10 </exclusion>
11 </exclusions>
12 </dependency>


3. 继承

我的repository下面有个例子就直接拿来用了:



1 <modelVersion>4.0.0</modelVersion>
2 <parent>
3 <groupId>com.thoughtworks.xstream</groupId>
4 <artifactId>xstream-parent</artifactId>
5 <version>1.4.3</version>
6 </parent>
7 <artifactId>xstream</artifactId>
8 <packaging>jar</packaging>
9 <name>XStream Core</name>


其中的parent表示父pom是com.thoughtworks.xstream的xstream-parent的1.4.3版本。继承关系比较简单,这里不做过多介绍。


4. 聚合

我们可以通过一个大的项目来整合各个小的模块:



1 <modules>
2 <module>my-app</module>
3 </modules>


5. 属性

属性表述类似于EL表达式,ANT中也同样有,所以我们的properties字段可以这样使用:



1         <!-- mysql -->
2 <dependency>
3 <groupId>mysql</groupId>
4 <artifactId>mysql-connector-java</artifactId>
5 <version>${mysql.version}</version>
6 </dependency>


6. 构建

6.1 plugin

Plugin的配置如下:



1 <pluginManagement>
2 <plugins>
3 <plugin>
4 <groupId>org.apache.tomcat.maven</groupId>
5 <artifactId>tomcat7-maven-plugin</artifactId>
6 <version>2.1</version>
7 <configuration>
8 <tomcat-url>http://localhost:8080/manager/html</tomcat-url>
9 <server>tomcat_localtest</server>
10 </configuration>
11 </plugin>
12 </plugins>
13 </pluginManagement>


我们可以看到同样要哟偶groupId、artifactId、version还有一些配置参数。


6.2 resource

指定你在Build时需要的资源文件:



1 <resources>
2 <resource>
3 <targetPath>WEB-INF/resource</targetPath>
4 <!-- 不对文件中的表达式进行处理 -->
5 <filtering>false</filtering>
6 <directory>${basedir}/src/test/resources</directory>
7 <includes>
8 <include>include.xml</include>
9 </includes>
10 <excludes>
11 <exclude>exclude.xml</exclude>
12 </excludes>
13 </resource>
14 </resources>