maven参数详解

setting.xml主要用于配置maven的运行环境等一系列通用的属性，是全局级别的配置文件；而pom.xml主要描述了项目的maven坐标，依赖关系，开发者需要遵循的规则，缺陷管理系统，组织和licenses，以及其他所有的项目相关因素，是项目级别的配置文件。

基础配置

一个典型的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.0http://maven.apache.org/xsd/maven-4.0.0.xsd">

    <!-- 模型版本。maven2.0必须是这样写，现在是maven2唯一支持的版本 -->

    <modelVersion>4.0.</modelVersion>

    <!-- 公司或者组织的唯一标志，并且配置时生成的路径也是由此生成， 如com.winner.trade，maven会将该项目打成的jar包放本地路径：/com/winner/trade -->

    <groupId>com.winner.trade</groupId>

    <!-- 本项目的唯一ID，一个groupId下面可能多个项目，就是靠artifactId来区分的 -->

    <artifactId>trade-core</artifactId>

    <!-- 本项目目前所处的版本号 -->

    <version>1.0.-SNAPSHOT</version>

    <!-- 打包的机制，如pom,jar, maven-plugin, ejb, war, ear, rar, par，默认为jar -->

    <packaging>jar</packaging>

    <!-- 帮助定义构件输出的一些附属构件,附属构件与主构件对应，有时候需要加上classifier才能唯一的确定该构件 不能直接定义项目的classifer,因为附属构件不是项目直接默认生成的，而是由附加的插件帮助生成的 -->

    <classifier>...</classifier>

    <!-- 定义本项目的依赖关系 -->

    <dependencies>

        <!-- 每个dependency都对应这一个jar包 -->

        <dependency>

            <!--一般情况下，maven是通过groupId、artifactId、version这三个元素值（俗称坐标）来检索该构件， 然后引入你的工程。如果别人想引用你现在开发的这个项目（前提是已开发完毕并发布到了远程仓库），-->

            <!--就需要在他的pom文件中新建一个dependency节点，将本项目的groupId、artifactId、version写入， maven就会把你上传的jar包下载到他的本地 -->

            <groupId>com.winner.trade</groupId>

            <artifactId>trade-test</artifactId>

            <version>1.0.-SNAPSHOT</version>

            <!-- maven认为，程序对外部的依赖会随着程序的所处阶段和应用场景而变化，所以maven中的依赖关系有作用域(scope)的限制。 -->

            <!--scope包含如下的取值：compile（编译范围）、provided（已提供范围）、runtime（运行时范围）、test（测试范围）、system（系统范围） -->

            <scope>test</scope>

            <!-- 设置指依赖是否可选，默认为false,即子项目默认都继承:为true,则子项目必需显示的引入，与dependencyManagement里定义的依赖类似  -->

            <optional>false</optional>

            <!-- 屏蔽依赖关系。 比如项目中使用的libA依赖某个库的1.0版，libB依赖某个库的2.0版，现在想统一使用2.0版，就应该屏蔽掉对1.0版的依赖 -->

            <exclusions>

                <exclusion>

                    <groupId>org.slf4j</groupId>

                    <artifactId>slf4j-api</artifactId>

                </exclusion>

            </exclusions>

        </dependency>

    </dependencies>

    <!-- 为pom定义一些常量，在pom中的其它地方可以直接引用 使用方式 如下 ：${file.encoding} -->

    <properties>

        <file.encoding>UTF-</file.encoding>

        <java.source.version>1.5</java.source.version>

        <java.target.version>1.5</java.target.version>

    </properties>

    ...

</project>

构建配置

