架构师修炼之道

知识日新月异,唯有保持同步迭代,才能适应变化的未来!

0%

基于Apache Maven构建多模块项目

介绍

  • 多模块项目由管理一组子模块的聚合器 POM 来构建。在大多数情况下聚合器位于项目的根目录中,并且必须是 pom 类型的项目。
  • 子模块是常规的 Maven 项目,它们可以单独构建,也可以通过聚合器 POM 构建。
  • 通过聚合器 POM 构建项目时会一并构建下属的所有子模块。

多模块的优势

  • 减少重复
  • 共享依赖项和配置文件

父 POM

  • 可以创建自己的 pom.xml 文件,并作为父项目。
  • 在每个子模块的 pom.xml 文件中声明对父 POM 的继承依赖关系。
  • 父项目中另外也要声明其所属的子模块。
  • 父项目也可以单继承另一个父项目。

构建应用程序

设想这个应用程序包含四个模块,它们分别是:

模块名称 独立部署 说明
commons 公共子模块
service 业务逻辑子模块
web Web服务子模块
job 后台任务子模块

创建父POM

  1. 新增一个常规项目 msa-order
  2. 在 pom.xml 文件中增加 <packaging>pom</packaging>
  3. 声明子模块中需要复用的依赖或配置,例如:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    <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>

创建子模块

  1. 依次创建四个常规项目
  2. 在父 pom.xml 文件的 modules 元素中添加子模块
    1
    2
    3
    4
    5
    6
      <modules>
    <module>commons</module>
    <module>service</module>
    <module>web</module>
    <module>job</module>
    </modules>
  3. 在各个子模块的 pom.xml 文件中添加对父项目的依赖
    1
    2
    3
    4
    5
    <parent>
    <artifactId>msa-order-parent</artifactId>
    <groupId>com.tianmingxing.demo</groupId>
    <version>1.0.0-SNAPSHOT</version>
    </parent>

构建项目

  1. 在父项目下执行 mvn package,这将构建所有模块其输出如下:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    [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] ------------------------------------------------------------------------
  2. 构建顺序:
  • 项目依赖于构建中的另一个模块
  • 插件声明,其中插件是构建中的另一个子模块
  • 插件依赖于构建中的另一个模块
  • 构建中另一个模块的构建扩展声明
  • <modules> 元素中声明的顺序
  1. 可以指定构建的模块,例如本次只想构建web子模块以及它依赖的其它模块,则可以使用命令 mvn -DskipTests=true package -pl web -am

源码下载