Maven多模块项目架构配置过程及说明

更新时间：2026年06月09日 09:51:58 作者：Mr.D.Chuang

Maven多模块架构配置详解,涵盖项目模块划分、依赖关系配置及pom.xml实操指南,助你高效构建复杂项目

第一步：确定项目的模块划分

模块的划分没有任何强制要求，一般的划分思路如下：

test 集成测试模块：该模块除了测试用例代码外，没有实际业务逻辑。
facade 对外服务接口模块（如果有的话，一般业务类项目较小，服务类较大）：主要是对外提供服务接口、请求参数和返回结果等JAR包，其他项目需要依赖项目JAR包，因此需要单独一个模块
client 集成外部服务接口模块：和facade对应，如果依赖了外部服务的话
lang 基础公用模块：各个模块都会依赖的公共类模块，比如常用工具类、通用枚举等
das 数据访问模块：接入DB层的代码，包括DO/DAO等
service 领域核心服务模块：各个业务领域的核心服务逻辑
web/biz 业务模块：业务逻辑模块。如果业务比较复杂，可进一步拆分，如web-user/web-order等

根据上面说明，模块划分如下：

ntopic-test 集成测试模块
ntopic 业务逻辑模块，包括SpringBoot启动类、Web模块、业务模块等
ntopic-servcie 领域核心服务
ntopic-client 外部服务器集成
ntopic-das DB操作
ntopic-lang 公共模块

第二步：确定各个模块的依赖关系

Maven模块的依赖具备传递性，即：若模块A依赖了模块B，模块B依赖了模块C，则模块A自动依赖了模块C（有点类似于数学中数值大小的传递性，A>B且B>C，则A>C）。

项目的各个模块依赖关系说明：

ntopic-test 集成测试模块：因为集成测试包括了所有的代码逻辑，所以它处于最上层
ntopic 业务模块，业务逻辑依赖service模块提供核心服务
ntopic-service 核心服务模块，它依赖DB数据读写和引入外部服务
ntopic-lang 公共逻辑模块，它进一步依赖其他统一模块，如commons模块等

第三步：Maven多模块实操

多模块的核心在pom.xml文件中，任何一个pom.xml模块，都需要指定五个核心配置元素：

groupId 代表大分组，一般都是公司的域名，如com.aliaba等
artifactId 代表具体的JAR包名，如sequence-jdbc / fastjson等
version 代表JAR包版本，如 1.0.1 / 1.2.76 等
packaging 代表模块打包方式，默认都是jar，对于多模块的总模块或者父模块为pom
name 代表模块名称，可选配置，建议配置

总pom.xml文件

总pom.xml配置了整个项目的所有信息，包括项目的模块列表、依赖的JAR包、仓库和打包方式等。

指定父模块：可选的，可以没有父模块。如ntopic-boot是基于SpringBoot框架，所以它的父模块是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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.5.3</version>
        <relativePath/>
    </parent>
    <groupId>ntopic</groupId>
    <artifactId>ntopic-parent</artifactId>
    <version>1.0.1</version>
    <packaging>pom</packaging>
    <name>ntopic-parent</name>

指定模块本项目的模块列表：

    <modules>
        <module>ntopic-test</module>
        <module>ntopic</module>
        <module>ntopic-service</module>
        <module>ntopic-das</module>
        <module>ntopic-client</module>
        <module>ntopic-lang</module>
    </modules>

模块依赖管理，各个子模块中，可以直接使用这里配置的依赖：

    <dependencyManagement>
      <dependencies>
              <!-- NTopic Modules -->
              <dependency>
                  <groupId>ntopic</groupId>
                  <artifactId>ntopic-lang</artifactId>
                  <version>${ntopic.version}</version>
              </dependency>
              <dependency>
                  <groupId>ntopic</groupId>
                  <artifactId>ntopic-client</artifactId>
                  <version>${ntopic.version}</version>
              </dependency>
        <!-- 其他本项目子模块忽略 -->
        <!-- SpringBoot Starter -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
            <version>${springboot.boot.version}</version>
        </dependency>
        <!--  Google Guava -->
        <dependency>
            <groupId>com.google.guava</groupId>
            <artifactId>guava</artifactId>
            <version>30.1.1-jre</version>
        </dependency>
        <!-- 其他省略 -->
        </dependencies>
    </dependencyManagement>

