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

聚合

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


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


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

1,目录结构


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

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

2,hello/pom.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 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.itsenlin</groupId>
  <artifactId>hello</artifactId>
  <strong><packaging>pom</packaging></strong>
  <version>0.0.1-SNAPSHOT</version>
  <name>hello Maven app</name>
<strong>  <modules>
    <module>hello1</module>
    <module>hello2</module>
  </modules></strong>
</project>
说明

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

3,hello/hello1/pom.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 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.itsenlin</groupId>
  <artifactId>hello1</artifactId>
  <packaging>jar</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>hello1 Maven app</name>
  <dependencies>
    ...
  </dependencies>
  <build>
    ...
  </build>
  ....
</project>

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

继承

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


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

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

1,目录结构


2,hello/pom.xml

修改modules标签如下

<modules>
    <strong><module>hello-parent</module></strong>
    <module>hello1</module>
    <module>hello2</module>
  </modules>

3,hello/hello-parent/pom.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 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.itsenlin</groupId>
  <artifactId>hello-parent</artifactId>
  <strong><packaging>pom</packaging></strong>
  <version>0.0.1-SNAPSHOT</version>
  <name>Parent config of helloN modules</name>
</project>

4,hello/hello1/pom.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 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
<strong>  <parent>
    <groupId>com.itsenlin</groupId>
    <artifactId>hello-parent</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <relativePath>../hello-parent/pom.xml</relativePath>
  </parent></strong>

  <artifactId>hello1</artifactId>
  <packaging>jar</packaging>
  <name>hello1 Maven app</name>
  
  <dependencies>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
    </dependency>
  </dependencies>
</project>
说明

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


5,依赖管理

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

<dependencies>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
        <scope>test</scope>
    </dependency>
</dependencies>

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

hello/hello-parent/pom.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 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.itsenlin</groupId>
  <artifactId>hello-parent</artifactId>
  <packaging>pom</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>Parent config of helloN modules</name>
<strong>  <properties>
    <junit.version>4.12</junit.version>
  </properties>
  <dependencyManagement>
      <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>${junit.version}</version>
            <scope>test</scope>
        </dependency>
      </dependencies>
  </dependencyManagement></strong>
</project>
说明

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

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

<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 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>com.itsenlin</groupId>
    <artifactId>hello-parent</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <relativePath>../hello-parent/pom.xml</relativePath>
  </parent>

  <artifactId>hello1</artifactId>
  <packaging>jar</packaging>
  <name>hello1 Maven app</name>
  
<strong>  <dependencies>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
    </dependency>
  </dependencies></strong>
</project>
如果hello2中如果不需要junit的依赖,则把上面配置中的粗体部署的<dependency>删除即可。

6,import依赖范围

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

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

例如下面配置

<dependencyManagement>
  <dependencies>
    <dependency>
        <groupId>xxxx</groupId>
        <artifactId>yyyy</artifactId>
        <version>zzzz</version>
        <strong><type>pom</type>
       <scope>import</scope></strong>
    </dependency>
  </dependencies>
</dependencyManagement>

7,插件管理

类似依赖管理


反应堆

1,概念

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

2,构建顺序

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



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

3,裁剪反应堆

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

mvn 

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

例如

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实战》

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值