一、为什么要用Maven多模块
假设有这样一个项目,很常见的Java Web应用。在这个应用中,我们分了几层:
- Dao
- Service
- Web
对应的,在一个项目中,我们会看到一些包名:
- org.xx.app.dao
- org.xx.app.service
- org.xx.app.web
- org.xx.app.util
但随着项目的进行,你可能会遇到如下问题:
- 这个应用可能需要有一个前台和一个后台管理端,你发现大部分dao,一些service,和大部分util是在两个应用中可。
- pom.xml中的依赖列表越来越长以重用的,但是,由于目前只有一个项目,你不得不新建一个项目依赖这个WAR.
- build整个项目的时间越来越长,尽管你只是一直在web层工作,但你不得不build整个项目。
- 某个模块,比如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父工程
- 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的依赖包进行统一管理。
- 对于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,得到如下结果,则表示创建成功完成。