Maven聚合与继承
一、聚合
- <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>
二、继承
可声明父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>
三、聚合与继承的关系

- groupId :项目组 ID ,项目坐标的核心元素;
- version :项目版本,项目坐标的核心元素;
- description :项目的描述信息;
- organization :项目的组织信息;
- inceptionYear :项目的创始年份;
- url :项目的 url 地址
- develoers :项目的开发者信息;
- contributors :项目的贡献者信息;
- distributionManagerment :项目的部署信息;
- issueManagement :缺陷跟踪系统信息;
- ciManagement :项目的持续继承信息;
- scm :项目的版本控制信息;
- mailingListserv :项目的邮件列表信息;
- properties :自定义的 Maven 属性;
- dependencies :项目的依赖配置;
- dependencyManagement :醒目的依赖管理配置;
- repositories :项目的仓库配置;
- build :包括项目的源码目录配置、输出目录配置、插件配置、插件管理配置等;
- reporting :包括项目的报告输出目录配置、报告插件配置等。
Maven - 继承和聚合
*聚合(多模块)
在一个项目中 往往有多个模块组成 例如有项目demo 下面有a, b两个模块
为了能使用一条命令就能构建demo-a, demo-b两个模块, 需要创建一个额外的聚合模块, 然后通过该模块构建整个项目的所有模块。
聚合模块(demo-parent) pom:
- <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.x.demo</groupId>
- <artifactId>demo-parent</artifactId>
- <packaging>pom</packaging>
- <version>0.0.1-SNAPSHOT</version>
- <name>demo-parent Maven Webapp</name>
- <url>http://maven.apache.org</url>
- <modules>
- <module>../demo-a</module>
- <module>../demo-b</module>
- </modules>
- </project>
模块a(demo-a) pom:
- <project xmlns="<a href="http://maven.apache.org/POM/4.0.0">http://maven.apache.org/POM/4.0.0</a>" xmlns:xsi="<a href="http://www.w3.org/2001/XMLSchema-instance">http://www.w3.org/2001/XMLSchema-instance</a>"
- xsi:schemaLocation="<a href="http://maven.apache.org/POM/4.0.0">http://maven.apache.org/POM/4.0.0</a> <a href="http://maven.apache.org/maven-v4_0_0.xsd">http://maven.apache.org/maven-v4_0_0.xsd</a>">
- <modelVersion>4.0.0</modelVersion>
- <groupId>com.x.demo</groupId>
- <artifactId>demo-a</artifactId>
- <packaging>jar</packaging>
- <version>0.0.1-SNAPSHOT</version>
- <name>demo-a Maven Webapp</name>
- <url>http://maven.apache.org</url>
- <dependencies>
- <dependency>
- <groupId>junit</groupId>
- <artifactId>junit</artifactId>
- <version>3.8.1</version>
- <scope>test</scope>
- </dependency>
- </dependencies>
- <build>
- <finalName>demo-a</finalName>
- </build>
- </project>
模块b(demo-b) pom:
- <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.x.demo</groupId>
- <artifactId>demo-b</artifactId>
- <packaging>jar</packaging>
- <version>0.0.1-SNAPSHOT</version>
- <name>demo-b Maven Webapp</name>
- <url>http://maven.apache.org</url>
- <dependencies>
- <dependency>
- <groupId>junit</groupId>
- <artifactId>junit</artifactId>
- <version>3.8.1</version>
- <scope>test</scope>
- </dependency>
- </dependencies>
- <build>
- <finalName>demo-b</finalName>
- </build>
- </project>
额外模块(demo-parent) pom中的modules节点有多个module,每个module的值都是一个被聚合模块的相对目录。
关于聚合模块目录与其他模块的目录主要有两种形式:
a.父子关系:
父子关系 聚合模块的pom:
- <modules>
- <module>demo-a</module>
- <module>demo-b</module>
- </modules>
a.平行目录:
平行目录 聚合模块的pom:
- <modules>
- <module>../demo-a</module>
- <module>../demo-b</module>
- </modules>
最后在聚合模块(demo-parent)的pom上面 运行mvn命令 根据聚合顺序依次构建多个模块。
*继承
上面的例子中, a,b两个模块都依赖junit, 为了消除重复,可以使用pom的继承,以达到一处声明,多处使用的目的。
聚合模块(demo-parent) pom:
- <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.x.demo</groupId>
- <artifactId>demo-parent</artifactId>
- <packaging>pom</packaging>
- <version>0.0.1-SNAPSHOT</version>
- <name>demo-parent Maven Webapp</name>
- <url>http://maven.apache.org</url>
- <dependencies>
- <dependency>
- <groupId>junit</groupId>
- <artifactId>junit</artifactId>
- <version>3.8.1</version>
- <scope>test</scope>
- </dependency>
- </dependencies>
- <modules>
- <module>../demo-a</module>
- <module>../demo-b</module>
- </modules>
- </project>
模块a(demo-a) pom:
- <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.x.demo</groupId>
- <artifactId>demo-parent</artifactId>
- <version>0.0.1-SNAPSHOT</version>
- <relativePath>../demo-parent/pom.xml</relativePath>
- </parent>
- <artifactId>demo-a</artifactId>
- <name>demo-a Maven Webapp</name>
- <build>
- <finalName>demo-a</finalName>
- </build>
- </project>
模块b(demo-b) pom:
- <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.x.demo</groupId>
- <artifactId>demo-parent</artifactId>
- <version>0.0.1-SNAPSHOT</version>
- <relativePath>../demo-parent/pom.xml</relativePath>
- </parent>
- <artifactId>demo-b</artifactId>
- <name>demo-a Maven Webapp</name>
- <build>
- <finalName>demo-b</finalName>
- </build>
- </project>
parent元素声明父模块,parent下的子节点groupId,artifactId,version指定父模块的坐标,这三个元素是必须的。
节点relativePath指定父模块pom的路径,默认值是:../pom.xml,也就是说父pom在上一层目录,(<relativePath>../demo-parent/pom.xml</relativePath> 表示父模块pom和子模块是平行目录)
可以被继承的POM元素:
groupId:项目id,项目坐标的核心元素
version:项目版本,项目坐标的核心元素
description:项目描述信息
organization:项目组织信息
inceptionYear:项目创世年月
developers:项目开发者信息
contributors:项目贡献者信息
distributionManagement:项目部署配置
scm:项目的版本控制信息
mailingLists:项目邮件列表信息
properties:自定义的属性
dependencies:项目的依赖配置
dependencyManagement:项目的依赖管理配置
repositories:项目的仓库配置
build:项目源码目录配置。输出目录配置,插件配置等。
*依赖管理
父模块(demo-parent) pom:
- <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.x.demo</groupId>
- <artifactId>demo-parent</artifactId>
- <packaging>pom</packaging>
- <version>0.0.1-SNAPSHOT</version>
- <name>demo-parent Maven Webapp</name>
- <url>http://maven.apache.org</url>
- <!-- dependencyManagement 定义的依赖 需要在子pom中声明 不然不会产生效果 -->
- <dependencyManagement>
- <dependencies>
- <dependency>
- <groupId>junit</groupId>
- <artifactId>junit</artifactId>
- <version>3.8.1</version>
- <scope>test</scope>
- </dependency>
- </dependencies>
- </dependencyManagement>
- <modules>
- <module>../demo-a</module>
- <module>../demo-b</module>
- </modules>
- </project>
模块a(demo-a) pom:
- <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.x.demo</groupId>
- <artifactId>demo-parent</artifactId>
- <version>0.0.1-SNAPSHOT</version>
- <relativePath>../demo-parent/pom.xml</relativePath>
- </parent>
- <artifactId>demo-a</artifactId>
- <name>demo-a Maven Webapp</name>
- <properties>
- <mail.version>1.4.1</mail.version>
- </properties>
- <dependencies>
- <!-- 声明父pom中的依赖 这样才会真正被使用 -->
- <dependency>
- <groupId>junit</groupId>
- <artifactId>junit</artifactId>
- </dependency>
- <!-- 扩展依赖 父pom中并没有声明 不会影响到父POM 和其他模块 -->
- <dependency>
- <groupId>javax.mail</groupId>
- <artifactId>mail</artifactId>
- <version>${mail.version}</version>
- </dependency>
- </dependencies>
- <build>
- <finalName>demo-a</finalName>
- </build>
- </project>
- <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.x.demo</groupId>
- <artifactId>demo-parent</artifactId>
- <version>0.0.1-SNAPSHOT</version>
- <relativePath>../demo-parent/pom.xml</relativePath>
- </parent>
- <artifactId>demo-b</artifactId>
- <name>demo-a Maven Webapp</name>
- <!-- 没有声明父pom中的依赖 不会被使用 -->
- <build>
- <finalName>demo-b</finalName>
- </build>
- </project>
父POM 中使用dependencyManagement 声明的依赖不会给子模块引入依赖, 只会继承这段配置。
在模块a(demo-a) pom中声明了父pom中junit依赖 在执行的时候才会获得真正的依赖信息。
模块b(demo-b) pom中没有声明父pom中junit依赖 不会产生实际效果。