Maven聚合与继承

一、聚合

为了能够使用一条命令就能构建  account-email 和  account-persist 两个模块，我们需要建立一个额外的名为  account-aggregator 的模块，然后通过该模块构建整个项目的所有模块。  account-aggregator 本身也是个  Maven 项目，它的  POM 如下

 <project>
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.juvenxu.mvnbook.account</groupId>
     <artifactId>account-aggregator</artifactId>
     <version>1.0.0-SNAPSHOT</version>
     <packaging> pom </packaging>
     <name>Account Aggregator</name>
      <modules>
         <module>account-email</module>
         <module>account-persist</module>
      </modules>
 </project>

  注意：packaging的类型为pom ，module的值是一个以当前POM为主目录的相对路径。

二、继承

可声明父POM供子 POM继承

父模块POM如下：

 

 <project>
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.juvenxu.mvnbook.account</groupId>
     <artifactId> account-parent </artifactId>
     <version>1.0.0-SNAPSHOT</version>
     <packaging>pom</packaging>
     <name>Account Parent</name>
 </project>

 子模块声明继承如下：

 

 <project>
     <modelVersion>4.0.0</modelVersion>

     < parent >
         <groupId>com.juvenxu.mvnbook.account</groupId>
         <artifactId> account-parent </artifactId>
         <version>1.0.0-SNAPSHOT</version>
         < relativePath >../account-parent/pom.xml</ relativePath>
     </ parent >

     <artifactId> account-email </artifactId>
     <name>Account Email</name>
   ...
 </project>

 最后，同样还需要把 account-parent加入到聚合模块account-aggregator中。聚合的 POM如下：

 

 <project>
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.juvenxu.mvnbook.account</groupId>
     <artifactId>account-aggregator</artifactId>
     <version>1.0.0-SNAPSHOT</version>
     <packaging> pom </packaging>
     <name>Account Aggregator</name>
     <modules>
         <module>account-email</module>
         <module>account-persist</module>
         <module> account-parent</module>
     </modules>
 </project>

  注意：

1、子模块没有声明groupId和version, 这两个属性继承至父模块。但如果子模块有不同与父模块的 groupId、version ，也可指定；

2、不应该继承artifactId,如果groupId ，version，artifactId 完全继承的话会造成坐标冲突；另外即使使用不同的 groupId或version，同样的 artifactId也容易产生混淆。
3、使用继承后 parent也必须像自模块一样加入到聚合模块中。也就是在在聚合模块的 pom中加入<module>account-parent</module>

补充：依赖管理

避免不同子模块中依赖版本冲突

在主pom中配置依赖

<div class="dp-highlighter bg_java" style="font-family: Consolas, 'Courier New', Courier, mono, serif; border: 1px dashed rgb(153, 153, 153); font-size: 12px; width: 932.578125px; overflow: auto; padding-top: 1px; margin: 18px 0px !important; background-color: rgb(245, 245, 245);"><ol start="1" class="dp-j" style="margin: 0px; padding: 5px 0px; border: none; position: relative; list-style-position: initial; list-style-image: initial; color: rgb(92, 92, 92);"><li class="alt" style="margin: 0px !important; padding: 0px 3px 0px 10px !important; border: none; list-style: decimal-leading-zero outside; color: inherit; line-height: 13.1999998092651px;"><span style="margin: 0px; padding: 0px; border: none; color: black; background-color: inherit;"><dependencyManagement>    </span></li><li style="border: none; list-style: decimal-leading-zero outside; line-height: 13.1999998092651px; margin: 0px !important; padding: 0px 3px 0px 10px !important;"><span style="margin: 0px; padding: 0px; border: none; color: black; background-color: inherit;">    <dependencies>    </span></li><li class="alt" style="margin: 0px !important; padding: 0px 3px 0px 10px !important; border: none; list-style: decimal-leading-zero outside; color: inherit; line-height: 13.1999998092651px;"><span style="margin: 0px; padding: 0px; border: none; color: black; background-color: inherit;">     <dependency>    </span></li><li style="border: none; list-style: decimal-leading-zero outside; line-height: 13.1999998092651px; margin: 0px !important; padding: 0px 3px 0px 10px !important;"><span style="margin: 0px; padding: 0px; border: none; color: black; background-color: inherit;">       <groupId>mysql</groupId>    </span></li><li class="alt" style="margin: 0px !important; padding: 0px 3px 0px 10px !important; border: none; list-style: decimal-leading-zero outside; color: inherit; line-height: 13.1999998092651px;"><span style="margin: 0px; padding: 0px; border: none; color: black; background-color: inherit;">       <artifactId>mysql-connector-java</artifactId>    </span></li><li style="border: none; list-style: decimal-leading-zero outside; line-height: 13.1999998092651px; margin: 0px !important; padding: 0px 3px 0px 10px !important;"><span style="margin: 0px; padding: 0px; border: none; color: black; background-color: inherit;">      <version><span class="number" style="margin: 0px; padding: 0px; border: none; color: rgb(192, 0, 0); background-color: inherit;">5.1</span><span style="margin: 0px; padding: 0px; border: none; background-color: inherit;">.</span><span class="number" style="margin: 0px; padding: 0px; border: none; color: rgb(192, 0, 0); background-color: inherit;">2</span><span style="margin: 0px; padding: 0px; border: none; background-color: inherit;"></version>    </span></span></li><li class="alt" style="margin: 0px !important; padding: 0px 3px 0px 10px !important; border: none; list-style: decimal-leading-zero outside; color: inherit; line-height: 13.1999998092651px;"><span style="margin: 0px; padding: 0px; border: none; color: black; background-color: inherit;">     </dependency>    </span></li><li style="border: none; list-style: decimal-leading-zero outside; line-height: 13.1999998092651px; margin: 0px !important; padding: 0px 3px 0px 10px !important;"><span style="margin: 0px; padding: 0px; border: none; color: black; background-color: inherit;">      ...    </span></li><li class="alt" style="margin: 0px !important; padding: 0px 3px 0px 10px !important; border: none; list-style: decimal-leading-zero outside; color: inherit; line-height: 13.1999998092651px;"><span style="margin: 0px; padding: 0px; border: none; color: black; background-color: inherit;">   <dependencies>    </span></li><li style="border: none; list-style: decimal-leading-zero outside; line-height: 13.1999998092651px; margin: 0px !important; padding: 0px 3px 0px 10px !important;"><span style="margin: 0px; padding: 0px; border: none; color: black; background-color: inherit;"></dependencyManagement>  </span></li></ol></div>