额外的Maven仓库和打包方式配置：

    <repositories>
        <repository>
            <id>Gitee-obullxl</id>
            <url>https://gitee.com/obullxl/maven-repository/raw/sequence-jdbc</url>
        </repository>
    </repositories>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>${springboot.boot.version}</version>
            </plugin>
        </plugins>
    </build>

子模块pom.xml文件

总模块配置好了之后，子模块的配置就简单多了，只需要配置3个信息块：父模块、四元素和依赖其它子模块。其中依赖的子模块按照第二步中的依赖关系配置即可：

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>ntopic</groupId>
        <artifactId>ntopic-parent</artifactId>
        <version>1.0.1</version>
    </parent>
    <artifactId>ntopic-service</artifactId>
    <packaging>jar</packaging>
    <version>${ntopic.version}</version>
    <name>ntopic-service</name>
    <dependencies>
        <!-- NTopic Module -->
        <dependency>
            <groupId>ntopic</groupId>
            <artifactId>ntopic-das</artifactId>
        </dependency>
        <dependency>
            <groupId>ntopic</groupId>
            <artifactId>ntopic-client</artifactId>
        </dependency>
    </dependencies>
</project>

编译项目各个模块

经过上面的配置，项目Maven多模块架构已经配置完成，进行项目编译即可：

mvn compile

编译成功的结果：

[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] 
[INFO] ntopic-parent ...................................... SUCCESS [  0.022 s]
[INFO] ntopic-lang ........................................ SUCCESS [  0.873 s]
[INFO] ntopic-das ......................................... SUCCESS [  0.121 s]
[INFO] ntopic-client ...................................... SUCCESS [  0.042 s]
[INFO] ntopic-service ..................................... SUCCESS [  0.055 s]
[INFO] ntopic ............................................. SUCCESS [  0.073 s]
[INFO] ntopic-test ........................................ SUCCESS [  0.114 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 2.094 s
[INFO] Finished at: 2023-12-15T19:44:56+09:00
[INFO] Final Memory: 35M/448M
[INFO] ------------------------------------------------------------------------

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

Java Stream 中的sorted 方法实现自定义排序全面解析(推荐)
Java Stream API中的sorted()方法是一个强大的中间操作,它允许我们对流中的元素进行排序,本文将深入探讨如何使用sorted()方法实现自定义排序,涵盖各种常见场景和高级技巧,感兴趣的朋友一起看看吧
2025-11-11
java实现二维码扫码授权登陆
这篇文章主要为大家详细介绍了java实现二维码扫码授权登陆，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2018-10-10
JAVA数组中五种常见排序方法整理汇总
本文给大家分享五种常用的Java数组排序方法整理,每种方法结合示例代码给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧
2025-05-05
Java中JDBC实现动态查询的实例详解
从多个查询条件中随机选择若干个组合成一个DQL语句进行查询，这一过程叫做动态查询。下面通过实例代码给大家讲解JDBC实现动态查询的方法，需要的朋友参考下吧
2017-07-07
Java调用.dll文件的方法
因为项目的需求，要在JAVA项目中调用Windows的Dll(动态链接库)文件，之前用Jni调用过C写的Dll文件，比较麻烦，这里不多说，网上也有很多这方面的文档。在网上找到一个开源的组件JNative，使用后感觉比较方便
2013-04-04
SpringBoot内置tomcat调优测试优化
这篇文章主要介绍了SpringBoot内置tomcat调优测试优化，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2021-04-04
Java重载构造原理与用法详解
这篇文章主要介绍了Java重载构造原理与用法,结合实例形式分析了java可变参数、方法重载、构造器等相关概念、原理及操作注意事项,需要的朋友可以参考下
2020-02-02
Mybatis嵌套子查询动态SQL编写实践
这篇文章主要介绍了Mybatis嵌套子查询动态SQL编写方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2025-05-05
ConcurrentMap.putIfAbsent(key,value)用法实例
这篇文章主要介绍了ConcurrentMap.putIfAbsent(key,value)用法实例，分享了相关代码示例，小编觉得还是挺不错的，具有一定借鉴价值，需要的朋友可以参考下
2018-02-02
MybatisPlus中静态工具DB的实现
本文主要介绍了使用MybatisPlus的Db静态工具类来避免Service之间的循环依赖问题,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2025-12-12