Maven聚合

当我们需要使用java做一个电商网站，涉及到：pc端网站、h5微站、移动端接口部分，可以使用Mavn中的聚合来实现。整个电商我们可以作为一个大的系统，上面的pc端、h5微站、api接口、后台系统、bi系统、监控系统都可以作为里面的一个具体比较大一个模块。

Maven聚合可以使用一个Maven项目来管理其他Maven构件模块。实现这个功能pom文件中需要加入如下配置：

模块1
模块2
模块n

pom

项目中执行任何 mvn 命令，都会 modules 中包含的所有模块执行同样的命令，而被包含的模块不需要做任何特殊的配置，正常的maven项目就行。注意上面的 module 元素，这部分是被聚合的模块 pom.xml 所在目录的相对路径。package的值必须为pom。

创建Maven项目，配置好Maven环境。

删除上面红色标记的无用文件。在pom文件加入如下配置：

pom

创建maven-pc端模块

鼠标右键选中项目，点击File-->New-->Module

点击Next，配置parent为none，输入名称maven-pc，如下图：

点击Finish，完成创建。如下图

查看原来的mavenTogether项目pom文件是否增加了内容，可能是IDEA版本问题，我的没有增加，添加如下内容：

maven-pc

同样的方法创建mavn-h5模块和maven-api模块，最终结构如下图：（maven-h5少了一个字符，不必介意，不影响结果）

在mavenTogether项目目录下执行mvn package感受一下效果，如下图：

可以看到在mavenTogether项目目录下执行mvn命令，各个模块下也都执行了相应的命令。

pom.xml中的 module 元素的值为被聚合的模块pom.xml所在的目录路径，可以是相对路径，也可以是绝对路径，有兴趣的朋友可以尝试一下。

Maven继承

大家可以看到上文几个项目的groupId、version 都是一样的，如果都进行web开发，每个pom文件都要添加相应的依赖构件。这样配置显然是比较麻烦的，可以通过maven继承更简单的进行配置，把公共的依赖构件提取出来，使模块pom也可以引用。

实现步骤

1、创建一个父maven项目，创建过程和Maven聚合创建主maven项目一样。

2、创建模块项目和maven聚合也类似，只有一个不一样的地方就是parent选择父项目。

创建完模块项目，pom文件自动增加了parent元素并且groupId、version 都没有了，这个 pom.xml 继承了 父项目pom.xml 中的内容，他们的 groupId、version 都是一样的，子构件可以从父pom.xml中继承这些内容，所以如果是一样的情况，可以不写。父项目pom文件增加了modules元素。

3、将依赖信息放在父项目pom.xml中，检查package元素内容是不是pom。

org.springframework
spring-web
5.2.1.RELEASE


org.mybatis
mybatis-spring
2.0.3

分别在父项目目录和模块项目目录下运行mvn dependency:tree查看构件依赖情况，看看输出是否相同，如果相同说明模块项目继承了父项目构件。

relativePath元素

上面父构件和子构件的目录结构刚好符合父子关系，如果父构件和子构件的目录不是父子关系，位于同等级别的目录或者位于更复杂的目录的时候，此时我们需要在子 pom.xml 的 parent 元素中使用 relativePath 元素来指定父 pom.xml 相对路径位置，默认是 ../pom.xml ，表示父pom.xml位于子pom.xml的上一级目录，我们的模块刚好符合这种关系，所以这个值省略了。

正确的设置 relativePath 是非常重要的，子模块中执行 mvn 命令的时候，会去找父pom.xml 的配置，会先通过 relativePath 指定的路径去找，如果找不到，会尝试通过坐标在本地仓库进行查找，如果本地找不到，会去远程仓库找，如果远程仓库也没有，会报错。

可以继承的元素：

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

依赖管理(dependencyManagement)

如果我们在新增一个子构件，都会默认从父构件中继承依赖的一批构建，可能某个子项目只是想使用父pom.xml中一个构件，但是上面的继承关系却把所有的依赖都给传递到子构件中了，可以使用 dependencyManagement 元素来解决这个问题。

maven提供的dependencyManagement元素既能让子模块继承到父模块的依赖配置，又能保证子模块依赖使用的灵活性，在dependencyManagement元素下声明的依赖不会引入实际的依赖，他只是声明了这些依赖，不过它可以对 dependencies 中使用的依赖起到一些约束作用。

在父项项目pom中把依赖都放入dependencyManagement元素下。

org.springframework
spring-web
5.2.1.RELEASE


org.mybatis
mybatis-spring
2.0.3

在父项目目录运行mvn dependency:tree命令，可以发现父子构件中都看不到依赖的jar包了，说明父pom.xml中dependencyManagement这些依赖的构建没有被子模块依赖进去。

子模块项目如果想使用依赖需要在pom中 dependencies元素 引用这些依赖。

org.springframework
spring-web


org.mybatis
mybatis-spring

再次在父项目目录运行mvn dependency:tree命令，发现子模块可以看到依赖关系了。

dependencyManagement不会引入实际的依赖，只有在子类中使用 dependency 来引入父dependencyManagement 声明的依赖之后，依赖的构建才会被真正的引入。

使用dependencyManagement来解决继承的问题，子pom.xml中只用写 groupId,artifactId 就可以了，其他信息都会从父 dependencyManagement 中声明的依赖关系中传递过来，通常我们使用这种方式将所有依赖的构建在父pom.xml中定义好，子构件中只需要通过 groupId,artifactId 就可以引入依赖的构建，而不需要写 version ，可以很好的确保多个子项目中依赖构件的版本的一致性，对应依赖构件版本的升级也非常方便，只需要在父pom.xml中修改一下就可以了。

单继承问题

Maven是单继承的，如果我们想使用另外一个项目中声明的依赖，可以使用import导入另一个项目的依赖。

创建maven项目maven-demo，在pom文件中添加依赖。

在项目目录下运行mvn install 下载依赖到本地仓库。

在父项目pom中dependencyManagement元素下加入如下内容：

com.example
maven-demo
1.0-SNAPSHOT
pom
import

上面有两个关键元素：type的值必须是pom，scope元素的值必须是import。

在子模块项目pom文件dependencies元素中加入如下内容：

	com.alibaba
	fastjson

这时该子模块就可以使用引用的依赖了，如下图：

其实只要将两段内容加入pom文件中，都可以把依赖导入进来，正常使用依赖包。

插件管理(pluginManagement)

父pom中可以在pluginManagement元素中声明插件的配置信息，但是子pom.xml中不会引入此插件的配置信息，只有在子pom.xml中使用 plugins->plugin 元素正在引入这些声明的插件的时候，插件才会起效，子插件中只需要写 groupId、artifactId ，其他信息都可以从父构件中传递过来。

在父项目pom中加入如下内容：

	
		
			
				org.apache.maven.plugins
				maven-clean-plugin
				3.1.0
			
		
	

子模块pom中加入如下内容：

	
		
			org.apache.maven.plugins
    	maven-clean-plugin
		
	

可以在项目目录运行mvn clean命令进行验证一下。

聚合与继承的关系

聚合主要是为了方便多模块快速构建，而继承主要是为了重用相同的配置。对于聚合来说，聚合模块是知道被聚合模块的存在的，而被聚合模块是感知不到聚合模块的存在。对于继承来说，父构件是感知不到子构件的存在，而子构件需要使用 parent 来引用父构件。

两者的共同点是，聚合模块和继承中的父模块的package属性都必须是pom类型的，同时，聚合模块和父模块中的除了pom.xml，一般都是没有什么内容的。实际使用是，我们经常将聚合和继承一起使用，能同时使用到两者的优点。