在子pom中添加依赖

<div class="dp-highlighter bg_java" style="font-family: Consolas, 'Courier New', Courier, mono, serif; border: 1px dashed rgb(153, 153, 153); font-size: 12px; width: 932.578125px; overflow: auto; padding-top: 1px; margin: 18px 0px !important; background-color: rgb(245, 245, 245);"><ol start="1" class="dp-j" style="margin: 0px; padding: 5px 0px; border: none; position: relative; list-style-position: initial; list-style-image: initial; color: rgb(92, 92, 92);"><li class="alt" style="margin: 0px !important; padding: 0px 3px 0px 10px !important; border: none; list-style: decimal-leading-zero outside; color: inherit; line-height: 13.1999998092651px;"><span style="margin: 0px; padding: 0px; border: none; color: black; background-color: inherit;"><dependencies>    </span></li><li style="border: none; list-style: decimal-leading-zero outside; line-height: 13.1999998092651px; margin: 0px !important; padding: 0px 3px 0px 10px !important;"><span style="margin: 0px; padding: 0px; border: none; color: black; background-color: inherit;">   <dependency>    </span></li><li class="alt" style="margin: 0px !important; padding: 0px 3px 0px 10px !important; border: none; list-style: decimal-leading-zero outside; color: inherit; line-height: 13.1999998092651px;"><span style="margin: 0px; padding: 0px; border: none; color: black; background-color: inherit;">    <groupId>mysql</groupId>    </span></li><li style="border: none; list-style: decimal-leading-zero outside; line-height: 13.1999998092651px; margin: 0px !important; padding: 0px 3px 0px 10px !important;"><span style="margin: 0px; padding: 0px; border: none; color: black; background-color: inherit;">    <artifactId>mysql-connector-java</artifactId>    </span></li><li class="alt" style="margin: 0px !important; padding: 0px 3px 0px 10px !important; border: none; list-style: decimal-leading-zero outside; color: inherit; line-height: 13.1999998092651px;"><span style="margin: 0px; padding: 0px; border: none; color: black; background-color: inherit;">   </dependency>    </span></li><li style="border: none; list-style: decimal-leading-zero outside; line-height: 13.1999998092651px; margin: 0px !important; padding: 0px 3px 0px 10px !important;"><span style="margin: 0px; padding: 0px; border: none; color: black; background-color: inherit;"></dependencies>  </span></li></ol></div>

dependencyManagement实际上不会真正引入任何依赖，在子pom中添加之后才会。在父pom中配置了之后，子模块只需使用简单groupId和artifactId就能自动继承相应的父模块依赖配置。如果子pom中定义了version，则覆盖management中的。

三、聚合与继承的关系

区别  ：

1. 对于聚合模块来说，它知道有哪些被聚合的模块，但那些被聚合的模块不知道这个聚合模块的存在。

2. 对于继承关系的父  POM 来说，它不知道有哪些子模块继承与它，但那些子模块都必须知道自己的父  POM 是什么。

共同点  ：

1. 聚合  POM 与继承关系中的父 POM 的  packaging 都是 pom

2. 聚合模块与继承关系中的父模块除了  POM 之外都没有实际的内容。

注：在现有的实际项目中一个 POM既是聚合POM，又是父 POM，这么做主要是为了方便

四、Maven可继承的POM 元素

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