构建与依赖 / 系统课时

聚合与继承的区别

聚合与继承的区别

<modules> 与 <parent> 经常写在同一个根 POM 中,因此很容易被当成一件事。实际工程里它们解决的是两个独立问题:聚合决定“这次一起构建谁”,继承决定“子项目从谁那里拿默认配置”。区分清楚后,才能设计可拆分、可单独构建的多模块项目。

学习目标

  • 判断 <modules> 与 <parent> 分别影响 Reactor 构建还是 POM 配置继承。
  • 看懂一个 POM 同时承担聚合器与父 POM 两种角色时的实际行为。
  • 用命令验证继承结果,并能根据工程边界决定两种关系是否都需要。

先用两个判断问题区分

看到多模块工程时,先问两个问题。第一,根目录执行 Maven 时,哪些项目要被自动加入同一次 Reactor?这由聚合 POM 的 <modules> 决定。第二,某个子项目没有显式写版本、属性或插件配置时,它从哪里获得这些值?这由子 POM 的 <parent> 决定。

机制 写在谁的 POM 关键元素 直接作用
聚合 聚合器 <modules> / <module> 把多个项目加入同一次 Reactor 构建
继承 子项目 <parent> 继承父 POM 的 groupId、version、属性及可继承配置

Maven聚合与继承对比

看一个同时聚合又继承的工程

下面的根 POM 同时声明 <modules> 和公共属性,因此它既是聚合器,也可以被子模块作为父 POM。maven.compiler.release 设置为 17,便于后面用命令验证继承是否发生。

xml
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <!-- 这组坐标既标识根项目,也供子模块的 parent 引用。 -->
  <groupId>com.example</groupId>
  <artifactId>demo-root</artifactId>
  <version>1.0.0-SNAPSHOT</version>
  <packaging>pom</packaging>

  <!-- modules 只决定 Reactor 成员。 -->
  <modules>
    <module>app</module>
    <module>lib</module>
  </modules>

  <properties>
    <maven.compiler.release>17</maven.compiler.release>
  </properties>
</project>

app/pom.xml 通过 <parent> 指向上一级 POM,因此不用重复写 groupId 和 version,也会继承 maven.compiler.release=17。

xml
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <!-- 未写 relativePath 时,Maven 默认先检查 ../pom.xml。 -->
  <parent>
    <groupId>com.example</groupId>
    <artifactId>demo-root</artifactId>
    <version>1.0.0-SNAPSHOT</version>
  </parent>

  <artifactId>app</artifactId>
</project>

这里有两条独立关系:根 POM 因为 <module>app</module> 会把 app 聚合进 Reactor;app 因为 <parent> 会继承根 POM。任意删除其中一条,另一条关系仍可存在。

用命令验证继承结果

从根目录读取 app 的有效属性,可以直接验证父 POM 是否提供了 Java release 值。-pl app 选择 Reactor 中的 app 项目,help:evaluate 读取模型表达式。

bash
mvn -q -pl app help:evaluate -Dexpression=maven.compiler.release -DforceStdout

预期输出

text
17

如果删除 app/pom.xml 的 <parent>,又没有在 app 自己定义该属性,上述表达式将不再得到继承值。反过来,如果只从根 POM 的 <modules> 删除 app,但保留 <parent>,app 仍然可以继承根 POM;只是根目录的 Reactor 不会再自动把它作为模块加入构建。

按工程边界选择关系

同一仓库的业务模块通常既需要聚合,也需要继承:根 POM 统一 Java 版本、依赖和插件策略,同时一次构建全部模块。共享给多个仓库的企业父 POM 则常常只做继承,不在其中列出各业务仓库的 <modules>。

设计时不要用目录层级代替关系判断。子项目位于根目录下面,不代表它自动被聚合;子 POM 省略了 groupId 和 version,也只有在 <parent> 可解析时才成立。分别检查 Reactor 成员与有效 POM,能最快确认工程关系是否符合预期。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

聚合与继承的区别

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通