Maven的pom.xml文件详解------The Basics

转载自  Maven的pom.xml文件详解------The Basics

Maven坐标

GroupId、artifactId和version构成了Maven的坐标（groupId和version可以从parent继承），指定了组件在Maven仓库中的位置。Maven中的每个组件都有一个坐标，通过这个坐标我们在自己的项目中可以设置对该组件的依赖。
 ------groupId：项目属于哪个组，往往和项目所在的组织或公司存在关联；
 ------artifactId：当前Maven项目在组中唯一的ID；
 ------version：定义当前项目的版本，如：1.0（-SNAPSHOT），SNAPSHOT表示快照，说明该项目还处于开发阶段，是不稳定版本；
 ------packaging：当我们有了groupId:artifactId:version作为地址后，还需要packaging为我们提供组件的类型，例如：<packaging>war</packaging>标识组件为一个war。如果packaging不指定，默认值为jar，当前可选值为：pom, jar, maven-plugin, ejb, war, ear, rar, par；
 ------classifier：可选，坐标也可以展示为groupId:artifactId:packaging:classifier:version。

POM关联

Maven的一个有力的地方就在于对项目关联的处理；包括依赖、继承和聚合（多模块项目）。

Dependencies

<dependencies>
	<dependency>
		<groupId>junit</groupId>
		<artifactId>junit</artifactId>
		<version>4.0</version>
		<type>jar</type>
		<scope>test</scope>
		<optional>true</optional>
	</dependency>
	...
</dependencies>

------groupId、artifactId、version：依赖组件的坐标，如果当Maven通过这些坐标无法从中心仓库获取该组件时，可以通过下面的方法处理：
  1、用安装插件安装本地依赖，在命令行中输入：
  mvn install:install-file -Dfile=non-maven-proj.jar -DgroupId=some.group -DartifactId=non-maven-proj -Dversion=1 -Dpackaging=jar
  2、创建你自己的仓库，并部署它
  3、设置依赖scope到system，并定义一个systemPath，但这个不推荐。
------type：对应所以来的组件的packaging；
------scop：用于控制依赖的范围，有以下几种范围供选择
  1、compile：编译依赖范围，默认，对于所有的classpath都是有效的；
  2、provided：仅对编译和测试classpath有效；
  3、runtime：编译时不需要，尽在运行时需要；
  4、test：仅用于测试；
  5、system：和provided类似，只是你需要提供JAR，组件不再在仓库中查找。
------systemPath：当scop配置为system时就需要它了

	<dependency>
		<groupId>junit</groupId>
		<artifactId>junit</artifactId>
		<version>4.0</version>
		<type>jar</type>
		<scope>system</scope>
		<systemPath>$(object.path)/lib/junit.jar</systemPath>
		<optional>true</optional>
	</dependency>

------optional：设置为true，标识该依赖只对该项目有效，如果其他项目依赖该项目，该依赖将不会传递。

Exclusions

该配置告诉Maven你不想包含的该依赖的依赖（即，依赖传递的依赖）。

<dependencies>
	<dependency>
		<groupId>org.apache.maven</groupId>
		<artifactId>maven-embedder</artifactId>
		<version>2.0</version>
		<exclusions>
			<exclusion>
				<groupId>org.apache.maven</groupId>
				<artifactId>maven-core</artifactId>
			</exclusion>
		</exclusions>
	</dependency>
	...
</dependencies>

也可以使用通配符，表示排除所有传递的依赖。

<dependencies>
	<dependency>
		<groupId>org.apache.maven</groupId>
		<artifactId>maven-embedder</artifactId>
		<version>2.0</version>
		<exclusions>
			<exclusion>
				<groupId>*</groupId>
				<artifactId>*</artifactId>
			</exclusion>
		</exclusions>
	</dependency>
	...
</dependencies>

Inheritance

继承是一个有力的工具，在maven中使用继承时，需要为parent和aggregation（多模块）项目设置packaging为pom：<packaging>pom</packaging>，然后就子项目就可以继承该POM了。

<parent>
	<groupId>org.codehaus.mojo</groupId>
	<artifactId>my-parent</artifactId>
	<version>2.0</version>
	<relativePath>../my-parent</relativePath>
</parent>

relativePath是可选的，指定parent的搜索路径，如果配置了，Maven将首先搜索relativePath，然后本地仓库，最后远程仓库查找parentPOM。
POM就像Java对象最终都继承自java.lang.Object一样，所有的POM都继承自一个Super POM，你通过查ungjianyige最小化的pom.xml并在命令行中执行 mvn help:effective-pom来查看Super POM对你的POM的影响，下面是Maven 3.0.4的Super POM，该Super POM的位置在apache-maven-version\lib\maven-model-builder-version.jar\org\apache\maven\model\下面，文件名pom-4.0.0.xml。

