Spring Boot 如何构建多模块项目
“昨天的 Maven 教程发出来后，就有小伙伴问松哥如何构建 Spring Boot 多模块项目，刚好最近看到一篇讲 Spring Boot 构建多模块项目的文章，觉得还不错，和各位小伙伴分享一下。如果你还不懂普通的多模块项目创建，可以在公众号后台回复 maven ，松哥有完整的教程，另外，公众号后台回复 2TB ，有超 2TB 免费 Java 学习资源。 ”
序言
比起传统复杂的单体工程，使用 Maven 的多模块配置，可以帮助项目划分模块，鼓励重用，防止 POM 变得过于庞大，方便某个模块的构建，而不用每次都构建整个项目，并且使得针对某个模块的特殊控制更为方便。
接下来，本文将重点阐述 SpringBoot 在 Maven 环境的多模块构建过程。
一、创建聚合父工程
1.首先使用 Spring Initializr 来快速创建好一个 Maven 工程。然后删除无关的文件，只需保留 pom.xml 文件。
2.然后在 pom.xml 里面声明该父工程包含的子模块。（其它信息就不逐一讲述了，诸如继承 SpringBoot 官方父工程以及统一依赖管理 请查看下面的注释说明）
<?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">
<!-- 基本信息 -->
<description>SpringBoot 多模块构建示例</description>
<modelVersion>4.0.0</modelVersion>
<name>springboot-integration</name>
<packaging>pom</packaging>
<!-- 项目说明：这里作为聚合工程的父工程 -->
<groupId>com.hehe</groupId>
<artifactId>springboot-integration</artifactId>
<version>1.0.0.RELEASE</version>
<!-- 继承说明：这里继承SpringBoot提供的父工程 -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.5.7.RELEASE</version>
<relativePath/>
</parent>
<!-- 模块说明：这里声明多个子模块 -->
<modules>
<module>mm-web</module>
<module>mm-service</module>
<module>mm-repo</module>
<module>mm-entity</module>
</modules>
<!-- 版本说明：这里统一管理依赖的版本号 -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.hehe</groupId>
<artifactId>mm-web</artifactId>
<version>0.0.1-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>com.hehe</groupId>
<artifactId>mm-service</artifactId>
<version>0.0.1-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>com.hehe</groupId>
<artifactId>mm-repo</artifactId>
<version>0.0.1-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>com.hehe</groupId>
<artifactId>mm-entity</artifactId>
<version>0.0.1-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.42</version>
</dependency>
</dependencies>
</dependencyManagement>
</project>
二、创建子模块（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 需要改造成这样：
<?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">
<modelVersion>4.0.0</modelVersion>
<!-- 基本信息 -->
<groupId>com.hehe</groupId>
<artifactId>mm-web</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>jar</packaging>
<name>mm-web</name>
<!-- 继承本项目的父工程 -->
<parent>
<groupId>com.hehe</groupId>
<artifactId>springboot-integration</artifactId>
<version>1.0.0.RELEASE</version>
</parent>
<!-- Web模块相关依赖 -->
<dependencies>
<dependency>
<groupId>com.hehe</groupId>
<artifactId>mm-service</artifactId>
</dependency>
<dependency>
<groupId>com.hehe</groupId>
<artifactId>mm-entity</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
</project>
三、编写子模块代码
1.控制层（mm-web）
启动类 ：MmWebApplication.java （mm-web）
@SpringBootApplication
public class MmWebApplication {
public static void main(String[] args) {
SpringApplication.run(MmWebApplication.class, args);
}
}
控制器：UserController.java （mm-web ）
@RestController
@RequestMapping("/user/*")
public class UserController {
@Autowired
UserService userService;
@GetMapping("list")
public R list() {
try {
return R.isOk().data(userService.list());
} catch (Exception e) {
return R.isFail(e);
}
}
}
配置文件：application.yml （mm-web）
spring:
datasource:
url: jdbc:mysql://localhost:3306/socks?useSSL=false
username: root
password: root
driver-class-name: com.mysql.jdbc.Driver
2.业务层（mm-service）
实现类：UserServiceImpl.java （mm-service）
@Service
public class UserServiceImpl implements UserService {
@Autowired
UserRepository userRepository;
@Override
public List<User> list() {
return userRepository.findAll();
}
}
3.数据层（mm-repo）
数据层代码：UserRepository.java （mm-repo）
public interface UserRepository extends JpaRepository<User,String> {
}
4.mm-entity (实体模型层)
R.java 作为统一返回的 Bean 对象
public class R<T> implements Serializable {
private static final long serialVersionUID = -4577255781088498763L;
private static final int OK = 0;
private static final int FAIL = 1;
private static final int UNAUTHORIZED = 2;
private T data; //服务端数据
private int status = OK; //状态码
private String msg = ""; //描述信息
//APIS
public static R isOk(){
return new R();
}
public static R isFail(){
return new R().status(FAIL);
}
public static R isFail(Throwable e){
return isFail().msg(e);
}
public R msg(Throwable e){
this.setMsg(e.toString());
return this;
}
public R data(T data){
this.setData(data);
return this;
}
public R status(int status){
this.setStatus(status);
return this;
}
//Constructors
public R() {
}
//Getter&Setters
}
@Entity
@Table(name = "T_USER")
public class User {
@Id
@Column(name = "USERID")
private String userId;
@Column(name = "USERNAME")
private String username;
@Column(name = "PASSWORD")
private String password;
//Getter&Setters
}
三、运行项目
为了更好的学习效果，建议先搭建本项目，在 IDE 运行成功之后，然后再由自己手工敲一遍。具体步骤：
1.首先搭建好 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）:
<!--多模块打包：只需在启动类所在模块的POM文件：指定打包插件 -->
<build>
<plugins>
<plugin>
<!--该插件主要用途：构建可执行的JAR -->
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
2.打包工程
首先在 IDE 打开 Maven 插件，然后在聚合父工程 spring-boot-integration 中点击 clean ，然后点击 package 进行打包。如图：
打包效果如下：
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
[INFO] spring-boot-integration ............................ SUCCESS [ 0.000 s]
[INFO] mm-entity .......................................... SUCCESS [ 1.915 s]
[INFO] mm-repo ............................................ SUCCESS [ 0.235 s]
[INFO] mm-service ......................................... SUCCESS [ 0.218 s]
[INFO] mm-web ............................................. SUCCESS [ 0.891 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 3.798 s
[INFO] Finished at: 2017-10-18T17:17:02+08:00
[INFO] Final Memory: 35M/300M
[INFO] ------------------------------------------------------------------------
打包地址默认在 Target 目录：
3.启动项目
通过命令行启动项目：
xxmm-webtarget>java -jar mm-web-0.0.1-SNAPSHOT.jar
启动效果如下：
本文参与 腾讯云自媒体分享计划，分享自微信公众号。
原始发表：2019-12-05，如有侵权请联系 cloudcommunity@tencent.com 删除
评论
登录后参与评论
推荐阅读
目录