正在加载中，请稍后
author 首页 关于 笔记

按回车搜索更多
SpringBoot 2.x 使用 Maven 新建多模块项目步骤
2020-06-10 阅读 {{counts.readCount}} 评论 {{counts.commentCount}}


前言

通常SpringBoot新建项目，默认是集成了Maven，然后所有内容都在一个主模块中。
如果项目架构稍微复杂一点，就需要用到Maven多模块。
本文简单概述一下，新建一个SpringBoot Maven 多模块项目的流程。
具体内容还需要参考你具体的项目中的实际需求，
我这里只按照大多数通常的情况为准创建一个基础款demo。
另外模块都只基于Maven的默认模板进行创建，
需要SpringBoot是用手动新建文件的方式来实现。

环境:
- Java 1.8
- IntelliJ IDEA 2020.01
- Maven 3.3.9
- SpringBoot 2.2.6.RELEASE
- Mybatis Plus 3.3.1



折腾

第一步 新建一个maven项目

1 新建项目 Create New Project

2 选择Maven 然后直接下一步

3 根据需要修改配置，然后Finish即可

4 直接删除不需要的文件夹和文件，如 src文件夹


第二步 新建子模块

右击项目 -> New -> Module

同样选择Maven 直接下一步 完成

重复以上步骤，建立所有需要的子模块
并删除不需要的文件或文件夹
例如test文件夹


第三步 配置Maven

主项目 pom.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns="http://maven.apache.org/POM/4.0.0"
  3.          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4.          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5.     <modelVersion>4.0.0</modelVersion>
  7.     <groupId>com.demo</groupId>
  8.     <artifactId>modules-demo</artifactId>
  9.     <packaging>pom</packaging>
  10.     <version>1.0.0</version>
  12.     <name>modules-demo</name>
  14.     <parent>
  15.         <groupId>org.springframework.boot</groupId>
  16.         <artifactId>spring-boot-starter-parent</artifactId>
  17.         <version>2.2.6.RELEASE</version>
  18.     </parent>
  20.     <modules>
  21.         <module>module-api</module>
  22.         <module>module-admin</module>
  23.         <module>module-common</module>
  24.     </modules>
  26.     <properties>
  27.         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  28.         <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
  29.         <java.version>1.8</java.version>
  30.         <mysql.version>8.0.19</mysql.version>
  31.         <fastjson.version>1.2.68</fastjson.version>
  32.         <mybatisplus.spring.boot.version>3.3.1</mybatisplus.spring.boot.version>
  33.         <mybatisplus.generator.version>3.3.1</mybatisplus.generator.version>
  34.         <freemarker.version>2.3.30</freemarker.version>
  35.     </properties>
  37.     <dependencies>
  38.         <dependency>
  39.             <groupId>org.springframework.boot</groupId>
  40.             <artifactId>spring-boot-starter-test</artifactId>
  41.             <scope>test</scope>
  42.         </dependency>
  43.         <dependency>
  44.             <groupId>org.springframework.boot</groupId>
  45.             <artifactId>spring-boot-starter-web</artifactId>
  46.         </dependency>
  47.         <dependency>
  48.             <groupId>org.springframework.boot</groupId>
  49.             <artifactId>spring-boot-starter-aop</artifactId>
  50.         </dependency>
  51.         <dependency>
  52.             <groupId>org.springframework</groupId>
  53.             <artifactId>spring-context-support</artifactId>
  54.         </dependency>
  55.         <dependency>
  56.             <groupId>org.springframework.boot</groupId>
  57.             <artifactId>spring-boot-starter-data-redis</artifactId>
  58.         </dependency>
  59.         <dependency>
  60.             <groupId>org.springframework.boot</groupId>
  61.             <artifactId>spring-boot-configuration-processor</artifactId>
  62.             <optional>true</optional>
  63.         </dependency>
  64.         <dependency>
  65.             <groupId>mysql</groupId>
  66.             <artifactId>mysql-connector-java</artifactId>
  67.             <version>${mysql.version}</version>
  68.         </dependency>
  69.         <dependency>
  70.             <groupId>com.alibaba</groupId>
  71.             <artifactId>fastjson</artifactId>
  72.             <version>${fastjson.version}</version>
  73.         </dependency>
  74.         <dependency>
  75.             <groupId>com.baomidou</groupId>
  76.             <artifactId>mybatis-plus-boot-starter</artifactId>
  77.             <version>${mybatisplus.spring.boot.version}</version>
  78.         </dependency>
  79.         <dependency>
  80.             <groupId>com.baomidou</groupId>
  81.             <artifactId>mybatis-plus-generator</artifactId>
  82.             <version>${mybatisplus.generator.version}</version>
  83.         </dependency>
  84.         <dependency>
  85.             <groupId>org.freemarker</groupId>
  86.             <artifactId>freemarker</artifactId>
  87.             <version>${freemarker.version}</version>
  88.         </dependency>
  89.     </dependencies>
  91.     <repositories>
  92.         <repository>
  93.             <id>public</id>
  94.             <name>aliyun nexus</name>
  95.             <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
  96.             <releases>
  97.                 <enabled>true</enabled>
  98.             </releases>
  99.         </repository>
  100.     </repositories>
  101.     <pluginRepositories>
  102.         <pluginRepository>
  103.             <id>public</id>
  104.             <name>aliyun nexus</name>
  105.             <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
  106.             <releases>
  107.                 <enabled>true</enabled>
  108.             </releases>
  109.             <snapshots>
  110.                 <enabled>false</enabled>
  111.             </snapshots>
  112.         </pluginRepository>
  113.     </pluginRepositories>
  114. </project>

