maven学习系列6----聚合与继承

聚合

前面也讲过聚合的作用就是把多个模块（maven工程）放在一个模块内部，这个模块就可以说成是一个聚合，单独构建聚合模块就会把聚合在一起的其他模块一起构建（也可以配置只编译其中一部分模块）。聚合模块的packageing必须是POM，聚合模块与被聚合的模块之间的关系如下图。

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

假设聚合模块名为hello，需要聚合的模块名为hello1和hello2两个模块。这里只简单说一下聚合的配置方法，不涉及项目代码。

1，目录结构

说明，这是聚合模块hello的根目录，首先是一个pom.xml配置文件，剩余的每一个目录表示一个maven工程，即需要聚合在一起的模块，如这里的hello1和hello2，其目录结构如下图所示，是一个单独的普通maven工程的目录结构

被聚合的模块放在聚合模块目录下，这个不是必须的，可以放在任何路径下，但是配置聚合模块的pom.xml时就需要配置能访问到被聚合模块的相对路径（被聚合模块相对于聚合模块的路径）了。建议放在聚合模块的根目录下，这样好管理（个人觉得这个有点违反“约定大于配置”的要求）。

2，hello/pom.xml

  4.0.0
  com.itsenlin
  hello
  pom
  0.0.1-SNAPSHOT
  hello Maven app
  
    hello1
    hello2
  

说明

• hello做为聚合模块，packageing类型必须是pom
• 需要聚合的模块名字配置在标签下，一个表示一个模块，配置的是模块的artifactId

3，hello/hello1/pom.xml

  4.0.0
  com.itsenlin
  hello1
  jar
  0.0.1-SNAPSHOT
  hello1 Maven app
  
    ...
  
  
    ...
  
  ....

这个没有什么需要特殊说明的，就是一个普通的maven工程的配置，hello2与hello1配置类似。

继承

也是一种maven工程，主要提取子模块的公共部分，我们称为父模块，减少子模块的重复，也可以统一子模块使用的依赖构件的版本。父模块的packageing必须是POM，父模块与子模块之间的关系如下图。

对于父模块来说，它不知道子模块的存在，而子模块中必须显示配置父模块的信息。

假设hello1和hello2模块有相同的部署需要提取，这样我们就可以创建一个hello-parent的模块当作hello1和hello2的父模块。

1，目录结构

2，hello/pom.xml

修改modules标签如下

    hello-parent
    hello1
    hello2
  

3，hello/hello-parent/pom.xml

  4.0.0
  com.itsenlin
  hello-parent
  pom
  0.0.1-SNAPSHOT
  Parent config of helloN modules

4，hello/hello1/pom.xml

  4.0.0
  
    com.itsenlin
    hello-parent
    0.0.1-SNAPSHOT
    ../hello-parent/pom.xml
  

  hello1
  jar
  hello1 Maven app
  
  
    
        junit
        junit
    
  

说明

• hello2和hello1类似，这里不再列出hello2的pom.xml文件了
• 在子模块中使用标签配置父模块的信息，也即坐标信息
• relativePath表示父模块的POM的相对位置，maven会先根据此配置的路径查找，找不到再从本地仓库中找，如果这个不配置的话需要先将父模块编译好上传到本地仓库才行。
• 子模块可以继承groupId/version，即从一个父模块继承的子模块的groupId和version都一样，所以可以省略
• 可继承的元素还有很多，下面再详细说明。

5，依赖管理

dependencies元素配置项目的依赖信息，这个元素也是可以被继承的，所以父工程中配置了下面的junit依赖的话，所有子工程都会依赖junit

    
        junit
        junit
        4.12
        test
    

但是这样配置有个缺点就是强制所有子工程都得继承此依赖关系，如果我有一个子工程中不想依赖junit的话，这种配置是搞不定的，但是很显然maven已经考虑到这种情况了，可能在父工程中在标签中配置依赖信息，此依赖下的声明不会引入实际的依赖，不过它能够约束dependencies下的依赖使用（主要用于统一版本）。例如

