聚合
当我们一次想要构建多个项目时,而不是到每一个模块的目录下分别执行mvn命令。这个时候就需要使用到maven的聚合特性
-
这里第一个特殊的地方是packaging,值设置为pom。我们正常开发的其他模块中都没有声明packaging,默认使用了默认值jar,但是对于聚合模块来说,其打包方式必须为pom,否则无法构建。
-
元素 modules 是实现聚合的核心配置,用户可以通过在一个打包方式为pom的Maven项目中声明任意数量的module元素来实现模块的聚合,这里每一个module值都是一个当前pom的相对目录,因此一般来说模块所处的目录名称应当与其artifactId一致,也可以进行自定义名称更改对应的module配置就可以。
-
一般来说,为了方便用户构建项目,通常将聚合模块放在项目目录的最底层,其他模块则作为聚合模块的子目录存在,这样当用户得到源码的时候第一眼发现的就是聚合模块的pom,不用从多个模块中去寻找聚合模块来构建整个项目。
继承
当我们多个模块下存在很多相同的配置时,例如它们都有相同的groupId和version,有相同的spring-core,slf4j,junit依赖,还有相同的maven-compiler-plugin配置时。在mavne的世界中,也有类似的机制能让我们抽取出重复的配置,这就是pom的继承
-
上图pom中使用parent声明父模块,parent下的子元素,groupId,artifactId和version指定了父模块的坐标,这三个元素是必须的,还有一个元素relativePath表示父模块pom相对路径。当项目构建时,Maven会首先根据relativePath检查父pom,如果找不到,再从本地仓库查找。relativePath默认值是
<relativePath>../pom.xml</relativePath>
,也就是说Maven默认父pom在上一层目录下。 -
图中我们的
pipeline
这个模块并没有声明groupId和verison,这并不代表我们这个模块中没有groupId和verison。实际上我们这个子模块隐式的从父模块中继承了这两个元素,消除了一些不必要的配置,如果遇到子模块需要使用和父模块不一样的groupId和verison,那么可以在子模块中显示声明
可继承的POM元素
-
groupId:项目组ID,项目坐标的核心元素
-
version:项目版本,项目坐标的核心元素
-
description:项目的描述信息
-
organization:项目的组织信息
-
inceptionYear:项目的创始年份
-
url:项目的URL地址
-
developers:项目的开发者信息
-
contributors:项目的贡献者信息
-
distributionManagement:项目的部署配置
-
issueManagement:项目的缺陷跟踪系统信息
-
ciManagement:项目的持续集成系统信息
-
scm:项目的版本控制系统信息
-
mailingLists:项目的邮件列表信息
-
properties:自定义的Maven属性
-
dependencies:项目的依赖配置
-
dependencyManagement:项目的依赖管理配置
-
repositories:项目的仓库配置
-
build:包括项目的源码目录配置、输出目录配置、插件配置、插件管理配置等
-
reporting:包括项目的报告输出目录配置、报告插件配置等。
依赖管理
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<version>2.3.2.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<version>2.3.2.RELEASE</version>
</dependency>
<dependency>
<groupId>cn.hutool</groupId>
<artifactId>hutool-all</artifactId>
<version>5.8.12</version>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>com.zaxxer</groupId>
<artifactId>HikariCP</artifactId>
</dependency>
</dependencies>
maven的可继承元素列表包含了dependencies元素,这说明依赖是会被继承的,这时我们可以将一些共用依赖放到父模块中,子模块就可以移除这些依赖,简化配置。但同时也会产生其他问题,目前我们的子模块中都需要上述父模块中的依赖,假如将来项目中需要加入一个util模块,该模块只是需要提供一些工具,与springframework完全无关,难道也让它依赖sping相关依赖吗?这样显然是不合理的。为此 Maven 引入了 dependencyManagement 来对依赖进行管理。
dependencyManagement
<!-- 该标签只用来控制版本,不能将依赖引入 -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<version>2.3.2.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<version>2.3.2.RELEASE</version>
</dependency>
</dependencies>
</dependencyManagement>
Maven 可以通过 dependencyManagement 元素对依赖进行管理,它具有以下 2 大特性:
- 在该元素下声明的依赖不会实际引入到模块中,只有在 dependencies 元素下同样声明了该依赖,才会引入到模块中。
- 该元素能够约束 dependencies 下依赖的使用,即 dependencies 声明的依赖若未指定版本,则使用 dependencyManagement 中指定的版本,否则将覆盖 dependencyManagement 中的版本。
更改pipeline
子模块对应的配置,我们在dependencies中只需要配置 groupId 和 artifactId,省去了 version 和 scope。之所以能够省略这些信息,是因为它们继承了父模块 Root 中 dependencyManagement 的配置,其完整的依赖声明已经包含在父模块的 POM 中,子模块只需要配置 groupId 和 artifactId 就能获得相应的依赖信息,从而引入正确的依赖。
优点:
- 在父模块中使用dependencyManagement 声明依赖能够统一项目内依赖的版本,子模块无须声明版本,也就不会出现多个子模块使用同一依赖项版本不一致的情况,降低依赖冲突的几率。
- dependencyManagement 声明的依赖不会被实际引入,子模块需要什么依赖就自己引入,增加了灵活性,避免引入一些不必要的依赖。
扩展
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.3.2.RELEASE</version>
</parent>
单继承问题
现在有个问题,我现在想使用spring-boot-starter-parent提供的依赖管理,但是我又不想继承他,因为我还要继承别的项目,这时候该怎么办呢?
maven和Java一样都是单继承机制,maven当中有pom和import ,通过这两个标签在dependencyManagement中声明依赖,可以替代继承(达到类似parent标签的作用,解决了单继承问题)。
官网讲解:https://docs.spring.io/spring-boot/maven-plugin/using.html
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>2.3.2.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
类似于
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.3.2.RELEASE</version>
<relativePath/>
</parent>
注意:使用dependencyManagement来替代parent的时候,pluginManagement里面嵌套的plugins版本并没有继承过来。
总结
推荐自定义dependencies,不使用spring-boot-dependencies
,版本控制更加灵活,spring-boot-dependencies
中不存在的依赖也可以添加进去,版本依赖进行升级时,自主控制,不会出现多个子模块使用同一依赖项版本不一致的情况,降低依赖冲突的几率。