工具性质 子项目 pom.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns="http://maven.apache.org/POM/4.0.0"
  3.          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4.          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5.     <parent>
  6.         <artifactId>modules-demo</artifactId>
  7.         <groupId>com.demo</groupId>
  8.         <version>1.0.0</version>
  9.     </parent>
  10.     <modelVersion>4.0.0</modelVersion>
  11.     <artifactId>module-common</artifactId>
  12.     <packaging>jar</packaging>
  13.     <build>
  14.         <finalName>${project.artifactId}</finalName>
  15.     </build>
  16. </project>

接口性质 子项目 pom.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns="http://maven.apache.org/POM/4.0.0"
  3.          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4.          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5.     <parent>
  6.         <artifactId>modules-demo</artifactId>
  7.         <groupId>com.demo</groupId>
  8.         <version>1.0.0</version>
  9.     </parent>
  10.     <modelVersion>4.0.0</modelVersion>
  12.     <artifactId>module-admin</artifactId>
  14.     <build>
  15.         <finalName>${project.artifactId}</finalName>
  16.         <plugins>
  17.             <plugin>
  18.                 <groupId>org.springframework.boot</groupId>
  19.                 <artifactId>spring-boot-maven-plugin</artifactId>
  20.             </plugin>
  21.             <plugin>
  22.                 <groupId>org.apache.maven.plugins</groupId>
  23.                 <artifactId>maven-surefire-plugin</artifactId>
  24.                 <configuration>
  25.                     <skipTests>true</skipTests>
  26.                 </configuration>
  27.             </plugin>
  28.         </plugins>
  29.     </build>
  30. </project>

打包时，工具类的会先生成jar包，并引入到接口类中，接口类再生成war包，可以放Tomcat下运行


第四步 配置SrpingBoot

接口类加入启动类和配置文件

手动创建启动类
ModuleAdminApplication.java

  1. package com.demo.modules.admin;
  3. import org.mybatis.spring.annotation.MapperScan;
  4. import org.springframework.boot.SpringApplication;
  5. import org.springframework.boot.autoconfigure.SpringBootApplication;
  7. @SpringBootApplication
  8. @MapperScan(basePackages = "com.demo.modules.admin.mapper")
  9. public class ModuleAdminApplication {
  11.     public static void main(String[] args) {
  12.         SpringApplication.run(com.demo.modules.admin.ModuleAdminApplication.class, args);
  13.     }
  15. }

ServletInitializer.java

  1. package com.demo.modules.admin;
  3. import org.springframework.boot.builder.SpringApplicationBuilder;
  4. import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;
  6. public class ServletInitializer extends SpringBootServletInitializer {
  8.     @Override
  9.     protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
  10.         return application.sources(ModuleAdminApplication.class);
  11.     }
  13. }

