Idea创建SpringBoot多模块项目

Idea创建SpringBoot多模块项目

前言

随着项目的复杂度增高，代码也逐渐开始臃肿，工具类的配置、脚手架代码和业务代码耦合，在多端的情况下，需要拆分出像PC后端，APP后端接口的服务，其中有很多相同的方法和逻辑。衍生出了以下几个问题：

• 不同业务间代码耦合，难以区分并定位问题
• 上手难度增加，代码阅读成本高
• 责任界定不明确
• 不能很好地提取出某项功能

若把项目进行拆分，可以很好地解决以上问题，随之带来的就是项目复杂度的上升，今天就来理一理多模块。

什么是多模块

假设我们现在有一个商城的项目，随着业务的发展，开发了商品、库存、订单、购物车等等功能，在Controller层中会越来越多，其中的Service互相依赖，以一个强耦合的形式存在，以至于后期若需要提取商品相关的方法，耦合度太高无法提取。

我们可以定义一个维度，以此来划分模块，例如上述商城、可以划分成商品、库存和订单模块。也可以目录结构分层，Controller层，只不过没人这样做。这样就引申出了下一个问题拆分策略。

下图为谷粒商城项目：

拆分策略

按职责划分

• project
  • module-controller
  • module-service
  • module-dao
  • module-mapper
  • module-entity

按照功能拆分（常用）

• project
  • module-order
  • module-cart
  • module-pay
  • module-product

推荐使用按照功能去拆分，不管是后期维护定位问题或者是改造升级成微服务都是有帮助的。

依赖设计

在maven中存在继承关系，子模块能够继承父pom的一些配置，我们可以通过父类进行通用内容的配置。例如统一版本管理，若需要升级某个jar包，可以及时找到相应的版本进行修改，并且可以通过继承的关系，使使用到的地方同步升级版本。

若需要在某个包中单独使用其他版本的依赖时，只需要在需要更改的pom中添加上相应的版本号，maven会自动根据优先级使用自定义的版本依赖。

除此之外，合理利用依赖，可以是一些公共方法进行公用，例如实体类、redis/mybatis/mq等配置，在公共模块中进行配置，业务模块如有需要进行引入。

eg:

• demo-project
  • demo-common-dependenies
  • demo-common-framwork
  • demo-common-module
  • demo-server

1. demo-project:总项目，把其他模块加入module中，这里不添加实际依赖
2. demo-common-dependenies:整个项目的依赖和版本号，使用dependencyManagement包裹
3. demo-common-framwork:项目的工具配置，例如redis、mybatis等
4. demo-common-module:项目实体类
5. demo-server:业务代码

在这种分层中，server可以是多个，来模拟多端。也可以设计成多个子模块，每个模块根据功能进行划分。

总而言之，目的都是提高复用率，避免重复性设置，公用一套配置，若有特殊需要可以通过配置进行灵活修改即可。

pom

1.demo-project

把其他的module加入pom中，定义依赖版本

    <modules>
        <module>sc-common-dependenciesmodule>
        <module>sc-common-frameworkmodule>
        <module>sc-common-modulemodule>
        <module>sc-servermodule>
    modules>

    <properties>
        <revision>0.0.1-SNAPSHOTrevision>
    properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>top.somliygroupId>
                <artifactId>common-dependenciesartifactId>
                <version>${revision}version>
                <type>pomtype>
                <scope>importscope>
            dependency>
        dependencies>
    dependencyManagement>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

2.demo-common-dependenies

整个项目的版本依赖

    <properties>
        <revision>0.0.1-SNAPSHOTrevision>
        
        <spring.boot.version>2.6.10spring.boot.version>
        
        <lombok.version>1.18.20lombok.version>
        <hutool.version>5.8.5hutool.version>
    properties>

    
    <dependencyManagement>
        <dependencies>
            
            <dependency>
                <groupId>org.springframework.bootgroupId>
                <artifactId>spring-boot-starterartifactId>
                <version>${spring.boot.version}version>
            dependency>

            <dependency>
                <groupId>org.springframework.bootgroupId>
                <artifactId>spring-boot-starter-webartifactId>
                <version>${spring.boot.version}version>
            dependency>

            
            <dependency>
                <groupId>org.projectlombokgroupId>
                <artifactId>lombokartifactId>
                <version>${lombok.version}version>
            dependency>

            <dependency>
                <groupId>cn.hutoolgroupId>
                <artifactId>hutool-allartifactId>
                <version>${hutool.version}version>
            dependency>
        dependencies>
    dependencyManagement>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

3.demo-common-framwork

这里是对系统的一些配置和增强，只需引入一下依赖即可，不需要指定版本号

    <parent>
        <groupId>top.somliy.bootgroupId>
        <artifactId>sc-bootartifactId>
        <version>${revision}version>
    parent>    

	<dependencies>
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starterartifactId>
        dependency>
    dependencies>
1
2
3
4
5
6
7
8
9
10
11
12

4.demo-common-module

系统一些实体，公共的内容存放

    <parent>
        <groupId>top.somliy.bootgroupId>
        <artifactId>sc-bootartifactId>
        <version>${revision}version>
    parent>

    <dependencies>
        <dependency>
            <groupId>org.projectlombokgroupId>
            <artifactId>lombokartifactId>
        dependency>
    dependencies>
1
2
3
4
5
6
7
8
9
10
11
12

5.demo-server

业务系统

    <parent>
        <groupId>top.somliy.bootgroupId>
        <artifactId>sc-bootartifactId>
        <version>${revision}version>
    parent>

    <dependencies>
        <dependency>
            <groupId>top.somliy.bootgroupId>
            <artifactId>sc-common-moduleartifactId>
            <version>${revision}version>
        dependency>
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starterartifactId>
        dependency>
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-webartifactId>
        dependency>
    dependencies>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

搭建多模块项目

环境：idea 2022.1.3

首先创建一个Spring项目

环境：idea 2022.1.3

1.新建一个项目

2.删除无用的文件

3.基于主项目创建子模块

创建的参数与创建SpringBoot一致即可