title: 基于Apache Maven构建多模块项目
date: 2022-04-10 00:00:00
tags:
- Apache Maven
- 多模块
categories: - Maven
介绍
- 多模块项目由管理一组子模块的聚合器 POM 来构建。在大多数情况下聚合器位于项目的根目录中,并且必须是 pom 类型的项目。
- 子模块是常规的 Maven 项目,它们可以单独构建,也可以通过聚合器 POM 构建。
- 通过聚合器 POM 构建项目时会一并构建下属的所有子模块。
多模块的优势
- 减少重复
- 共享依赖项和配置文件
父 POM
- 可以创建自己的 pom.xml 文件,并作为父项目。
- 在每个子模块的 pom.xml 文件中声明对父 POM 的继承依赖关系。
- 父项目中另外也要声明其所属的子模块。
- 父项目也可以单继承另一个父项目。
构建应用程序
设想这个应用程序包含四个模块,它们分别是:
模块名称 | 独立部署 | 说明 |
---|---|---|
commons | 否 | 公共子模块 |
service | 否 | 业务逻辑子模块 |
web | 是 | Web服务子模块 |
job | 是 | 后台任务子模块 |
创建父POM
- 新增一个常规项目
msa-order
- 在 pom.xml 文件中增加
<packaging>pom</packaging>
- 声明子模块中需要复用的依赖或配置,例如:
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.6.6</version>
<relativePath/>
</parent>
<properties>
<java.version>11</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-webflux</artifactId>
</dependency>
</dependencies>
创建子模块
- 依次创建四个常规项目
- 在父 pom.xml 文件的 modules 元素中添加子模块
<modules>
<module>commons</module>
<module>service</module>
<module>web</module>
<module>job</module>
</modules>
- 在各个子模块的 pom.xml 文件中添加对父项目的依赖
<parent>
<artifactId>msa-order-parent</artifactId>
<groupId>com.tianmingxing.demo</groupId>
<version>1.0.0-SNAPSHOT</version>
</parent>
构建项目
- 在父项目下执行
mvn package
,这将构建所有模块其输出如下:
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary for msa-order 1.0.0-SNAPSHOT:
[INFO]
[INFO] msa-order .......................................... SUCCESS [ 0.003 s]
[INFO] commons ............................................ SUCCESS [ 1.625 s]
[INFO] service ............................................ SUCCESS [ 0.056 s]
[INFO] web ................................................ SUCCESS [ 0.891 s]
[INFO] job ................................................ SUCCESS [ 0.110 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
- 构建顺序:
- 项目依赖于构建中的另一个模块
- 插件声明,其中插件是构建中的另一个子模块
- 插件依赖于构建中的另一个模块
- 构建中另一个模块的构建扩展声明
<modules>
元素中声明的顺序
- 可以指定构建的模块,例如本次只想构建web子模块以及它依赖的其它模块,则可以使用命令
mvn -DskipTests=true package -pl web -am
。