【构建工具】《Maven实战》读书笔记

Maven是我们在做Java开发过程中用经常用到的一个辅助工具。本篇博客是我学习Maven的一个记录博客，学习过程主要参考《Maven实战》这本书。同时也参考了Maven的官方文档。

1. Maven简介

1.1 什么是Maven

Maven是一个开源的Java项目构建、依赖管理和项目信息管理工具。

1.2 何为构建

所谓构建是指项目编译、运行单元测试、生成项目文档、打包和项目部署等一系列操作。

1.3 Maven的优点

Maven是一个优秀的构建工具：帮我们规范了项目的构建过程，我们不在需要像以前那样自己编写不通用的项目构建脚本，大大降低自写脚本出错的效率，同时也规范了团队项目的标准化。只需执行一些简单的Maven命令就可以实现项目构建工作。另外，Maven还提供了很多现成插件来完成各种构建任务，不需要我们自己去写脚本。

Maven抽象了一个完整的项目构建的生命周期模型，这个模型吸取了其他构建工具的优点，总结了大量项目的实际需求。如果遵循这个模型，可以避免很多不必要的错误。Maven已经提供了大量成熟的Maven插件来完成它抽象的这套生命周期模型，如果我们的项目有特殊的构建需求，可以通过实现自己的构建插件来完成项目特殊的构建需求。

统一的依赖管理（中央仓库）。

Maven还可以管理如下信息：项目描述、开发者列表、版本控制系统地址、许可证和缺陷管理系统地址等。

1.3 同类技术对比

在Maven之前，Make和Ant也是两个比较流行的项目构建工具。但是使用这两个工具，针对每个项目我们必须自己编写项目构建脚本，而且这个两个工具都没有依赖管理的功能（Ant依赖于Lvy进行依赖管理），所以这两个工具逐渐成为过去式，Maven成为了Java世界中项目构建的标准。（Gradle也是一款不错的项目构建工具）

2. Maven安装配置

2.1 windows环境安装

    step1：安装JDK，配置JAVA_HOME,添加到path；

    step2：下载Maven安装包，解压到指定目录；

    step3：将Maven的安装目录添加到path；

    step3：使用mvn -v校验是否安装成功。

配置M2_HOME 和 MAVEN_HOME两个环境变量（指代Maven的安装目录，到bin那层目录）

通常需要设置MAVEN_OPTS的值为-Xms128m -Xmx512m，因为Java默认的最大可用内存往往不能够满足Maven运行的需要，比如在项目较大时，使用Maven生成项目站点需要占用大量的内存，如果没有该配置，则很容易得到java.lang.OutOfMemeoryError异常。因此，一开始就配置该环境变量是推荐的做法。

2.2 Linux环境安装

安装方式和上述类似

2.3 .m2目录

安装完Maven后，一般会在用户的主目录下有一个.m2目录。这个下面会有一个仓库目录，默认情况下，缓存下来的Jar包会存放在这个目录下。我们可以在这个目录下添加settings.xml文件配置仓库目录。注意这个settings文件只对当前用户生效。M2_HOME/config下的settings文件对所有用户生效。推荐使用用户范围的settings。

2.4 配置Http代理

有时候公司为了安全起见，内部网络不能直接访问外部互联网。但是提供了代理服务器进行外部网络访问，这是想要让Maven访问到外部的Maven中心仓库需要配置代理。

    <settings>

	    ...

	    <proxies>

	        <proxy>

	           <id>optional</id>

	           <active>true</active>

	           <protocol>http</protocol>

	           <host>10.47.22.247</host>

	           <port>80</port>

               <username>xx</username>

               <password>xx</pawwword>

	           <nonProxyHosts>some.host.com|*.google.com</nonProxyHosts>

	        </proxy>

	    </proxies>

	    ...

    </settings>

proxies下面可以配置多个代理，默认情况下第一个被激活的代理生效。如果代理服务器需要认证，那我们还需要提供用户名密码。标签用来指定访问哪个地址时不需要经过这个代理。

2.5 Maven安装最佳实践

2.5.1 配置MAVEN_OPTS

通常需要设置MAVEN_OPTS的值为-Xms128m -Xmx512m，因为Java默认的最大可用内存往往不能够满足Maven运行的需要，比如在项目较大时，使用Maven生成项目站点需要占用大量的内存，如果没有该配置，则很容易得到java.lang.OutOfMemeoryError异常。因此，一开始就配置该环境变量是推荐的做法。

2.5.2 配置用户范围的settings.xml

我们可以配置M2_HOME/conf/settings.xml，也可以配置~/.m2/settings.xml。前者会对所有用户生效，后者只会对当前用户生效。推荐配置用户范围内的setting，这样不会影响其他用户的配置，在升级Maven时也不需要重新配置。当然，如果你需要做全局配置，就需要配置做全局配置。

3. Maven坐标和依赖

3.1 Maven坐标