<build>

	<!-- 产生的构件的文件名，默认值是${artifactId}-${version}。 -->

	<finalName>myPorjectName</finalName>

	<!-- 构建产生的所有文件存放的目录,默认为${basedir}/target，即项目根目录下的target -->

	<directory>${basedir}/target</directory>

	<!--当项目没有规定目标（Maven2叫做阶段（phase））时的默认值， -->

	<!--必须跟命令行上的参数相同例如jar:jar，或者与某个阶段（phase）相同例如install、compile等 -->

	<defaultGoal>install</defaultGoal>

	<!--当filtering开关打开时，使用到的过滤器属性文件列表。 -->

	<!--项目配置信息中诸如${spring.version}之类的占位符会被属性文件中的实际值替换掉 -->

	<filters>

		<filter>../filter.properties</filter>

	</filters>

	<!--项目相关的所有资源路径列表，例如和项目相关的配置文件、属性文件，这些资源被包含在最终的打包文件里。 -->

	<resources>

		<resource>

			<!--描述了资源的目标路径。该路径相对target/classes目录（例如${project.build.outputDirectory}）。 -->

			<!--举个例子，如果你想资源在特定的包里(org.apache.maven.messages)，你就必须该元素设置为org/apache/maven/messages。 -->

			<!--然而，如果你只是想把资源放到源码目录结构里，就不需要该配置。 -->

			<targetPath>resources</targetPath>

			<!--是否使用参数值代替参数名。参数值取自properties元素或者文件里配置的属性，文件在filters元素里列出。 -->

			<filtering>true</filtering>

			<!--描述存放资源的目录，该路径相对POM路径 -->

			<directory>src/main/resources</directory>

			<!--包含的模式列表 -->

			<includes>

				<include>**/*.properties</include>

				<include>**/*.xml</include>

			</includes>

			<!--排除的模式列表 如果<include>与<exclude>划定的范围存在冲突，以<exclude>为准 -->

			<excludes>

				<exclude>jdbc.properties</exclude>

			</excludes>

		</resource>

	</resources>

	<!--单元测试相关的所有资源路径，配制方法与resources类似 -->

	<testResources>

		<testResource>

			<targetPath />

			<filtering />

			<directory />

			<includes />

			<excludes />

		</testResource>

	</testResources>

	<!--项目源码目录，当构建项目的时候，构建系统会编译目录里的源码。该路径是相对于pom.xml的相对路径。 -->

	<sourceDirectory>${basedir}\src\main\java</sourceDirectory>

	<!--项目脚本源码目录，该目录和源码目录不同， <!-- 绝大多数情况下，该目录下的内容会被拷贝到输出目录(因为脚本是被解释的，而不是被编译的)。 -->

	<scriptSourceDirectory>${basedir}\src\main\scripts

	</scriptSourceDirectory>

	<!--项目单元测试使用的源码目录，当测试项目的时候，构建系统会编译目录里的源码。该路径是相对于pom.xml的相对路径。 -->

	<testSourceDirectory>${basedir}\src\test\java</testSourceDirectory>

	<!--被编译过的应用程序class文件存放的目录。 -->

	<outputDirectory>${basedir}\target\classes</outputDirectory>

	<!--被编译过的测试class文件存放的目录。 -->

	<testOutputDirectory>${basedir}\target\test-classes

	</testOutputDirectory>

	<!--项目的一系列构建扩展,它们是一系列build过程中要使用的产品，会包含在running bulid‘s classpath里面。 -->

	<!--他们可以开启extensions，也可以通过提供条件来激活plugins。 -->

	<!--简单来讲，extensions是在build过程被激活的产品 -->

	<extensions>

		<!--例如，通常情况下，程序开发完成后部署到线上Linux服务器，可能需要经历打包、 -->

		<!--将包文件传到服务器、SSH连上服务器、敲命令启动程序等一系列繁琐的步骤。 -->

		<!--实际上这些步骤都可以通过Maven的一个插件 wagon-maven-plugin 来自动完成 -->

		<!--下面的扩展插件wagon-ssh用于通过SSH的方式连接远程服务器， -->

		<!--类似的还有支持ftp方式的wagon-ftp插件 -->

		<extension>

			<groupId>org.apache.maven.wagon</groupId>

			<artifactId>wagon-ssh</artifactId>

			<version>2.8</version>

		</extension>

	</extensions>

	<!--使用的插件列表 。 -->

	<plugins>

		<plugin>

			<groupId></groupId>

			<artifactId>maven-assembly-plugin</artifactId>

			<version>2.5.5</version>

			<!--在构建生命周期中执行一组目标的配置。每个目标可能有不同的配置。 -->

			<executions>

				<execution>

					<!--执行目标的标识符，用于标识构建过程中的目标，或者匹配继承过程中需要合并的执行目标 -->

					<id>assembly</id>

					<!--绑定了目标的构建生命周期阶段，如果省略，目标会被绑定到源数据里配置的默认阶段 -->

					<phase>package</phase>

					<!--配置的执行目标 -->

					<goals>

						<goal>single</goal>

					</goals>

					<!--配置是否被传播到子POM -->

					<inherited>false</inherited>

				</execution>

			</executions>

			<!--作为DOM对象的配置,配置项因插件而异 -->

			<configuration>

				<finalName>${finalName}</finalName>

				<appendAssemblyId>false</appendAssemblyId>

				<descriptor>assembly.xml</descriptor>

			</configuration>

			<!--是否从该插件下载Maven扩展（例如打包和类型处理器）， -->

			<!--由于性能原因，只有在真需要下载时，该元素才被设置成true。 -->

			<extensions>false</extensions>

			<!--项目引入插件所需要的额外依赖 -->

			<dependencies>

				<dependency>...</dependency>

			</dependencies>

			<!--任何配置是否被传播到子项目 -->

			<inherited>true</inherited>

		</plugin>

	</plugins>

	<!--主要定义插件的共同元素、扩展元素集合，类似于dependencyManagement， -->

	<!--所有继承于此项目的子项目都能使用。该插件配置项直到被引用时才会被解析或绑定到生命周期。 -->

	<!--给定插件的任何本地配置都会覆盖这里的配置 -->

	<pluginManagement>

		<plugins>...</plugins>

	</pluginManagement>

