使用Maven管理聚合项目

概述

当我们的程序有多个模块组成时，我们可以使用Maven来组织聚合我们的项目。

Maven聚合项目可以通过父子继承和模块聚合来实现。

使用Maven来聚合项目，会有一个顶层项目，这个顶层项目并没有实际的业务功能，只是用来组织各个下级的模块项目，并且对项目的依赖插件等进行统一管理。

项目结构

com.study.cloud(顶层项目)
	com.study.cloud.eureka-server
	com.study.cloud.eureka-client-a
	com.study.cloud.zuul-gateway

顶层项目pom.xml解析

下面是一个顶层项目的pom文件，并做了一些解析

<?xml version="1.0" encoding="UTF-8"?>
<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/xsd/maven-4.0.0.xsd">
    <!--顶层项目可以继承其他项目，它的子项目也会有该继承关系-->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.0.RELEASE</version>
    </parent>

    <modelVersion>4.0.0</modelVersion>

    <groupId>com.study</groupId>
    <artifactId>cloud</artifactId>
    <packaging>pom</packaging><!--顶层项目的打包方式必须是pom-->
    <version>1.0-SNAPSHOT</version><!--子项目不需要再声明version，均以顶层项目的version为准-->
    <!--modules中配置的是该顶层项目要聚合的各个模块，需要注意的module中的内容其实是路径，这里配置的格式是被聚合的项目路径在顶层项目里面，如果被聚合的项目路径在其它位置，需要相应的修改module的内容，例如与顶层项目平级，则需要修改为"../eureka-server"-->
    <modules>
        <module>eureka-server</module>
        <module>eureka-client-a</module>
        <module>zuul-gateway</module>
    </modules>
	
    <!--dependencyManagement是用来管理项目中的依赖的，在顶层项目的dependencyManagement中生命了依赖后，在其子项目中使用该依赖时则不需要再声明版本，从而统一管理项目中的依赖，当子项目中也声明了版本，则会以子项目中声明的版本为准-->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-starter-netflix-zuul</artifactId>
                <version>2.0.0.RELEASE</version>
            </dependency>
            <dependency>
                <groupId>org.glassfish</groupId>
                <artifactId>javax.activation</artifactId>
                <version>10.0-b28</version>
            </dependency>
            ...
        </dependencies>
    </dependencyManagement>

    <build>
        <!--pluginManagement的作用与dependencyManagement类似，用于统一管理插件，当在顶层项目pluginManagement中声明配置后，子项目需要使用时不再需要重复配置，直接引用即可-->
        <pluginManagement>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <configuration>
                        <source>10</source>
                        <target>10</target>
                    </configuration>
                </plugin>
            </plugins>
        </pluginManagement>
    </build>
</project>

子项目pom.xml解析

下面是一个子项目的pom文件

<?xml version="1.0" encoding="UTF-8"?>
<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/xsd/maven-4.0.0.xsd">
    <!--继承顶层项目-->
    <parent>
        <artifactId>cloud</artifactId>
        <groupId>com.study</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>

    <modelVersion>4.0.0</modelVersion>

    <artifactId>eureka-server</artifactId>

    <!--这里是该子项目实际需要使用的依赖，因为在顶层项目中已经声明了，所以这里不再需要写版本-->
    <dependencies>
        <dependency>
            <groupId>org.glassfish</groupId>
            <artifactId>javax.activation</artifactId>
        </dependency>
        <dependency>
            <groupId>org.glassfish.jaxb</groupId>
            <artifactId>jaxb-runtime</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
            <!--这里是该子项目实际需要使用的插件，因为在顶层项目中已经声明配置了，所以这里不再需要写详细的配置-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

项目打包

打包项目时只需要在顶层项目中执行packing即可将整个项目打包，如果子项目有相互依赖的需要install将被引用的子项目安装进maven的本地仓库中，安装后所有项目都可以引用该项目。