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

梦里梦外; 2023-07-12 09:24 7阅读 0赞

转载自  [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>
    			
    			
    			<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>
    		
    		<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\}获取。

[Maven_pom.xml_------The Basics]: http://blog.csdn.net/tomato__/article/details/13169437