Spring Boot + Maven 多模块项目开发详解

来源：https://www.cnblogs.com/zhizu/p/18323534

在现代软件开发中，模块化开发是一种非常重要的设计思想。它不仅能提高代码的可维护性，还能促进团队协作。今天，我们就来聊聊如何使用 Spring Boot 和 Maven 来构建一个多模块项目。

为什么要使用多模块？

在开始之前，我们先来讨论一下为什么要使用多模块。假设你正在开发一个大型的企业级应用，这个应用可能包含多个功能模块，比如用户管理、订单处理、支付系统等等。如果把所有代码都放在一个项目中，代码量会非常庞大，维护起来也非常困难。而使用多模块的方式，可以将不同的功能模块拆分成独立的子模块，每个子模块负责一个特定的功能，这样不仅代码结构更加清晰，还能提高开发效率。

项目结构

首先，我们来看一下一个典型的 Spring Boot + Maven 多模块项目的结构：

my-multi-module-project
│
├── pom.xml
├── module-a
│   └── pom.xml
├── module-b
│   └── pom.xml
└── module-c
    └── pom.xml

在这个项目结构中，my-multi-module-project 是父项目，module-a、module-b 和 module-c 是子模块。每个子模块都有自己的 pom.xml 文件，而父项目的 pom.xml 文件则负责管理整个项目的依赖和构建配置。

创建父项目

首先，我们需要创建一个父项目。在父项目的 pom.xml 文件中，我们需要定义子模块和一些全局的依赖配置。

<projectxmlns="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.example</groupId>
<artifactId>my-multi-module-project</artifactId>
<version>1.0.0-SNAPSHOT</version>
<packaging>pom</packaging>

<modules>
<module>module-a</module>
<module>module-b</module>
<module>module-c</module>
</modules>

<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>2.5.4</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>

<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>

在这个 pom.xml 文件中，我们定义了三个子模块 module-a、module-b 和 module-c，并且引入了 Spring Boot 的依赖管理。

创建子模块

接下来，我们需要为每个子模块创建 pom.xml 文件。以 module-a 为例：

<projectxmlns="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>

<parent>
<groupId>com.example</groupId>
<artifactId>my-multi-module-project</artifactId>
<version>1.0.0-SNAPSHOT</version>
</parent>

<artifactId>module-a</artifactId>

<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
</dependencies>
</project>

在这个 pom.xml 文件中，我们通过 <parent> 标签指定了父项目，并引入了 Spring Boot 的依赖。

编写代码

现在，我们可以开始编写代码了。以 module-a 为例，我们创建一个简单的 Spring Boot 应用。

首先，在 module-a 中创建一个 Application.java 文件：

package com.example.modulea;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
publicclassApplication {
publicstaticvoidmain(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

接下来，我们在 module-a 中创建一个简单的控制器：

package com.example.modulea.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
publicclassHelloController {

@GetMapping("/hello")
public String sayHello() {
return"Hello from Module A!";
    }
}

运行项目

最后，我们可以通过 Maven 来运行整个项目。在父项目的根目录下执行以下命令：

mvn clean install
mvn spring-boot:run -pl module-a

通过浏览器访问 http://localhost:8080/hello，你应该能看到 "Hello from Module A!" 的输出。

总结

通过这篇文章，我们详细介绍了如何使用 Spring Boot 和 Maven 来构建一个多模块项目。我们从项目结构、父项目配置、子模块配置到代码编写，一步一步地进行了讲解。希望这篇文章能对你有所帮助，让你在实际项目中更加得心应手。

如果你有任何问题或建议，欢迎在评论区留言，我们一起交流学习！

Happy coding!