配置文件
application.yml

  1. spring:
  2.   profiles:
  3.     active: dev
  4.   jackson:
  5.     time-zone: GMT+8
  6.     serialization:
  7.       write-dates-as-timestamps: true

application-dev.yml

  1. # 开发环境
  2. server:
  3.   port: 10000
  4.   servlet:
  5.     context-path: /modules/admin/dev
  6. spring:
  7.   servlet:
  8.     multipart:
  9.       max-file-size: 100MB
  10.       max-request-size: 100MB
  11.   datasource:
  12.     driver-class-name: com.mysql.cj.jdbc.Driver
  13.     url: jdbc:mysql://localhost:3306/modules?allowMultiQueries=true&useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai
  14.     username: root
  15.     password: root
  16.   redis:
  17.     database: 9
  18. mybatis-plus:
  19.   mapper-locations: classpath*:/mapper/*.xml
  20.   type-aliases-package: com.demo.modules.admin.serivce
  21.   global-config:
  22.     db-config:
  23.       id-type: auto
  24.       logic-delete-value: 1
  25.       logic-not-delete-value: 0
  26.       insert-strategy: not_null
  27.       update-strategy: not_null
  28.       select-strategy: not_null
  29.     banner: false
  30.   configuration:
  31.     map-underscore-to-camel-case: true
  32.     cache-enabled: true
  33.     call-setters-on-nulls: true
  35. logging:
  36.   file: logs/modules.admin.dev.log
  37.   level.com: debug

application-prod.yml

  1. # 生产环境
  2. server:
  3.   port: 10000
  4.   servlet:
  5.     context-path: /modules/admin/prod
  7. spring:
  8.   jmx:
  9.     enabled: false
  10.   servlet:
  11.     multipart:
  12.       max-file-size: 20MB
  13.       max-request-size: 20MB
  14.   datasource:
  15.     driver-class-name: com.mysql.cj.jdbc.Driver
  16.     url: jdbc:mysql://mysql:3306/modules?allowMultiQueries=true&useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai
  17.     username: root
  18.     password: root
  19.   redis:
  20.     database: 10
  21.     host: redis
  22.     port: 6379
  23.     timeout: 15s
  24.     jedis:
  25.       pool:
  26.         max-active: 1000
  27.         max-wait: -1ms
  28.         min-idle: 4
  29.         max-idle: 20
  30. mybatis-plus:
  31.   mapper-locations: classpath*:/mapper/*.xml
  32.   type-aliases-package: com.demo.modules.admin.serivce
  33.   global-config:
  34.     db-config:
  35.       id-type: auto
  36.       logic-delete-value: 1
  37.       logic-not-delete-value: 0
  38.       insert-strategy: not_null
  39.       update-strategy: not_null
  40.       select-strategy: not_null
  41.     banner: false
  42.   configuration:
  43.     map-underscore-to-camel-case: true
  44.     cache-enabled: true
  45.     call-setters-on-nulls: true
  47. logging:
  48.   file: logs/modules.admin.prod.log
  49.   level.com: warn


第五步 Maven 打包生成war


直接用Idea自带的可视化即可。
先去settings中配置好maven目录

在Maven面板中找到根项目，
选择clean
再选择install
大功告成！



END

最终效果
Gitee: https://gitee.com/tczmh/modules-demo

提交
评论区空空如也，赶紧添加一条评论吧 评论 {{counts.commentCount}}
{{comment.name}} {{comment.os}} {{comment.browser}}
{{dateFormatter(comment.createTime)}}

{{comment.message}}

{{comment.reply.name}} {{comment.reply.os}} {{comment.reply.browser}}
{{dateFormatter(comment.reply.createTime)}}

{{comment.reply.message}}

 zzzmh
关于我 留言板

网址导航
{{alert.message}}
留言板 * 站长不经常查看信箱 若有重要事宜联系邮箱 admin@zzzmh.cn 取消 发送
云朵 ChungZH 起航天空 yiranzai 前端大爆炸 Web前端之家 前端博客 shirmy 小宁博客 pdbn LOGI 鄢云峰 边界AI 京东
Copyright © 2024 上海藏原羚工作室 沪ICP备18011999号 沪公网安备31010602005070号
微信公众号