<project>
	<modelVersion>4.0.0</modelVersion>

	<repositories>
		<repository>
			<id>central</id>
			<name>Central Repository</name>
			<url>http://repo.maven.apache.org/maven2</url>
			<layout>default</layout>
			<snapshots>
				<enabled>false</enabled>
			</snapshots>
		</repository>
	</repositories>

	<pluginRepositories>
		<pluginRepository>
			<id>central</id>
			<name>Central Repository</name>
			<url>http://repo.maven.apache.org/maven2</url>
			<layout>default</layout>
			<snapshots>
				<enabled>false</enabled>
			</snapshots>
			<releases>
				<updatePolicy>never</updatePolicy>
			</releases>
		</pluginRepository>
	</pluginRepositories>

	<build>
		<directory>${project.basedir}/target</directory>
		<outputDirectory>${project.build.directory}/classes</outputDirectory>
		<finalName>${project.artifactId}-${project.version}</finalName>
		<testOutputDirectory>${project.build.directory}/test-classes</testOutputDirectory>
		<sourceDirectory>${project.basedir}/src/main/java</sourceDirectory>
		<scriptSourceDirectory>src/main/scripts</scriptSourceDirectory>
		<testSourceDirectory>${project.basedir}/src/test/java</testSourceDirectory>
		<resources>
			<resource>
				<directory>${project.basedir}/src/main/resources</directory>
			</resource>
		</resources>
		<testResources>
			<testResource>
				<directory>${project.basedir}/src/test/resources</directory>
			</testResource>
		</testResources>
		<pluginManagement>
			<!-- NOTE: These plugins will be removed from future versions of the super POM -->
			<!-- They are kept for the moment as they are very unlikely to conflict with lifecycle mappings (MNG-4453) -->
			<plugins>
				<plugin>
					<artifactId>maven-antrun-plugin</artifactId>
					<version>1.3</version>
				</plugin>
				<plugin>
					<artifactId>maven-assembly-plugin</artifactId>
					<version>2.2-beta-5</version>
				</plugin>
				<plugin>
					<artifactId>maven-dependency-plugin</artifactId>
					<version>2.1</version>
				</plugin>
				<plugin>
					<artifactId>maven-release-plugin</artifactId>
					<version>2.0</version>
				</plugin>
			</plugins>
		</pluginManagement>
	</build>

	<reporting>
		<outputDirectory>${project.build.directory}/site</outputDirectory>
	</reporting>

	<profiles>
		<!-- NOTE: The release profile will be removed from future versions of the super POM -->
		<profile>
			<id>release-profile</id>

			<activation>
				<property>
					<name>performRelease</name>
					<value>true</value>
				</property>
			</activation>

			<build>
				<plugins>
					<plugin>
						<inherited>true</inherited>
						<artifactId>maven-source-plugin</artifactId>
						<executions>
							<execution>
								<id>attach-sources</id>
								<goals>
									<goal>jar</goal>
								</goals>
							</execution>
						</executions>
					</plugin>
					<plugin>
						<inherited>true</inherited>
						<artifactId>maven-javadoc-plugin</artifactId>
						<executions>
							<execution>
								<id>attach-javadocs</id>
								<goals>
									<goal>jar</goal>
								</goals>
							</execution>
						</executions>
					</plugin>
					<plugin>
						<inherited>true</inherited>
						<artifactId>maven-deploy-plugin</artifactId>
						<configuration>
							<updateReleaseInfo>true</updateReleaseInfo>
						</configuration>
					</plugin>
				</plugins>
			</build>
		</profile>
	</profiles>

</project>

Dependency Management

dependencyManagement用于在parent项目定义一个依赖，如：

<dependencyManagement>
	<dependencies >
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>4.0</version>
			<type>jar</type>
			<scope>compile</scope>
			<optional>true</optional>
		</dependency>
	</dependencies >
</dependencyManagement>

然后从这个parent继承的POMs就能设置他们的依赖为：

<dependencies >
	<dependency >
		<groupId>junit</groupId>
		<artifactId>junit</artifactId>
	</dependency >
</dependencies >

继承的POM的dependency的其它信息可以从parent的dependencyManagement中获得，这样的好处在于可以将依赖的细节放在一个控制中心，子项目就不用在关心依赖的细节，只需要设置依赖。

Aggregation（或者Multi-Module）

在多模块的项目中，可以将一个模块的集合配置到modules中。

<modules>
	<module>my-project</module>
	<module>another-project</module>
</modules>

在这里列出的模块不需要考虑顺序，Maven将自己根据依赖关系排序。

Properties

Maven中的Properties就像Ant中的，可以在POM的任何地方通过${X}来返回属性的值，X就表Poperty。 存在以下5种不同的类型： 1、env.X：将返回环境变量的值，如：${env.PATH}返回PATH环境变量的值； 2、project.X：POM中的对应元素的值，'.'表示在POM中的路径，如：<project><version>1.0</version></project>可以通过${project.version}获取值； 3、settings.X：settings.xml中包含的对应元素的值，'.'表示路径，如： <settings><offline>false</offline></settings>可以通过${settings.offline}获取； 4、Java System Properties：所有可以通过java.lang.System.getProperties()获取到的属性在POM属性中都是可用的，如：${java.home}； 5、X：在POM的<properties />中设置的元素，如： <properties><someVar>value</someVar></properies>通过${someVar}获取。