Spring Boot 多模块项目实践

作者 | yizhiwazi

链接 | www.jianshu.com/p/59ceea4f029d

序言：

比起传统复杂的单体工程，使用Maven的多模块配置，可以帮助项目划分模块，鼓励重用，防止POM变得过于庞大，方便某个模块的构建，而不用每次都构建整个项目，并且使得针对某个模块的特殊控制更为方便。

接下来，本文将重点阐述SpringBoot在Maven环境的多模块构建过程。

本项目传送门：

https://github.com/yizhiwazi/springboot-socks/tree/master/springboot-integration

一、创建聚合父工程

1.首先使用 Spring Initializr 来快速创建好一个Maven工程。然后删除无关的文件，只需保留pom.xml 文件。

2.然后在 pom.xml 里面声明该父工程包含的子模块。（其它信息就不逐一讲述了，诸如继承SpringBoot官方父工程以及统一依赖管理 请查看下面的注释说明）

二、创建子模块（module）

注：这里是使用IDEA来创建子模块，使用Eclipse的小伙伴可通过 Spring Initializr 构建，然后复制去进去父工程根目录即可。

对着父工程右键 - New - Module - > 输入 mm-web

对着父工程右键 - New - Module - > 输入 mm-service

对着父工程右键 - New - Module - > 输入 mm-repo

对着父工程右键 - New - Module - > 输入 mm-entity

1~4 步骤完成后，分别调整它们的pom.xml 以继承上面的父工程。

例如mm-web模块的pom.xml 需要改造成这样：

三、编写子模块代码

1.控制层（mm-web）

启动类 ：MmWebApplication.java （mm-web）

控制器：UserController.java （mm-web ）

配置文件：application.yml （mm-web）

2.业务层（mm-service）

实现类：UserServiceImpl.java （mm-service）

3.数据层（mm-repo）

数据层代码：UserRepository.java （mm-repo）

4.mm-entity (实体模型层)

R.java 作为统一返回的Bean对象

三、运行项目

为了更好的学习效果，建议先下载本项目，在IDE运行成功之后，然后再由自己手工敲一遍。

具体步骤：

1.首先下载好 springboot-socks，然后打开springboot-integration 工程。

2.安装Mysql数据库，然后创建数据库socks，并添加表t_user，插入数据如图：

3.配置好整个项目之后，这里只需要运行mm-web模块下的MmWebApplication的启动类就可以了，如正常启动后，访问http://localhost:8080 可查询到用户列表信息。如下图：

四、运维部署（多模块打包）

1.添加打包插件

注意：多模块项目仅仅需要在启动类所在的模块添加打包插件即可！！不要在父类添加打包插件，因为那样会导致全部子模块都使用spring-boot-maven-plugin的方式来打包（例如BOOT-INF/com/hehe/xx），而mm-web模块引入mm-xx 的jar 需要的是裸露的类文件，即目录格式为（/com/hehe/xx）。

本案例的启动模块是 mm-web ， 只需在它的pom.xml 添加打包插件（spring-boot-maven-plugin）:

2.打包工程

首先在IDE打开Maven插件，然后在聚合父工程spring-boot-integration中点击 clean ，然后点击 package 进行打包。如图：

打包效果如下：

打包地址默认在Target目录：

3.启动项目

通过命令行启动项目：

启动效果如下：

（完）

（java思维导图）

我就知道你在看！