Maven 多模块父子工程 (含Spring Boot示例)

 一、为何要用Maven多模块

假设有这样一个项目，很常见的Java Web应用。在这个应用中，咱们分了几层：

• Dao
• Service
• Web

对应的，在一个项目中，咱们会看到一些包名：

• org.xx.app.dao
• org.xx.app.service
• org.xx.app.web
• org.xx.app.util

但随着项目的进行，你可能会遇到以下问题：

1. 这个应用可能须要有一个前台和一个后台管理端，你发现大部分dao，一些service，和大部分util是在两个应用中可。
2. pom.xml中的依赖列表愈来愈长以重用的，可是，因为目前只有一个项目，你不得不新建一个项目依赖这个WAR.
3. build整个项目的时间愈来愈长，尽管你只是一直在web层工做，但你不得不build整个项目。
4. 某个模块，好比util，你只想让一些经验丰富的人来维护，但是，如今这种状况，每一个开发者都能修改，这致使关键模块的代码质量不能达到你的要求。
   

咱们会发现，其实这里实际上没有遵照一个设计模式原则：“高内聚，低耦合”。虽然咱们经过包名划分了层次，而且你还会说，这些包的依赖都是单向的，没有包的环依赖。这很好，但还不够，由于就构建层次来讲，全部东西都被耦合在一块儿了。所以咱们须要使用Maven划分模块。

 

一个简单的Maven模块结构是这样的：

 

---- app-xxx

             |-- pom.xml (pom)

             |

             |-- app-util

             |        |-- pom.xml (jar)

             |

             |-- app-dao

             |        |-- pom.xml (jar)

             |

             |-- app-service

             |        |-- pom.xml (jar)

             |

             |-- app-web

                      |-- pom.xml (war)   

 

 二、 Maven建立多模块聚合项目

1.1 建立父工程

1.以IDEA为示例 (Eclipse大同小异) 选择New--Project

 

 

2.在弹出界面选择Maven, 选择JDK，-->next

 

 3.输入GroupId 和ArtifactId , -->next

 

4.输入完整项目名，和项目保存在本地的路径 ->finish

5.完成以后咱们获得一个新建的maven工程做为咱们的父工程，而后删掉目录下的整个src,获得以下目录

 

1.2 Spring Boot父工程

1. Spring boot在建立单应用项目的时候，有默认的<parent>依赖；咱们在自定义父工程项目时，若是直接以Spring boot的parent做为项目的<parent>父依赖管理的话，子项目会因为存在两个parent而报错，没法导入依赖。
   解决方案以下：

<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-dependencies</artifactId> <version>${spring.boot.version}</version> <type>pom</type> <scope>import</scope> </dependency>

使用spring-boot-dependencies依赖对springboot的依赖包进行统一管理。

 

2. 对于Spring Boot项目，maven父工程项pom.xml咱们须要作的处理

    <modelVersion>4.0.0</modelVersion>
    <!--基本信息-->
    <groupId>com.tan</groupId>
    <artifactId>mtz-manager</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>

    <name>mtz-manager</name>
    <description>mtz-manager管理系统</description>

    <!--定义属性值-->
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
        <spring.boot.version>2.1.1.RELEASE</spring.boot.version>
    </properties>

    <!-- 依赖声明 -->
    <dependencyManagement>
        <dependencies>

            <!-- SpringBoot的依赖配置-->
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${spring.boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>

        </dependencies>
    </dependencyManagement>

    <!--编译管理 jdk版本和字符集编码-->
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>${java.version}</source>
                    <target>${java.version}</target>
                    <encoding>${project.build.sourceEncoding}</encoding>
                </configuration>
            </plugin>
        </plugins>
    </build>

    <!--Maven远程仓库设置 非必要，能够删除-->
    <repositories>
        <repository>
            <id>public</id>
            <name>aliyun nexus</name>
            <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
            <releases>
                <enabled>true</enabled>
            </releases>
        </repository>
    </repositories>

    <!--Maven远程插件库设置 非必要，能够删除-->
    <pluginRepositories>
        <pluginRepository>
            <id>public</id>
            <name>aliyun nexus</name>
            <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </pluginRepository>
    </pluginRepositories>

 

 

到这里父工程建立完成。

2.1 建立子工程

1.建立子工程，咱们先选中父工程目录，而后New-->Model ，在弹出界面直接-->Next

 

3.下一步到这个页面咱们填写子工程名称，而后-->Next

 

 4.根据状况修改如下属性值，而后点击--->finish

5.完成以后咱们子工程就建立成功了，能够看到以下的目录结构

 

而且父工程的pom会自动生成Modules标签及内容，这样就建立了一个有聚合关系的工程了。

 

 完了以后，咱们打开Maven视图，点击一下父工程test看看是否存在错误,如看到如下打印，则表示子工程建立成功。

 

 

2.2 建立Spring Boot子工程

第一步：按照2.1建立完毕子工程。

第二部：咱们以2.1建立的子工程后按照如下进行修改。

 

新建一个mtz-admin模块，以mtz-admin为例,此模块为web模块

1.mtz-admin建立以后，修改mtz-admin的pom.xml添加如下内容

   <dependencies>
        <!-- SpringBoot Web容器 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>

 

2。分别添加application.yml 和 Application.java

 

 

3.完了以后咱们获得一个Spring Boot应用，启动Application，获得以下结果，则表示建立成功完成。