hello/hello-parent/pom.xml中如下配置

  4.0.0
  com.itsenlin
  hello-parent
  pom
  0.0.1-SNAPSHOT
  Parent config of helloN modules
  
    4.12
  
  
      
        
            junit
            junit
            ${junit.version}
            test
        
      
  

说明

properties标签可以实现编程语言中的变量的概念，如这里的junit.version就是一个变量，值为4.12。下面直接使用${junit.version}来获取相应值

假如hello1需要依赖junit，则可以如下配置即可。

  4.0.0
  
    com.itsenlin
    hello-parent
    0.0.1-SNAPSHOT
    ../hello-parent/pom.xml
  

  hello1
  jar
  hello1 Maven app
  
  
    
        junit
        junit
    
  

如果hello2中如果不需要junit的依赖，则把上面配置中的粗体部署的删除即可。

6，import依赖范围

在讲依赖范围的时候讲到maven2.0.9及以后版本引入了一个import的依赖范围。在这里才介绍是因为，这个只在dependencyManagement元素下才有效果。

使用此依赖范围的依赖通常指向一个POM类型的工程。作用是将目标POM中配置的dependencyManagement导入并合并到当前POM的dependencyManagement元素中。

例如下面配置

  
    
        xxxx
        yyyy
        zzzz
        pom
       import
    
  

7，插件管理

类似依赖管理

反应堆

1，概念

反应堆是指所有模块组成的一个构建结构，从模块之间的依赖与继承关系自动计算出合理的模块构建顺序。

2，构建顺序

在命令行下进入hello根目录执行mvn compile，可以看到如下打印

这个顺序并不仅是通过聚合模块的的顺序来定的，而是还要考虑到模块之间的依赖及继承关系来定的。可以把hello模块中的module随意调整顺序，这个构建顺序中有依赖或继承关系的构建顺序是不变的（例如hello1与hello,hello2与hello），其他的工程以module的配置顺序。

3，裁剪反应堆

一般来说直接整个项目构建即可，但是有些场景下也有这样的需求，只构建其中的某些模块，而不是全构建。这就需要使用maven提供的选项来控制了

mvn 

• -h可以查看所有选项的信息
• -am，--also-make 同时构建所列模块的依赖模块，常与-pl选项一起使用
• -amd，-also-make-dependents 同时构建依赖于所列模块的的模块，常与-pl选项一起使用
• -pl，--projects  构建指定的模块，以逗号分隔多个参数
• -rf，--resume-from 从指定的模块回复反应堆

例如

mvn compile -pl hello1,hello2

E:\java_workspace\hello>mvn compile -pl hello1,hello2
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Build Order:
[INFO]
[INFO] hello2 Maven app
[INFO] hello1 Maven app
[INFO]
[INFO] ------------------------------------------------------------------------

mvn compile -pl hello1 -am

E:\java_workspace\hello>mvn compile -pl hello1 -am
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Build Order:
[INFO]
[INFO] Parent config of helloN modules
[INFO] hello1 Maven app
[INFO]
[INFO] ------------------------------------------------------------------------

mvn compile -pl hello-parent -amd

E:\java_workspace\hello>mvn compile -pl hello-parent -amd
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Build Order:
[INFO]
[INFO] Parent config of helloN modules
[INFO] hello2 Maven app
[INFO] hello1 Maven app
[INFO]
[INFO] ------------------------------------------------------------------------

上个命令的构建顺序的基础上使用-rf选项的话，可以指定从某个模块开始构建，例如从hello2开始构建，则会把parent跳过

mvn compile -pl hello-parent -amd -rf hello2

E:\java_workspace\hello>mvn compile -pl hello-parent -amd -rf hello2
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Build Order:
[INFO]
[INFO] hello2 Maven app
[INFO] hello1 Maven app
[INFO]
[INFO] ------------------------------------------------------------------------

附

附1，可依继承的pom元素

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

附2，参考

《maven实战》