（IX）Maven聚合和继承

概述：当前软件设计人员会对软件划分模块，以得到更清晰的设计及更高的重用性。简单来说，Maven的聚合特性就是将项目的各个模块聚合在一起进行构建，Maven的继承特性可以帮助抽取各模块间相同的依赖和插件等配置。

聚合

示例聚合模块pom：

<project>
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.play.myMaven</groupId>
  <artifactId>hello-maven-aggregator</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>POM</packaging>
  <name>Hello-Maven Aggregator</name>
  <modules>
    <module>hello-maven-persist</module>
    <module>hello-maven-server</module>
    <module>hello-maven-web</module>
  </modules>
</project>

• packaging值为POM。如果不声明，默认为jar。对于聚合模块来说，其打包方式必须为pom，否则无法构建。
• name值，可以帮助提高项目的易读性。
• modules是其中最核心的配置。可以通过在一个打包方式为pom的Maven项目中声明任意数量的module元素来实现模块的聚合。这里每个module值都是当前POM的相对目录。
• 为了方便我们快速定位，一般模块所处的目录名称应当与其artifactId一致。
• 为了方便我们构建项目，通常将聚合模块放在项目目录最顶层，即聚合模块和其他模块是父子关系。
• Hello-Maven Aggregator仅仅是一个pom.xml文件

其余模块示例：

<project>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>hello-maven-persist</artifactId>
</project>

执行一次mvn clean install

C:\Subversion\MavenPrj\helloMaven>mvn clean install
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Build Order:
[INFO]
[INFO] Hello-Maven Aggregator
[INFO] hello-maven-persist
[INFO] hello-maven-server
[INFO] hello-maven-web
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building Hello-Maven Aggregator 1.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
...
[INFO] Installing C:\Subversion\MavenPrj\helloMaven\pom.xml to C:\Repository\m2repo\com\play\myMaven\hello-maven-aggregator\1.0-SNAPSHOT\hello-maven-aggregator-1.0-SNAPSHOT.pom
[INFO] ------------------------------------------------------------------------
[INFO] Building hello-maven-persist 1.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
...
[INFO] Installing   C:\Subversion\MavenPrj\helloMaven\hello-maven-persist\target\hello-maven-persist-1.0-SNAPSHOT.jar to C:\Repository\m2repo\com\play\myMaven\hello-maven-persist\1.0-SNAPSHOT\hello-maven-persist-1.0-SNAPSHOT.jar
[INFO] Installing C:\Subversion\MavenPrj\helloMaven\hello-maven-persist\pom.xml to C:\Repository\m2repo\com\play\myMaven\hello-maven-persist\1.0-SNAPSHOT\hello-maven-persist-1.0-SNAPSHOT.pom
...
[INFO] ------------------------------------------------------------------------
[INFO] Building hello-maven-server 1.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
...
[INFO] ------------------------------------------------------------------------
[INFO] Building hello-maven-web 1.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
...
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
[INFO] Hello-Maven Aggregator ............................. SUCCESS [  0.631 s]
[INFO] hello-maven-persist ................................ SUCCESS [  0.807 s]
[INFO] hello-maven-server ................................. SUCCESS [  0.087 s]
[INFO] hello-maven-web .................................... SUCCESS [  0.085 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS

• Maven会首先解析聚合模块的POM、分析要构建的模块、并计算出一个反应堆构建顺序Reactor Build Order，根据这个顺序依次构建各个模块。
• Hello-Maven Aggregator是这四个模块中唯一定义name的了，所以可以看的出来上述显示的为各模块的名称，不定义的话显示name=artifactId。最好显示声明name元素。

继承

多个POM中有着很多相同的配置，例如相同的groupId和version，有相同的spring-core、spring-beans、spring-context、spring-junit依赖等，还有相同的maven-compiler-plugin与maven-resources-plugin的插件配置等。为了避免重复，我们可以使用POM的继承特性。即“一处声明多处可用”。

示例parent模块POM：

<project>
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.play.myMaven</groupId>
    <artifactId>hello-maven-parent</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>

    <name>parent</name>

    <properties>
        ...
    </properties>

    <dependencies>
        ...
    </dependencies>

    <build><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
        <plugins>
            ...
        </plugins>
    </build>
</project>

• packaging作为父模块的POM，打包方式也必须为pom

其余模块需要继承parent模块，示例：

<project xmlns="http://maven.apache.org/POM/4.0.0">
    <parent>
        <artifactId>hello-maven-parent</artifactId>
        <groupId>com.play.myMaven</groupId>
        <version>1.0-SNAPSHOT</version>
        <relativePath>../hello-maven-parent</relativePath>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>hello-maven-persist</artifactId>
</project>

• 声明<parent>元素，artifactId、groupId、version是必要的，这些是可以找到父元素所依据的坐标。
• 声明正确的相对路径<relativePath>。relativePath默认父POM为../pom,xml，即默认为在上一层目录下。Maven会先依据relativePath检查父POM，找到不到，再从本地仓库找。
• 子POM可以不需要声明groupId、version，直接隐式继承父POM的这两个元素。当然在不同的groupId或version时，也是需要显式声明的。
• 子POM中需要显式声明artifactId。如果不声明则完全继承父POM三个坐标值，会造成坐标冲突。

将parent模块加入到聚合模块：

<modules>
  <module>hello-maven-persist</module>
  <module>hello-maven-server</module>
  <module>hello-maven-web</module>
  <module>hello-maven-parent</module>
</modules>

---

✿✿✿✿✿✿✿✿✿✿✿✿✿ 华丽丽的分界线✿✿ ✿✿✿✿✿✿✿✿✿✿✿

---

可继承的POM元素

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

---

聚合与继承的关系

聚合和继承是两个完全不同的概念。

聚合是为了快速构建项目，继承是为了消除重复配置。

共同点：
聚合POM与继承的父POM的packaging都必须是pom，另外，他们都没有实际的内容。当然我们也可以将聚合POM和父POM融合使用。
相关链接：
依赖管理
插件管理
约定优于配置
反应堆