</build>

profile配置

<!--在列的项目构建profile，如果被激活，会修改构建处理 -->

<profiles>

	<!--根据环境参数或命令行参数激活某个构建处理 -->

	<profile>

		<!--自动触发profile的条件逻辑。Activation是profile的开启钥匙。 -->

		<activation>

			<!--profile默认是否激活的标识 -->

			<activeByDefault>false</activeByDefault>

			<!--activation有一个内建的java版本检测，如果检测到jdk版本与期待的一样，profile被激活。 -->

			<jdk>1.7</jdk>

			<!--当匹配的操作系统属性被检测到，profile被激活。os元素可以定义一些操作系统相关的属性。 -->

			<os>

				<!--激活profile的操作系统的名字 -->

				<name>Windows XP</name>

				<!--激活profile的操作系统所属家族(如 'windows') -->

				<family>Windows</family>

				<!--激活profile的操作系统体系结构 -->

				<arch>x86</arch>

				<!--激活profile的操作系统版本 -->

				<version>5.1.2600</version>

			</os>

			<!--如果Maven检测到某一个属性（其值可以在POM中通过${名称}引用），其拥有对应的名称和值，Profile就会被激活。 -->

			<!-- 如果值字段是空的，那么存在属性名称字段就会激活profile，否则按区分大小写方式匹配属性值字段 -->

			<property>

				<!--激活profile的属性的名称 -->

				<name>mavenVersion</name>

				<!--激活profile的属性的值 -->

				<value>2.0.3</value>

			</property>

			<!--提供一个文件名，通过检测该文件的存在或不存在来激活profile。missing检查文件是否存在，如果不存在则激活profile。 -->

			<!--另一方面，exists则会检查文件是否存在，如果存在则激活profile。 -->

			<file>

				<!--如果指定的文件存在，则激活profile。 -->

				<exists>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</exists>

				<!--如果指定的文件不存在，则激活profile。 -->

				<missing>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</missing>

			</file>

		</activation>

		<id />

		<build />

		<modules />

		<repositories />

		<pluginRepositories />

		<dependencies />

		<reporting />

		<dependencyManagement />

		<distributionManagement />

		<properties />

	</profile>

　　profile配置项在setting.xml中也有，是pom.xml中profile元素的裁剪版本，包含了id，activation, repositories, pluginRepositories和 properties元素。这里的profile元素只包含这五个子元素是因为setting.xml只关心构建系统这个整体（这正是settings.xml文件的角色定位），而非单独的项目对象模型设置。如果一个settings中的profile被激活，它的值会覆盖任何其它定义在POM中或者profile.xml中的带有相同id的profile。

pom.xml中的profile可以看做pom.xml的副本，拥有与pom.xml相同的子元素与配置方法。它包含可选的activation（profile的触发器）和一系列的changes。例如test过程可能会指向不同的数据库（相对最终的deployment）或者不同的dependencies或者不同的repositories，并且是根据不同的JDK来改变的。只需要其中一个成立就可以激活profile，如果第一个条件满足了，那么后面就不会在进行匹配。

---------------------

作者：冰河winner

来源：CSDN

原文：https://blog.csdn.net/u012152619/article/details/51485297

<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.0http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.winner.trade</groupId> <artifactId>trade-core</artifactId> <version>1.0.0-SNAPSHOT</version> <packaging>jar</packaging> <classifier>...</classifier> <dependencies> <dependency>  <groupId>com.winner.trade</groupId><artifactId>trade-test</artifactId><version>1.0.0-SNAPSHOT</version> <scope>test</scope> <optional>false</optional> <exclusions><exclusion><groupId>org.slf4j</groupId><artifactId>slf4j-api</artifactId></exclusion></exclusions> </dependency> </dependencies> <properties><file.encoding>UTF-8</file.encoding><java.source.version>1.5</java.source.version><java.target.version>1.5</java.target.version></properties> ...</project>