SpringBoot开发——Maven多模块工程最佳实践及详细示例

一、前言

在大型软件开发项目中，项目模块的划分和管理至关重要。Maven多模块项目架构是一种高效的项目组织方式，通过将项目划分为多个模块，每个模块负责一个特定的功能，可以提高项目的可维护性和可扩展性。本文将详细介绍Maven多模块工程组织的最佳实践，并给出一个详细示例。

二、Maven多模块工程的最佳实践

1、项目结构清晰

• 项目应该按照功能、业务或技术划分模块，每个模块应该有明确的职责和边界，避免功能交叉或耦合过度。
• 项目根目录下通常包含一个父模块（parent），管理整个项目的构建、依赖和版本控制，以及多个子模块（module），每个子模块负责一个具体的功能。

2、依赖管理统一

• 在父模块的pom.xml文件中，通过<dependencyManagement>标签统一声明所有子模块需要的依赖及其版本号，子模块通过继承父模块来简化依赖配置。
• 子模块可以通过<dependencies>标签添加自己特有的依赖，无需重复声明版本号。

3、插件配置统一

• 父模块统一管理构建插件及其配置，确保所有子模块使用相同的构建流程。
• 子模块可以根据需要添加额外的插件或覆盖父模块的插件配置。

4、版本控制一致

• 父模块中定义项目的全局版本号，子模块继承父模块的版本号，确保整个项目的一致性。
• 通过<properties>标签定义项目属性，如Java版本、Spring版本等，子模块可以直接引用这些属性。

5、模块间通信简化

• 使用Maven的模块间依赖机制，子模块可以直接引用其他子模块的代码和资源，简化模块间的通信和协作。
• 通过合理定义和使用模块间的依赖关系，确保模块间的正确交互和协作。

三、详细示例

假设我们有一个多模块项目，包含以下模块：

• parent（父模块）
• module-api（API模块）
• module-service（服务模块）
• module-web（Web模块）

1、项目结构

项目结构如下：

my-multimodule-project/
|-- parent/
|   |-- pom.xml
|-- module-api/
|   |-- pom.xml
|-- module-service/
|   |-- pom.xml
|-- module-web/
    |-- pom.xml

2、父模块（parent）的pom.xml文件

• 在父模块的pom.xml文件中，定义groupId、artifactId和version。
• 使用<packaging>pom</packaging>来指定这是一个聚合项目（即多模块项目）。
• 在<modules>标签中列出所有子模块。

<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.example</groupId>
    <artifactId>my-multimodule-project</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>
    <modules>
        <module>module-api</module>
        <module>module-service</module>
        <module>module-web</module>
    </modules>
    <properties>
        <java.version>1.8</java.version>
        <spring.version>5.3.10</spring.version>
    </properties>
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-core</artifactId>
                <version>${spring.version}</version>
            </dependency>
            <!-- 其他依赖 -->
        </dependencies>
    </dependencyManagement>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <source>${java.version}</source>
                    <target>${java.version}</target>
                </configuration>
            </plugin>
            <!-- 其他插件 -->
        </plugins>
    </build>
</project>

3、子模块（module-api）的pom.xml文件

• 在每个子模块的pom.xml文件中，使用<parent>标签来指定父模块。
• 在<parent>标签中，不需要重复定义groupId和version，因为Maven会自动从父模块中继承这些值。
• 只需要指定父模块的groupId、artifactId和relativePath（如果父模块不在默认位置）。

<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>
    <artifactId>module-api</artifactId>
    <packaging>jar</packaging>
    <parent>
        <groupId>com.example</groupId>
        <artifactId>my-multimodule-project</artifactId>
        <version>1.0-SNAPSHOT</version>
        <!-- 如果父模块不在默认位置，可以指定relativePath -->  
        <!-- <relativePath>../parent/pom.xml</relativePath> -->  
    </parent>
    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
        </dependency>
        <!-- 其他依赖 -->
    </dependencies>
</project>

4、模块间依赖示例

假设module-service模块依赖于module-api模块，可以在module-service的pom.xml文件中添加以下依赖：

<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>  
    <parent>  
        <groupId>com.example</groupId>  
        <artifactId>my-multimodule-project</artifactId>  
        <version>1.0-SNAPSHOT</version>  
        <!-- 如果父模块不在默认位置，可以指定relativePath -->  
        <!-- <relativePath>../parent/pom.xml</relativePath> -->  
    </parent>  
    <artifactId>module-service</artifactId>  
    <packaging>jar</packaging>  
    <!-- 子模块特有的配置，如依赖、插件等 -->  
    <dependencies>  
        <dependency>  
            <groupId>com.example</groupId>  
            <artifactId>module-api</artifactId>  
            <version>${project.version}</version> <!-- 使用${project.version}来引用父模块的version -->  
        </dependency>  
        <!-- 这里可以添加其他依赖 -->  
    </dependencies>  
</project>

在上面的示例中，module-api和module-service子模块都通过<parent>标签继承了父模块my-multimodule-project的groupId和version。这样，你就不需要在每个子模块中重复这些值了。通过上述配置，我们实现了一个清晰、可维护的Maven多模块项目结构。每个模块都有明确的职责和边界，依赖关系通过父模块统一管理，插件配置和版本控制也保持一致。这种项目组织方式有助于提高开发效率，降低维护成本，并方便后续扩展和升级。

四、关于${project.version}

在Maven项目中，${project.version} 是一个内置的Maven属性，它代表了当前项目的版本号。这个属性是在Maven解析pom.xml文件时自动设置的，因此你不需要手动定义它。

当你使用${project.version}时，Maven会用当前项目的版本号来替换这个占位符。这个版本号通常是在项目的pom.xml文件的<version>标签中定义的。

在多模块项目中，如果子模块通过<parent>标签继承了父模块的版本号，那么子模块中的${project.version}将会解析为父模块中定义的版本号（前提是子模块没有覆盖这个版本号）。这是因为Maven在解析子模块的pom.xml时，会首先解析父模块的pom.xml，并将父模块中的信息（包括版本号）传递给子模块。

举个例子，如果你有一个父模块parent-pom，它的版本号是1.0.0，并且有一个子模块child-module，子模块的pom.xml中通过<parent>标签继承了父模块的版本号，那么在子模块的pom.xml中使用${project.version}时，它会被解析为1.0.0。

需要注意的是，虽然${project.version}在大多数情况下都很有用，但在某些情况下（比如父模块和子模块需要不同的版本号时），你可能需要在子模块中显式地定义版本号，而不是使用继承的版本号。此外，如果你在一个模块中引用了另一个模块作为依赖，并且希望确保它们使用相同的版本号，那么使用${project.version}是一个很好的做法，因为它可以确保版本的一致性。