【构建工具】《Maven实战》读书笔记
- 2019 年 11 月 2 日
- 筆記
目录
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> </dependency4. Maven仓库
Maven的仓库分为本地仓库和远程仓库。Maven在寻找依赖的时候会先从本地仓库寻找，本地没有的话会从远程仓库去下载到本地然后再使用。
4.1 仓库的分类
4.1.1 本地仓库
本地仓库需要我们在settings.xml配置文件中配置。注意，默认情况下.m2目录下是没有这文件的，需要我们自己配置。所有的依赖都会被缓存到本地仓库，本地没有的话回去远程仓库拿。
<localRepository>D:softwaremavenRepository</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> 我们先看一下
这边整理下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-deploy5.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*Test8.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> </activeProfiles12.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:softwaremavenRepository</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>，激活ProfileE. 常用插件总结
插件名称 用途 来源 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项目 GooglecodeF. 超级POM
这个POM会被每个POM继承。它的定义在model-builder.jar这个包下面。我们解压就可以看到。
G. 图片工具
http://techsmith.com/jing这个网站提供了一个不错的制图工具，有时间可以研究下。
H. 参考书籍
- 《Maven实战》
- 《Maven权威指南》
I. Maven和gradle的对比
- https://www.cnblogs.com/huang0925/p/5209563.html
- http://blog.csdn.net/xad707348125/article/details/46891941
- https://maven.apache.org/settings.html (Maven官网)