在Maven中，坐标可以理解为一个依赖的唯一标识。Maven的坐标元素包括groupId、artifactId、version、packaging、classfier。只要我们提供正确的坐标元素，Maven就能找到对应的构件，首先去你的本地仓库查找，没有的话再去远程仓库下载。如果没有配置远程仓库，会默认从中央仓库地址(http://repo1.maven.org/maven2)下载构件，该中央仓库包含了世界上大部分流行的开源项目构件，但不一定所有构件都有。下面介绍下坐标中每个标签的含义：

groupId:定义当前Maven项目的隶属的实际项目。比如xx公司xx团队的xx项目，xx项目下又包含几个模块项目。这时groupId我们就可以命名为com.xxCompany.xxTeam.xxProject，子项目的名字可以通过artifactId来指定；
artifactId：定义实际项目中的一个Maven模块（子项目）的名字。一般推荐用项目的名称作为前缀。比如我们整个大项目的名称是xxProject，这个子模块的名称是core。那artifactId可以设置为xxProject-core。
version：项目的版本
packaging：项目打包方式（jar、war、pom等）默认的是jar。
classifier：用来定义javadoc和源代码source等构件，这个元素不能直接定义。

邮件测试时我们可以考虑使用GreenMail这个类库

3.2 dependeny标签的内容

dependeny标签下面可以有下面的标签：

groupId、artifactId和version这几个标签来定位具体的依赖；
type这个标签对用maven坐标中的packaging属性，一般不需要指定，默认是jar；
scope：见3.3节详解；
optional：值是true或false，可选依赖不会被传递；
exclusions：排除传递依赖。

3.3 scope属性详解

Maven环境下有三种classpath，分别是编译classpath、测试classpa和运行classpath。scope属性和这三种classpath有关。scope的值可以是下面几种：

compile：如果将一个依赖的scope属相设置为compile（默认就是compile），那么这个依赖对于三种classpath都有效；
test：编译测试classpath有效，这种Jar包不会被打包进最终的项目；
provide：对于编译和测试有效，运行时无效。说明在项目运行时这个依赖会被提供，就不需要我们打进项目了。典型的就是Servlet-api（这个依赖在运行时会由web容器提供）
runtime：典型的应用就是JDBC的驱动实现（就是这个依赖的Jar只在项目运行是才会用到）
system：依赖的Jar包在本地（不建议使用这个属性）

<dependency>

    <groupId>org.xx.xx</groupId>

    <artifactId>xx-web</artifactId>

    <scope>system</scope>

    <systemPath>{java.home}/lib/xx.jar</systemPath>

</dependency>

import：该属性只会在dependenceManagement属性中生效。用来导入类型为pom的依赖，典型的应用看Springboot。

Scope	编译classpath	测试classpath	运行时classpath	列子
compile	Y	Y	Y	Spring-core
test	-	Y	-	junit
provide	Y	Y	-	servlet-api
runtime	-	Y	Y	jdbc驱动实现
system	Y	Y	-

3.4 传递依赖

Maven的依赖是具有传递性的，比如A->B,B->C,那么A间接的依赖于C，这就是依赖的传递性，其中A对于B是第一直接依赖，B对于C是第二直接依赖，C为A的传递性依赖。这里还有一个依赖scope的问题。如果A->B的scope是compile，B->C的scope也是compile，那么A->C的scope也是compile。

表格：传递依赖

	compile	test	provided	runtime
compile	compile	-	-	runtime
test	test	-	-	test
provided	provided	-	provided	provided
runtime	runtime	-	-	runtime

上表中最左边一列表示A->B的第一直接依赖，最上面一行表示B->C的第二直接依赖，表格中的内容表示A->C的依赖内容。举个列子，当A->B的直接依赖范围是test，B->C的第二直接依赖是compile，那么A->C的依赖范围是test。

3.5 依赖调解

下面我们来思考这样一个问题，如果A->B->C->X(1.0),A->D-X(2.0),即A间接依赖X，我们可以看到有两条路径都依赖X，那么maven将会选择哪个版本的X？maven当中有一套自己的规则，我们来说明一下，maven传递性依赖的一些规则以及如何排除依赖冲突。

Maven里面对于传递性依赖有以下几个规则：

最短路径原则：如果A对于依赖路径中有两个相同的jar包，那么选择路径短的那个包，路径最近者优先，上述会选X(2.0)。
第一声明优先原则：如果A对于依赖路径中有两个相同的jar包，路径长度也相同，那么依赖写在前面的优先。例如：A->B->F(1.0),A->C->F(2.0)，会选F(1.0)。
可选依赖不会被传递，如A->B,B->C,B->D,A对B直接依赖，B对C和D是可选依赖，那么在A中不会引入C和D。可选依赖通过optional元素配置，true表示可选。如果要在A项目中使用C或者D则需要显式地声明C或者D依赖。

3.6 依赖排除

<dependency>

     <groupId>org.springframework</groupId>

     <artifactId>spring-core</artifactId>

     <version>3.2.8</version>

     <exclusions>

           <exclusion>

                <groupId>commons-logging</groupId>

                <artifactId>commons-logging</artifactId>

           </exclusion>

      </exclusions>

</dependency

4. Maven仓库

Maven的仓库分为本地仓库和远程仓库。Maven在寻找依赖的时候会先从本地仓库寻找，本地没有的话会从远程仓库去下载到本地然后再使用。

4.1 仓库的分类

4.1.1 本地仓库

本地仓库需要我们在settings.xml配置文件中配置。注意，默认情况下.m2目录下是没有这文件的，需要我们自己配置。所有的依赖都会被缓存到本地仓库，本地没有的话回去远程仓库拿。

<localRepository>D:\software\maven\Repository</localRepository>

4.1.2 远程仓库

远程仓库有好几种分类：Maven的中央仓库、Nexus搭建的私有服务器（如果Nexus上没有相应的依赖，Nexus会自动从外部的仓库下载）和JBoss、谷歌的中央仓库等。一般我们只配置一个远程仓库。如果中央仓库中没有相应的依赖，就会报错。下面是Maven配置的默认的远程仓库，这个仓库中包含了绝大多数的依赖构建，如果我们没做其他配置，Maven就会从这个仓库中下载依赖。

    <repositories>

    <repository>

      <id>central</id>

      <name>Central Repository</name>

      <url>https://repo.maven.apache.org/maven2</url>

      <layout>default</layout>

      <snapshots>

        <enabled>false</enabled>

      </snapshots>

    </repository>

    </repositories>

Maven还允许用户配置私有服务器。如果我们将远程仓库配置成我们自己搭建的私有服务器，那么Maven每次都会从私有服务器上去请求依赖，如果私服上不存在我们需要的依赖，私服会先从外部仓库下载依赖然后缓存到服务器上再提供给我们。另外私服也允许我们自己上传依赖。架设Maven私服有如下优点：

节省公司外网贷款；
因为依赖会被缓存到私服上，所以依赖的下载速度会很快；
方便上传团队内部的依赖，统一管理，共享。

4.2 远程仓库的配置

Maven已经默认为我们配置了一个远程仓库，在maven安装目录下的：/lib/maven-model-builder-${version}.jar中我们可以找到这个配置。

    <repositories>

     <repository>

	    <id>central</id>

	    <name>Central Repository</name>

	    <url>https://repo.maven.apache.org/maven2</url>

	    <layout>default</layout>

	    <snapshots>

	      <enabled>false</enabled>

	    </snapshots>

     </repository>

    </repositories>

这里我们只要知道，中央仓库的id为central，远程url地址为http://repo.maven.apache.org/maven2，它关闭了snapshot版本构件下载的支持。

当然我们也可以自己在pom中配置repository，有可能你依赖的一个jar在central中找不到，它只存在于某个特定的公共仓库，这样你也不得不添加那个远程仓库的配置。

    <project>

	...

	  <repositories>

	    <repository>

	      <id>maven-net-cn</id>

	      <name>Maven China Mirror</name>

	      <url>http://maven.net.cn/content/groups/public/</url>

	      <releases>

	        <enabled>true</enabled>

	      </releases>

	      <snapshots>

	        <enabled>false</enabled>

	      </snapshots>

	    </repository>

	  </repositories>

	  <pluginRepositories>

	    <pluginRepository>

	      <id>maven-net-cn</id>

	      <name>Maven China Mirror</name>

	      <url>http://maven.net.cn/content/groups/public/</url>

	      <releases>

	        <enabled>true</enabled>

	      </releases>

	      <snapshots>

	        <enabled>false</enabled>

	      </snapshots>

	    </pluginRepository>

	  </pluginRepositories>

	...

	</project>

我们先看一下的配置，你可以在它下面添加多个，每个都有它唯一的ID，一个描述性的name，以及最重要的，远程仓库的url。此外，true告诉Maven可以从这个仓库下载releases版本的构件，而false告诉Maven不要从这个仓库下载snapshot版本的构件。禁止从公共仓库下载snapshot构件是推荐的做法，因为这些构件不稳定，且不受你控制，你应该避免使用。当然，如果你想使用局域网内组织内部的仓库，你可以激活snapshot的支持。

这边整理下Maven查询仓库的顺序：

先查询本地仓库，如果本地仓库中没有，进入第二步；
查询Maven给central仓库配置镜像，如果配置了镜像就去镜像查，如果没有，就去中央仓库查；
查询Maven有没给你自己配置的仓库指定镜像，如果配置了镜像就去镜像查，否则就从你自己配置的仓库查。

4.2.1 远程仓库的认证

大部分公共的远程仓库无须认证就可以直接访问，但我们在平时的开发中往往会架设自己的Maven远程仓库，出于安全方面的考虑，我们需要提供认证信息才能访问这样的远程仓库。配置认证信息和配置远程仓库不同，远程仓库可以直接在pom.xml中配置，但是认证信息必须配置在settings.xml文件中。这是因为pom往往是被提交到代码仓库中供所有成员访问的，而settings.xml一般只存在于本机。因此，在settings.xml中配置认证信息更为安全。

    <servers>

	    <server>

	       <id>releases</id>

	       <username>pub_mvn_deploy</username>

	       <password>mvn.Deploy</password>

	     </server>

    </servers>

上面代码我们配置了一个id为releases的远程仓库认证信息。Maven使用settings.xml文件中的servers元素及其子元素server配置仓库认证信息。认证用户名为admin，认证密码为admin123。这里的关键是id元素，settings.xml中server元素的id必须与pom.xml中需要认证的repository元素的id完全一致。正是这个id将认证信息与仓库配置联系在了一起。

4.2.2 部署构建到远程仓库

     <distributionManagement>

	         <repository>

	             <id>releases</id>

	             <name>public</name>

	             <url>http://59.50.95.66:8081/nexus/content/repositories/releases</url>

	         </repository>

	         <snapshotRepository>

	             <id>snapshots</id>

	             <name>Snapshots</name>

	             <url>http://59.50.95.66:8081/nexus/content/repositories/snapshots</url>

	         </snapshotRepository>

	 </distributionManagement>

distributionManagement包含repository和snapshotRepository子元素，前者表示发布版本（稳定版本）构件的仓库，后者表示快照版本（开发测试版本）的仓库。这两个元素都需要配置id、name和url，id为远程仓库的唯一标识，name是为了方便人阅读，关键的url表示该仓库的地址。往远程仓库部署构件的时候，往往需要认证，配置认证的方式同上。

配置正确后，运行命令mvn clean deploy，Maven就会将项目构建输出的构件部署到配置对应的远程仓库，如果项目当前的版本是快照版本，则部署到快照版本的仓库地址，否则就部署到发布版本的仓库地址。

4.3 快照版本

在Maven世界中版本分为发布版本和快照版本。1.0.0、1.3-alpha-4和2.0这种版本是稳定的发布版本。2.1-SNAPSHOT或者2.1--20091214-13这种版本是快照版本。

如果我们依赖一个版本为快照的依赖，这种情况下我们我们每次build的时候都会从远程仓库拉取这个依赖的最新版本。（远程仓库会给这个依赖维护一个时间戳，所以Maven能知道最新的版本）

release（最新发布版本）、latest（最新版本）、snapshot这三种版本都是上面的策略。在我们平时使用时不建议使用release和latest版本，因为这些版本更新比较频繁，你的项目依赖了这些版本的Jar包，今天还能编译通过，明天可能就编译不过了。推荐使用稳定发布版本。

    <repository>

        <releases>

            <enabled></enabled>

        </releases>

        <snapshots>

            <enabled></enabled>

        </snapshots>

    </repository>

4.4 从仓库解析依赖的机制

。。。待完成

4.5 镜像

如果仓库X可以提供仓库Y存储的所有内容，那么就可以认为X是Y的一个镜像。关于镜像的一个更为常见的用法是结合私服。由于私服可以代理任何外部的公共仓库(包括中央仓库)，因此，对于组织内部的Maven用户来说，使用一个私服地址就等于使用了所有需要的外部仓库，这可以将配置集中到私服，从而简化Maven本身的配置。在这种情况下，任何需要的构件都可以从私服获得，私服就是所有仓库的镜像。这时，可以配置这样的一个镜像：

    <mirrors>

	    <mirror>

			<!--This sends everything else to /public -->

			<id>nexus</id>

			<mirrorOf>*</mirrorOf>

			<url>http://maven.dev.xxxx.com/nexus/content/groups/public</url>

	    </mirror>

    </mirrors>

mirrorOf标签可以有多种配置方式：

<！-- 匹配所有仓库 -->

<mirrorOf>*</mirrorOf>

<！-- 匹配仓库rep1和rep2 -->

<mirrorOf>rep1,rep2</mirrorOf>

<！-- 匹配rep1之外的所有 -->

<mirrorOf>*,！rep1</mirrorOf>

<！-- 匹配不在本机上的远程仓库 -->

<mirrorOf>external:*</mirrorOf>

5. Maven生命周期和插件

在Maven中，我们需要掌握的重要概念有坐标、依赖、仓库、生命周期、插件。这个章节我们讲解生命周期和插件的主题。

Maven通过对大量项目构建过程的总结，抽象出了一套高度完善的项目构建的生命周期。整个生命周期包含项目的清理、初始化、编译、测试、打包、集成测试、验证、部署、站点生成等几乎所有的过程。Maven的整个生命周期是抽象的，这意味着整个生命周期本身不会干任何事情。在Maven项目的整个构建过程中，实际的构建任务都是由Maven插件完成的。Maven本身内置了很多插件，所以我们在项目进行编译、测试、打包的过程是没有感觉到。比如编译就是通过maven-compile-plugin实现的、测试是通过maven-surefire-plugin实现的。

5.1 生命周期详解

Maven拥有3套独立的生命周期：clean周期、default周期和site生命周期。clean周期的主要作用是清理项目，default周期的作用是构建项目，site周期的作用是生成项目站点。每个生命周期都若干个阶段，比如使用mvn clean命令，就是调用了clean生命周期的clean阶段。

5.1.1 clean生命周期

Clean生命周期一共包含了三个阶段：

pre-clean：执行一些需要在clean之前完成的工作。
clean：移除所有上一次构建生成的文件。
post-clean：执行一些需要在clean之后立刻完成的工作。

mvn clean中的clean就是上面的clean，在一个生命周期中，运行某个阶段的时候，它之前的所有阶段都会被运行，也就是说，mvn clean等同于 mvn pre-clean clean，如果我们运行 mvn post-clean，那么 pre-clean、clean 都会被运行。这是Maven很重要的一个规则，可以大大简化命令行的输入。但是执行clean生命周期的某个阶段，不会触发其他生命周期的阶段，因为Maven的每个生命周期都是相互独立的。

5.1.2 site生命周期

下面看一下Site生命周期的各个阶段：

pre-site：执行一些需要在生成站点文档之前完成的工作。
site：生成项目的站点文档。
post-site：执行一些需要在生成站点文档之后完成的工作，并且为部署做准备。
site-deploy：将生成的站点文档部署到特定的服务器上。

这里经常用到的是site阶段和site-deploy阶段，用以生成和发布Maven站点，这可是Maven相当强大的功能，Manager比较喜欢，文档及统计数据自动生成，很好看。

5.1.3 default生命周期

最后，来看一下Maven的最重要的default生命周期，绝大部分工作都发生在这个生命周期中，这里我只解释一些比较重要和常用的阶段：

validate
initialize
generate-sources
process-sources：处理项目主资源文件，一般来说，是对src/main/resources目录的内容进行变量替换等工作后，复制到项目输出的主classpath目录中；
generate-resources
process-resources
compile 编译项目的源代码，一般来说，是编译src/main/java目录下的Java文件至项目输出的主classpath目录中。
process-classes
generate-test-sources
process-test-sources：处理项目测试资源文件，一般来说，是对src/test/resources目录的内容进行变量替换等工作后，复制到项目输出的测试classpath目录中。
generate-test-resources
process-test-resources
test-compile：编译项目的测试源代码，一般来说，是编译src/test/java目录下的Java文件至项目输出的测试classpath目录中。
process-test-classes
test：使用合适的单元测试框架运行测试。这些测试代码不会被打包或部署。
prepare-package
package：接受编译好的代码，打包成可发布的格式，如 JAR 。
pre-integration-test
integration-test
post-integration-test
verify
install：将包安装至本地仓库，以让其它项目依赖。
deploy：将最终的包复制到远程的仓库，以让其它开发人员与Maven项目使用。

基本上，根据名称我们就能猜出每个阶段的用途，关于阶段的详细解释以及其她阶段的解释，请参考 http://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html 。

5.1.4 命令行和生命周期

mvn clean install site-deploy

5.2 插件详解

这边先理解一个重要的概念：插件目标（goal）。每个插件的单个功能就可以理解为是一个插件的目标。举个例子，maven-dependency-plugin这个插件可以分析项目的依赖树、可以分析潜在无用的依赖，这一个个功能我们就可以理解为插件的goal。

5.2.1 默认插件绑定

Maven生命周期的某个阶段会和插件的某个goal绑定来完成某个特定的任务。Maven已经在生命周期的某个阶段默认绑定了一些goal，让用户可以直接使用。

表格:clean生命周期绑定的插件

生命周期阶段	插件目标
pre-clean	-
clean	maven-clean-plugin:clean
post-clean	-

表格:site生命周期绑定的插件目标

生命周期阶段	插件目标
pre-site	-
site	maven-site-plugin:site
post-site	-
site-deploy	maven-site-plugin:deploy

表格：default生命周期绑定的插件目标

生命周期阶段	插件目标	执行的任务
process-resources	maven-resources-plugin:resources	复制主资源文件到主输出目录
compile	maven-compiler-plugin:compile	编译主代码到主输出目录
process-test-resources	maven-resources-plugin:testResources	-
test-compile	maven-compiler-plugin:testCompile	-
test	maven-surefire-plugin:test	执行测试用例
package	maven-jar-plugin：jar	项目打包（如果打成war包的话会绑定其他插件）
install	maven-install-plugin:install	安装到本地仓库
deploy	maven-deploy-plugin	项目部署

上表只是列出了拥有插件绑定关系的阶段，default生命周期还有很多其他阶段，默认他们没有绑定任何插件，因此这些阶段没有任何实际行为。

除了默认的打包类型jar之外，常见的打包类型还有war、pom、maven-plugin和ear等。

5.2.2 自定义插件绑定

除了内置的绑定之外，用户还能自己选择将某个插件的目标绑定到生命周期的某个阶段上。这种自定义的绑定方式能让Maven执行更多功能。下面是一个插件配置的列子：

    <build>

		<plugins>

			<plugin>

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

				<artifactId>maven-source-plugin</artifactId>

				<version>2.1.2</version>

				 <executions>

				  <execution>

				   <goals>

						<goal>jar-no-fork</goal>

				   </goals>

				   <phase>package</phase>

				  </execution>

				 </executions>

			</plugin>

		</plugins>

	</build>

在上面的列子中我们将>maven-source-plugin插件的jar-no-fork目标绑定到了default周期的package阶段。所以在执行到package阶段的时候jar-no-fork会被调用。有时候我们会发现我们没配置任何phase，插件的目标也能被调用。这是因为插件已经为目标默认绑定到生命周期的某个阶段上了。使用下面的命令可以查看某个目标绑定到了哪个阶段上

	mvn help:describe -Dplugin=org.apache.maven.plugins:maven-dependency-plugin -Ddetail

    mvn help:describe -Dplugin=dependency -Ddetail

插件仓库和依赖的仓库不是公用的，需要我们另外配置。

    <pluginRepositories>

        <pluginRepository>

          <id>central</id>

          <url>http://central</url>

          <releases><enabled>true</enabled></releases>

          <snapshots><enabled>true</enabled></snapshots>

        </pluginRepository>

    </pluginRepositories>

6. Maven聚合和继承

6.1 聚合

聚合最主要的表现形式是使用modle标签来管理多个子模块的构建：

    <modules>

        <module>spring-boot-quickstart</module>

        <module>spring-boot-web</module>

    </modules>

6.2 继承

如果多个模块出现相同的依赖包，这样在pom.xml文件的内容出现了冗余、重复的内容，解决这个问题其实使用Maven的继承机制即可，就像Java的继承一样，父类就像一个模板，子类继承自父类，那么有些通用的方法、变量都不必在子类中再重复声明了。Maven的继承机制类似，在一个父级别的Maven的pom文件中定义了相关的常量、依赖、插件等等配置后，实际项目模块可以继承此父项目的pom文件，重复的项不必显示的再声明一遍了，相当于父Maven项目就是个模板，等着其他子模块去继承。不过父Maven项目要高度抽象，高度提取公共的部分（交集），做到一处声明，多处使用。

可继承的POM元素：

groupId和version是可以被继承的，那么还有哪些POM元素可以被继承呢？以下是一个完整的列表，并附带了简单的说明：

groupId：项目组 ID，项目坐标的核心元素；
version：项目版本，项目坐标的核心元素；
description：项目的描述信息；
organization：项目的组织信息；
inceptionYear：项目的创始年份；
url：项目的 url 地址；
develoers：项目的开发者信息；
contributors：项目的贡献者信息；
distributionManagerment：项目的部署信息；
issueManagement：缺陷跟踪系统信息；
ciManagement：项目的持续继承信息；
scm：项目的版本控制信息；
mailingListserv：项目的邮件列表信息；
properties：自定义的 Maven 属性；
dependencies：项目的依赖配置；
dependencyManagement：醒目的依赖管理配置；
repositories：项目的仓库配置；
build：包括项目的源码目录配置、输出目录配置、插件配置、插件管理配置等；
reporting：包括项目的报告输出目录配置、报告插件配置等。

聚合 VS 继承

虽然聚合通常伴随着父POM的继承关系，但是这两者不是必须同时存在的，从上面两者的介绍可以看出来，这两者的都有不同的作用，他们的作用不依赖于另一个的配置。

父POM是为了抽取统一的配置信息和依赖版本控制，方便子POM直接引用，简化子POM的配置。聚合（多模块）则是为了方便一组项目进行统一的操作而作为一个大的整体，所以要真正根据这两者不同的作用来使用，不必为了聚合而继承同一个父POM，也不比为了继承父POM而设计成多模块。

6.3 插件管理

和依赖管理（dependencyManagement）的理念相同，我们可以在父pom中配置插件管理。这样子模块就可以继承父模块的插件。

    <build>

        <pluginManagement>

            <plugins>

            </plugins>

        </pluginManagement>

    </build>

7. Nexus创建私服

私服是一种特殊的Maven远程仓库。Nexus分为免费版和专业版。安装包分为附带web容器的Bundle版本，和不带web容器的war包版本。

7.1 Nexus仓库类型

仓库有四种类型：

group（仓库组）：没有实际的内容，就是将若干个其他仓库组合成一个组，在这种类型的仓库中下载依赖的时候，Maven会从这个组中包含的仓库依次轮询，知道下载到依赖为止；
hosted（宿主）：建在Nexus一台机器上的本地Maven仓库；
proxy（代理）：是一个代理，代理了其他远程仓库，比如Maven的central仓库；
virtual（虚拟）：兼容Maven1 版本的jar或者插件。

每个仓库的格式为maven2或者maven1。此外，仓库还有一个属性为Policy（策略），表示该仓库为发布（Release）版本仓库还是快照（Snapshot）版本仓库。最后两列的值为仓库的状态和路径。

Maven Central：该仓库代理Maven中央仓库，其策略为Release，因此只会下载和缓存中央仓库中的发布版本构件。
Releases：这是一个策略为Release的宿主类型仓库，用来部署组织内部的发布版本构件。
Snapshots：这是一个策略为Snapshot的宿主类型仓库，用来部署组织内部的快照版本构件。
3rd party：这是一个策略为Release的宿主类型仓库，用来部署无法从公共仓库获得的第三方发布版本构件。
Apache Snapshots：这是一个策略为Snapshot的代理仓库，用来代理Apache Maven仓库的快照版本构件。
Codehaus Snapshots：这是一个策略为Snapshot的代理仓库，用来代理Codehaus Maven仓库的快照版本构件。
Google Code：这是一个策略为Release的代理仓库，用来代理Google Code Maven仓库的发布版本构件。
java.net-Maven 2：这是一个策略为Release的代理仓库，用来代理java.net Maven仓库的发布版本构件。
Public Repositories：该仓库组将上述所有策略为Release的仓库聚合并通过一致的地址提供服务。
Public Snapshot Repositories：该仓库组将上述所有策略为Snapshot的仓库聚合并通过一致的地址提供服务。

7.2 配置Nexus仓库

在POM中配置仓库

	    <project>

		  <repositories>

		    <repository>

		      <id>maven-net-cn</id>

		      <name>Maven China Mirror</name>

		      <url>http://maven.net.cn/content/groups/public/</url>

		      <releases>

		        <enabled>true</enabled>

		      </releases>

		      <snapshots>

		        <enabled>false</enabled>

		      </snapshots>

		    </repository>

		  </repositories>

		  <pluginRepositories>

		    <pluginRepository>

		      <id>maven-net-cn</id>

		      <name>Maven China Mirror</name>

		      <url>http://maven.net.cn/content/groups/public/</url>

		      <releases>

		        <enabled>true</enabled>

		      </releases>

		      <snapshots>

		        <enabled>false</enabled>

		      </snapshots>

		    </pluginRepository>

		  </pluginRepositories>

		</project>

这种配置方式只会对当前项目生效，如果想对所有项目生效，可以在settings文件中配置。

在Settings.xml中配置

		<settings>

		  ...

		  <profiles>

		    <profile>

		      <id>Nexus</id>

		      <!-- repositories and pluginRepositories here-->

		    </profile>

		  </profiles>

		  <activeProfiles>

		    <activeProfile>Nexus</activeProfile>

		  </activeProfiles>

		  ...

		</settings>

使用镜像

如果你的地理位置附近有一个速度更快的central镜像，或者你想覆盖central仓库配置，或者你想为所有POM使用唯一的一个远程仓库（这个远程仓库代理的所有必要的其它仓库）

	    <settings>

		...

		  <mirrors>

		    <mirror>

		      <id>maven-net-cn</id>

		      <name>Maven China Mirror</name>

		      <url>http://maven.net.cn/content/groups/public/</url>

		      <mirrorOf>*</mirrorOf>

		    </mirror>

		  </mirrors>

		...

		</settings>

7.3 部署构建到Nexus

...

8. Maven测试

Maven的测试插件会自动执行src/test/java/下面的

**/Test*.java；
**/*Test.java;
**/*TestCase.java

以上形式的类。

8.1 跳过测试

mvn clean install -DskipTests

<properties>

    <skipTests>true</skipTests>

</properties>

8.2 指定运行某个测试用例

mvn test -Dtest=Random1Test，Random2Test

mvn test -Dtest=Random*Test

8.3 排除测试

    <build>

    <plugins>

      <plugin>

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

        <artifactId>maven-surefire-plugin</artifactId>

        <version>3.0.0-M3</version>

        <configuration>

          <includes>

           <include>**/*Tests.java</include>

          </includes>

          <excludes>

            <exclude>**/TestCircle.java</exclude>

            <exclude>**/TestSquare.java</exclude>

          </excludes>

        </configuration>

      </plugin>

    </plugins>

    </build>

9. 持续集成

Hudson+Maven+git版本控制-->持续集成

10. 构建Web项目

使用Cargo可以进行远程Web应用部署...

11. Maven版本管理

Maven的版本管理一般会遵循：

<主版本>.<次版本>.<增量版本>-<里程碑版本>

主版本号：表示项目架构有重大的变更;
次版本号：较大范围的功能增加和变化，以及Bug修复，但总体项目架构没什么变化；
增量版本：一般表示重大Bug修复，例如1.4.0发布后发现一个重大Bug，发现一个重大Bug修复后发布1.4.1；
里程碑版本：SNAPSHOT-->alpha-->beta-->release-->GA

SNAPSHOT：正在开发中的版本

Alpha: 内部测试的版本（项目组内部测试）

Beta：用户下载下来测试使用

Release: 用户使用下来没什么问题就可以发布Release版本

GA：稳定版本

11.1 GPG签名

使用GPG签名来校验依赖包有没被第三方恶意篡改

12. 灵活的构建

12.1 Maven属性

Maven中有6中基本属性：

内置属性

主要有两个常用内置属性——${basedir}表示项目根目录，即包含pom.xml文件的目录;${version}表示项目版本。
POM属性

pom中对应元素的值，例如${project.artifactId}对应了元素的值，常用的POM属性包括：

${project.build.sourceDirectory}:项目的主源码目录，默认为src/main/java/；
${project.build.testSourceDirectory}:项目的测试源码目录，默认为/src/test/java/；
${project.build.directory}:项目构建输出目录，默认为target/；
${project.build.outputDirectory}:项目主代码编译输出目录，默认为target/classes/；
${project.build.testOutputDirectory}:项目测试代码编译输出目录，默认为target/testclasses/；
${project.groupId}:项目的groupId；
${project.artifactId}:项目的artifactId；
${project.version}:项目的version,于${version}等价；
${project.build.finalName}:项目打包输出文件的名称，默认为${project.artifactId}${project.version}.

自定义属性

在pom中元素下自定义的Maven属性。
Settings属性

与POM属性同理。如${settings.localRepository}指向用户本地仓库的地址。
Java系统属性

所有Java系统属性都可以使用Maven属性引用，例如${user.home}指向了用户目录。可以通过命令行mvn help:system查看所有的Java系统属性
环境变量属性

所有环境变量都可以使用以env.开头的Maven属性引用。例如${env.JAVA_HOME}指代了JAVA_HOME环境变量的值。也可以通过命令行mvn help:system查看所有环境变量。

12.2 资源过滤

    <build>

		<resources>

			<resource>

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

				<filtering>true</filtering>

				<excludes>

					<exclude>**/config/*.*</exclude>

				</excludes>

			</resource>

			<resource>

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

				<filtering>true</filtering>

				<includes>

					<include>application-${profiles.active}.yml</include>

				</includes>

			</resource>

		</resources>

    </build>

12.3 Maven profile

12.3.1 针对不同环境profile

    <project>

        ...

	    <profiles>

	        <profile>

	            <id>dev</id>

	            <properties>

	                <profiles.active>dev</profiles.active>

	            </properties>

	            <activation>

                    <!-- **这边可以配置各种激活条件** -- >

	                <property>

	                    <name></name>

	                    <value></value>

	                </property>

	                <file>

	                    <exists></exists>

	                </file>

	                <os>

	                    ...

	                </os>

	                <jdk>

	                    ...

	                </jdk>

	                <activeByDefault>true</activeByDefault>

                </activation>

	        </profile>

	        <profile>

	            <id>stg</id>

	            <properties>

	                <profiles.active>stg</profiles.active>

	            </properties>

	        </profile>

	        <profile>

	            <id>prod</id>

	            <properties>

	                <profiles.active>prod</profiles.active>

	            </properties>

	        </profile>

        </profiles>

        ...

    </project>

12.3.2 激活profile

命令行激活

mvn clean install -Pdev
settings文件显示激活

如果你希望某个profile一直处于激活状态，可以直接在settings文件中配置:

      <profiles>

	    <profile>

	      <id>nexus</id>

	      <repositories>

	          <repository>

	          <id>central</id>

	          <url>http://central</url>

	          <releases><enabled>true</enabled></releases>

	          <snapshots><enabled>true</enabled></snapshots>

	         </repository>

	      </repositories>

	      <pluginRepositories>

	        <pluginRepository>

	          <id>central</id>

	          <url>http://central</url>

	          <releases><enabled>true</enabled></releases>

	          <snapshots><enabled>true</enabled></snapshots>

	        </pluginRepository>

	      </pluginRepositories>

	    </profile>

	  </profiles>

	  <activeProfiles>

	    <!--make the profile active all the time -->

	    <activeProfile>nexus</activeProfile>

	  </activeProfiles

12.3.3 Web项目打包

...

13. 项目站点生成

...后续完成...

14. 编写Mavem插件

...后续完成...

附录

A. 常用命令

下面我们总结下Maven中常用的命令。

mvn help:system 调用help这个插件，打印出jvm的系统属性和操作系统的环境变量
mvn help:describe -Dplugin=org.apache.maven.plugins:maven-dependency-plugin -Ddetail
mvn archetype：generate 这个命令可以帮助我们生成一个Maven项目的骨架

     |--Pom.xml

       |--src

           |--main

                 |--java

                 |--resource

           |--test

                 |--java

                 |--resource

mvn dependency:list
mvn denpedency:tree
mvn dependency:analyze 可以分析当前项目依赖的问题
mvn clean install -DskipTests
mvn clean deploy 编译打包并发布到远程仓库
mvn clean install site

B. POM文件总结

        元素名称                             简   介

      <project>                         POM的xml根元素

      <parent>                          声明继承

      <modules>                         声明聚合

      <groupId>                         坐标元素之一

      <artifactId>                      坐标元素之一

      <version>                         坐标元素之一

      <packaging>                       坐标元素之一，默认值jar

      <name>                            名称

      <description>                     描述

      <organization>                    所属组织

      <licenses><license>               许可证

      <mailingLists><mailingList>       邮件列表

      <developers><developer>           开发者

      <contributors><contributor>       贡献者

      <issueManagement>                 问题追踪系统

      <ciManagement>                    持续集成系统

      <scm>                             版本控制系统

      <prerequisites><maven>            要求Maven最低版本，默认值为2.0

      <build><sourceDirectory>          主源码目录

      <build><scriptSourceDirectory>    脚本源码目录

      <build><testSourceDirectory>      测试源码目录

      <build><outputDirectory>          主源码输出目录

      <build><testOutputDirectory>      测试源码输出目录

      <build><resources><resource>      主资源目录

      <build><testResources><testResource> 测试资源目录

      <build><finalName>                输出主构件的名称

      <build><directory>                输出目录

      <build><filters><filter>          通过properties文件定义资源过滤属性

      <build><extensions><extension>    扩展Maven的核心

      <build><pluginManagement>         插件管理

      <build><plugins><plugin>          插件

      <profiles><profile>               POM Profile

      <distributionManagement><repository>  发布版本部署仓库

      <distributionManagement> <snapshotRepository> 快照版本部署仓库

      <distributionManagement> <site>   站点部署

      <repositories><repository>        仓库

      <pluginRepositories><pluginRepository>   插件仓库

      <dependencies><dependency>        依赖

      <dependencyManagement>            依赖管理

      <properties>                      Maven属性

      <reporting><plugins>              报告插件

C. settings文件例子

<settings>

<localRepository>D:\software\maven\Repository</localRepository>

<proxies>

<proxy>

    <id>optional</id>

    <active>true</active>

    <protocol>http</protocol>

    <host>10.47.22.247</host>

    <port>80</port>

    <nonProxyHosts>some.host.com</nonProxyHosts>

</proxy>

</proxies>

<servers>

<server>

    <id>releases</id>

    <username>pub_mvn_deploy</username>

    <password>mvn.Deploy</password>

</server>

<server>

    <id>snapshots</id>

    <username>pub_mvn_deploy</username>

    <password>mvn.Deploy</password>

</server>

<server>

    <id>nexus</id>

    <username>pub_mvn_deploy</username>

    <password>mvn.Deploy</password>

</server>

</servers>

<mirrors>

<mirror>

    <id>nexus</id>

    <mirrorOf>*</mirrorOf>

    <url>http://maven.dev.xxx.com/nexus/content/groups/public</url>

</mirror>

</mirrors>

<profiles>

<profile>

    <id>nexus</id>

    <repositories>

        <repository>

            <id>central</id>

            <url>http://central</url>

            <releases>

                <enabled>true</enabled>

            </releases>

            <snapshots>

                <enabled>true</enabled>

            </snapshots>

        </repository>

    </repositories>

    <pluginRepositories>

        <pluginRepository>

            <id>central</id>

            <url>http://central</url>

            <releases>

                <enabled>true</enabled>

            </releases>

            <snapshots>

                <enabled>true</enabled>

            </snapshots>

        </pluginRepository>

    </pluginRepositories>

</profile>

<!-- if you want to be able to switch to the defaultprofile profile put this in the active profile -->

<profile>

    <id>defaultprofile</id>

    <repositories>

        <repository>

            <id>maven.default</id>

            <name>default maven repository</name>

            <url>http://repo1.maven.org/maven2</url>

            <snapshots>

                <enabled>true</enabled>

            </snapshots>

        </repository>

        <repository>

            <id>maven.snapshot</id>

            <name>Maven snapshot repository</name>

            <url>http://people.apache.org/repo/m2-snapshot-repository</url>

            <snapshots>

                <enabled>true</enabled>

            </snapshots>

        </repository>

    </repositories>

</profile>

</profiles>

<activeProfiles>

<!--make the profile active all the time -->

<activeProfile>nexus</activeProfile>

</activeProfiles>

</settings>

D. settings文件元素参考表

1，<settings>，settings.xml文档的根元素

2，<localRepository>，本地仓库

3，<interactiveMode>，Maven是否与用户交互，默认值true

4，<offline>，离线模式，默认值false

5，<pluginGroups>  <pluginGroup>，插件组

6，<servers>  <server>，下载与部署仓库的认证信息

7，<mirrors>  <mirror>，仓库镜像

8，<proxies>  <proxy>，代理

9，<profiles>  <profile>，Settings Profile

10，<activeProfiles>  <activeProfile>，激活Profile

E. 常用插件总结

插件名称	                用途	                来源

maven-clean-plugin	   清理项目	          Apache

maven-compiler-plugin	编译项目	          Apache

maven-deploy-plugin	    部署项目	          Apache

maven-install-plugin	    安装项目	          Apache

maven-resources-plugin	处理资源文件	      Apache

maven-site-plugin	    生成站点	          Apache

maven-surefire-plugin	执行测试	          Apache

maven-jar-plugin	        构建jar项目	      Apache

maven-war-plugin     	构建war项目	      Apache

maven-shade-plugin	构建包含依赖的jar包	  Apache

maven-changelog-plugin	生成版本控制变更报告	Apache

maven-checkstyle-plugin	生成CheckStyle报告   Apache

maven-javadoc-plugin  	生成javadoc文档	   Apache

maven-jxr-plugin	      生成源码交叉引用文档	   Apache

maven-pmd-plugin	      生成pmd报告	       Apache

maven-project-info-reports-plugin	生成项目信息报告	Apache

maven-surefire-report-plugin	 生成单元测试报告	Apache

maven-antrun-plugin	    调用Ant任务	        Apache

maven-archetype-plugin	基于Archetype生成项目骨架	Apache

maven-assembly-plugin	构建自定义格式的分发包	    Apache

maven-dependency-plugin	依赖分析及控制	        Apache

maven-enforcer-plugin	定义规则并强制要求项目遵守	Apache

maven-pgp-plugin	      为项目构件生成pgp签名	    Apache

maven-help-plugin	  获取项目及Maven环境的信息	Apache

maven-invoker-plugin	  自动运行Maven项目构建并验证	Apache

maven-release-plugin  自动化项目版本发布	        Apache

maven-scm-plugin	      集成版本控制系统	       Apache

maven-source-plugin	  生成源码包	               Apache

maven-eclipse-plugin  生成eclipse项目环境配置	  Apache

build-helper-maven-plugin 包含各种支持构建生命周期的目标 Codehaus

exec-maven-plugin	  运行系统程序或者java程序  	Codehaus

jboss-maven-plugin	 启动、停止jboss、部署项目  	Codehaus

properties-maven-plugin	从properties文件读写Maven属性	Codehaus

sql-maven-plugin	     运行sql脚本	                Codehaus

tomcat-maven-plugin	 启动、停止tomcat、部署项目	Codehaus

versions-maven-plugin	自动化批量更新pom版本	   Codehaus

cargo-maven-plugin	 启动/停止/配置各类web容器自动化部署web项目	Cargo

jetty-maven-plugin	集成jetty容器、实现快速开发测试     	Eclipse

mave-gae-plugin	    集成google app engine	    Googlecode

maven-license-plugin	 自动化添加许可证证明至源码文件	Googlecode

maven-andmid-plugin	 构建Android项目	            Googlecode

F. 超级POM

这个POM会被每个POM继承。它的定义在model-builder.jar这个包下面。我们解压就可以看到。

G. 图片工具

http://techsmith.com/jing这个网站提供了一个不错的制图工具，有时间可以研究下。

H. 参考书籍

《Maven实战》
《Maven权威指南》

I. Maven和gradle的对比