SpringBoot2.x总结——多模块项目实践（附打包方法）

最新推荐文章于 2022-09-24 15:24:11 发布
最新推荐文章于 2022-09-24 15:24:11 发布
阅读量821 收藏 2
点赞数
分类专栏： Springboot
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Mango_hc/article/details/103052249
版权

文章目录

序言：

比起传统复杂的单体工程，使用Maven的多模块配置，可以帮助项目划分模块，鼓励重用，防止POM变得过于庞大，方便某个模块的构建，而不用每次都构建整个项目，并且使得针对某个模块的特殊控制更为方便。

接下来，本文将重点阐述SpringBoot在Maven环境的多模块构建过程。

一、创建聚合父工程

1.首先使用 Spring Initializr 来快速创建好一个Maven工程。然后删除无关的文件，只需保留pom.xml 文件。

在这里插入图片描述
2.然后在 pom.xml 里面声明该父工程包含的子模块。（其它信息就不逐一讲述了，诸如继承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 http://maven.apache.org/xsd/maven-4.0.0.xsd">

    <!-- 基本信息 -->
    <description>SpringBoot 多模块构建示例</description>
    <modelVersion>4.0.0</modelVersion>
    <name>springboot-integration</name>
    <packaging>pom</packaging>

    <!-- 项目说明：这里作为聚合工程的父工程 -->
    <groupId>com.hehe</groupId>
    <artifactId>springboot-integration</artifactId>
    <version>1.0.0.RELEASE</version>

    <!-- 继承说明：这里继承SpringBoot提供的父工程 -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.7.RELEASE</version>
        <relativePath/>
    </parent>

    <!-- 模块说明：这里声明多个子模块 -->
    <modules>
        <module>mm-web</module>
        <module>mm-service</module>
        <module>mm-repo</module>
        <module>mm-entity</module>
    </modules>

    <!-- 版本说明：这里统一管理依赖的版本号 -->
    <dependencyManagement>
        <dependencies>

            <dependency>
                <groupId>com.hehe</groupId>
                <artifactId>mm-web</artifactId>
                <version>0.0.1-SNAPSHOT</version>
            </dependency>
            <dependency>
                <groupId>com.hehe</groupId>
                <artifactId>mm-service</artifactId>
                <version>0.0.1-SNAPSHOT</version>
            </dependency>
            <dependency>
                <groupId>com.hehe</groupId>
                <artifactId>mm-repo</artifactId>
                <version>0.0.1-SNAPSHOT</version>
            </dependency>
            <dependency>
                <groupId>com.hehe</groupId>
                <artifactId>mm-entity</artifactId>
                <version>0.0.1-SNAPSHOT</version>
            </dependency>

            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <version>5.1.42</version>
            </dependency>
        </dependencies>
    </dependencyManagement>

</project>

二、创建子模块（module）

注：这里是使用IDEA来创建子模块，使用Eclipse的小伙伴可通过 Spring Initializr 构建，然后复制去进去父工程根目录即可。

  1. 右键父工程 - New - Module - > 输入 mm-web
  2. 右键父工程 - New - Module - > 输入 mm-service
  3. 右键父工程 - New - Module - > 输入 mm-repo
  4. 右键父工程 - New - Module - > 输入 mm-entity

1~4 步骤完成后，分别对应调整它们的pom.xml 以继承父工程。

<?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>

    <!-- 基本信息 -->
    <groupId>com.hehe</groupId>
    <artifactId>mm-web</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>
    <name>mm-web</name>

    <!-- 继承本项目的父工程 -->
    <parent>
        <groupId>com.hehe</groupId>
        <artifactId>springboot-integration</artifactId>
        <version>1.0.0.RELEASE</version>
    </parent>

    <!-- Web模块相关依赖 -->
    <dependencies>
        <dependency>
            <groupId>com.hehe</groupId>
            <artifactId>mm-service</artifactId>
        </dependency>
        <dependency>
            <groupId>com.hehe</groupId>
            <artifactId>mm-entity</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <!--多模块打包：只需在启动类所在模块的POM文件：指定打包插件 -->
    <build>
        <plugins>
            <plugin>
                <!--该插件主要用途：构建可执行的JAR -->
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

<?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>
    <!-- 基本信息 -->
    <groupId>com.hehe</groupId>
    <artifactId>mm-service</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>
    <name>mm-service</name>

    <!-- 继承本项目的父工程 -->
    <parent>
        <groupId>com.hehe</groupId>
        <artifactId>springboot-integration</artifactId>
        <version>1.0.0.RELEASE</version>
    </parent>

    <!-- Service模块相关依赖 -->
    <dependencies>
        <dependency>
            <groupId>com.hehe</groupId>
            <artifactId>mm-entity</artifactId>
        </dependency>
        <dependency>
            <groupId>com.hehe</groupId>
            <artifactId>mm-repo</artifactId>
        </dependency>
    </dependencies>

</project>

<?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>
    <!-- 基本信息 -->
    <groupId>com.hehe</groupId>
    <artifactId>mm-repo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>
    <name>mm-repo</name>

    <!-- 继承本项目的父工程 -->
    <parent>
        <groupId>com.hehe</groupId>
        <artifactId>springboot-integration</artifactId>
        <version>1.0.0.RELEASE</version>
    </parent>

    <!-- Repo模块相关依赖 -->
    <dependencies>
        <dependency>
            <groupId>com.hehe</groupId>
            <artifactId>mm-entity</artifactId>
        </dependency>

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>

    </dependencies>

</project>

<?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>
    <!-- 基本信息 -->
    <groupId>com.hehe</groupId>
    <artifactId>mm-entity</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>
    <name>mm-entity</name>

    <!-- 继承本项目的父工程 -->
    <parent>
        <groupId>com.hehe</groupId>
        <artifactId>springboot-integration</artifactId>
        <version>1.0.0.RELEASE</version>
    </parent>

    <!-- Entity模块相关依赖 -->
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
    </dependencies>


</project>

三、编写子模块代码

1.控制层（mm-web）

在这里插入图片描述
启动类 ：MmWebApplication.java （mm-web）

package com.hehe.integration;

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

/**
 * @Author: haocheng
 * @Date: 2019-11-13 17:03
 */
@SpringBootApplication
public class MmWebApplication {

    public static void main(String[] args) {
        SpringApplication.run(MmWebApplication.class, args);
    }

}

控制层：UserController.java （mm-web ）

package com.hehe.integration.user;

import com.hehe.integration.common.R;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * @Author: haocheng
 * @Date: 2019-11-13 17:03
 */
@RestController
@RequestMapping("/user/*")
public class UserController {

    @Autowired
    UserService userService;

    @GetMapping("list")
    public R list() {
        try {
            return R.isOk().data(userService.list());
        } catch (Exception e) {
            return R.isFail(e);
        }
    }
}

配置文件：application.yml （mm-web）

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/socks?useSSL=false
    username: root
    password: root
    driver-class-name: com.mysql.jdbc.Driver

2.业务层（mm-service）

在这里插入图片描述
接口：UserService（mm-service）

package com.hehe.integration.user;

import java.util.List;

/**
 * @Author: haocheng
 * @Date: 2019-11-13 17:07
 */
public interface UserService {
    List<User> list();
}

实现类：UserServiceImpl （mm-service）

package com.hehe.integration.user;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

/**
 * @Author: haocheng
 * @Date: 2019-11-13 17:07
 */
@Service
public class UserServiceImpl  implements UserService {

    @Autowired
    UserRepository userRepository;

    @Override
    public List<User> list() {
        return userRepository.findAll();
    }
}

3.数据持久层（mm-repo）

在这里插入图片描述
数据层：UserRepository.java （mm-repo）

package com.hehe.integration.user;

import org.springframework.data.jpa.repository.JpaRepository;

/**
 * @Author: haocheng
 * @Date: 2019-11-13 17:09
 */
public interface UserRepository extends JpaRepository<User,String> {
}

4. 实体模型层 (mm-entity)

在这里插入图片描述
Result.java 封装统一返回的Bean对象

package com.hehe.integration.common;

import java.io.Serializable;

/**
 * @Author: haocheng
 * @Date: 2019-11-13 17:11
 */
public class Result<T> implements Serializable {

    private static final long serialVersionUID = -4577255781088498763L;
    private static final int OK = 0;
    private static final int FAIL = 1;
    private static final int UNAUTHORIZED = 2;

    private T data; //服务端数据
    private int status = OK; //状态码
    private String msg = ""; //描述信息

    //APIS
    public static Result isOk(){
        return new Result();
    }
    public static Result isFail(){
        return new Result().status(FAIL);
    }
    public static Result isFail(Throwable e){
        return isFail().msg(e);
    }
    public Result msg(Throwable e){
        this.setMsg(e.toString());
        return this;
    }
    public Result data(T data){
        this.setData(data);
        return this;
    }
    public Result status(int status){
        this.setStatus(status);
        return this;
    }


    //Constructors
    public Result() {

    }

    //Getter&Setters

    public T getData() {
        return data;
    }

    public void setData(T data) {
        this.data = data;
    }

    public int getStatus() {
        return status;
    }

    public void setStatus(int status) {
        this.status = status;
    }

    public String getMsg() {
        return msg;
    }

    public void setMsg(String msg) {
        this.msg = msg;
    }
}

package com.hehe.integration.user;

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.Table;

/**
 * @Author: haocheng
 * @Date: 2019-11-13 17:12
 */
@Entity
@Table(name = "user")
public class User {

    @Id
    @Column(name = "user_id")
    private String userId;
    @Column(name = "user_name")
    private String userName;
    @Column(name = "password")
    private String password;

    //Getter&Setters

    public String getUserId() {
        return userId;
    }

    public void setUserId(String userId) {
        this.userId = userId;
    }

    public String getUserName() {
        return userName;
    }

    public void setUserName(String userName) {
        this.userName = userName;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }
}

三、运行项目

只需要运行mm-web模块下的MmWebApplication的启动类就可以了，如正常启动后，访问http://localhost:8080 可查询到用户列表信息。
在这里插入图片描述

四、运维部署（多模块打包）

1.添加打包插件

注意：多模块项目仅仅需要在启动类所在的模块添加打包插件即可！！不要在父类添加打包插件，因为那样会导致全部子模块都使用spring-boot-maven-plugin的方式来打包（例如BOOT-INF/com/hehe/xx），而mm-web模块引入mm-xx 的jar 需要的是裸露的类文件，即目录格式为（/com/hehe/xx）。

本案例的启动模块是 mm-web ， 只需在它的pom.xml 添加打包插件（spring-boot-maven-plugin）:

<!--多模块打包：只需在启动类所在模块的POM文件：指定打包插件 -->
    <build>
        <plugins>
            <plugin>
                <!--该插件主要用途：构建可执行的JAR -->
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

2.打包工程

首先在IDE打开Maven插件视图，然后在聚合父工程spring-boot-integration中先点击 clean ，然后点击 package 进行打包。如图：
在这里插入图片描述
打包成功效果如下：
在这里插入图片描述
打包地址默认在Target目录：
在这里插入图片描述

3.启动项目

cmd命令模式下，切换到jar包所在路径，执行命令 java -jar mm-web-0.0.1-SNAPSHOT.jar

启动效果如下：在这里插入图片描述

参考：http://www.jianshu.com/p/59ceea4f029d

Since-23
关注
  • 0
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Spring Boot 2.X - 多模块项目搭建
XUDC的程序人生
12-29 603
Spring Boot 2 多模块项目搭建 新建一个Maven父项目spring-boot-parent,继承spring-boot-starter-parent, &amp;lt;parent&amp;gt; &amp;lt;groupId&amp;gt;org.springframework.boot&amp;lt;/groupId&amp;gt; &amp;lt;artifactId&amp
IntelliJ IDEA Spring Boot 2.x 多模块项目创建
chouyuanchao1799的博客
07-16 115
在学习Spring Boot 2的时候顺便来学习创建下Maven下的多模块项目创建。方便学习使用整套开发流程。 第一步，检查IDEA，新版本的IDEA可能没有Spring Assistant可通过插件安装(Preferences->Plugins,搜索进行安装) 第二步，创...
spring boot 2.0多模块搭建
anyeoo的博客
06-29 1684
开发工具用idea，用maven管理jar: 1.创建父级模块：file-new-project-maven-next，直接上图，项目名字包路径可修改，打包方式pom，具体配置最后贴上 2.创建子模块，右键父模块new-Module,(web模块与其他模块有区别)，先web模块创建new-Module-spring initializr-next 2.1这里可以选适合...
SpringBoot入门之二 多模块构建
技术宅男改变世界
03-04 204
0.学习目标 常见企业项目模块结构 了解SpringBoot的配置 了解SpringBoot启动方式 了解SpringBoot热部署 常见企业项目模块结构 1.1.构建SpringMVC模块结构 ，常见 web+service+model项目结构 1.1.1 创建 项目 spring-boot-teach2-parent 在项目根目录创建pom.xml，内容如下 <?xml ve...
SpringBoot使用Maven建立多模块工程(二)
小小默：进无止境
08-10 1330
项目多模块似乎已经很常见了，这里分享一下多模块构建过程。 环境：idea+SpringBoot2.0。 目标：父工程(打包pom)，子工程(api-jar包，让web工程依赖)、子工程(hh-pojo-jar,让web工程依赖)以及web主工程(打war包)。 基本上本篇博客是在上一篇博文的基础上继续进行拓展。 【1】创建hh-pojo项目 步骤：父工程右键 – new Modu...
springBoot 2.0开发构建多模块应用及项目打包（IDEA工具）开发源码
03-26
springBoot 2.0开发构建多模块应用及使用Maven进行项目打包。 1. 定义用户模型：ID、名称 2. 客户端发送 POST 请求，创建用户（Web MVC形式） 3. 客户端发送 GET 请求，获取所有用户（Web Flux形式——Spring...
mall项目是一套电商系统基于SpringBoot+MyBatis实现.zip
08-05
《基于SpringBoot+MyBatis实现的电商系统——Mall项目解析》 在当今的互联网时代，电商系统已经成为企业不可或缺的一部分。本篇将详细介绍一款名为"Mall"的电商系统，该系统采用SpringBoot和MyBatis框架进行开发，...
java面试——SpringBoot面试专题.zip
09-26
- **自动配置（Auto Configuration）**：Spring Boot根据项目类路径下的jar包和配置文件自动配置Bean，极大地减少了XML配置。 - **嵌入式Servlet容器**：Spring Boot支持内嵌Tomcat、Jetty等Servlet容器，无需单独...
【java框架】SpringBoot2(1) -- SpringBoot2入门及基础配置（csdn）————程序..pdf
12-04
SpringBoot2.x是Spring Boot框架的一个重要版本更新，它在2018年3月发布，带来了许多增强和新功能。这个版本不仅为小型企业和新项目提供了更好的开发体验，而且由于核心注解配置的兼容性，使得从1.x版本平滑过渡到2....
springboot+vue.js 前后端分离的宿舍管理系统.zip
最新发布
03-23
《基于SpringBoot+Vue.js的前后端分离宿舍管理系统详解》 ...通过学习和实践这个项目，学生不仅可以深入理解前后端分离的开发模式，还能提升对SpringBoot和Vue.js的运用能力，为未来的软件开发工作打下坚实基础。
SpringBoot聚合项目打包
weixin_34008784的博客
01-07 445
1.打包遇到的问题： 子模块打包时，每次打包出来的jar都只有3k左右，没办法运行，目测应该是依赖的jar没有打包进来！ 2.解决办法： 2.1.主项目的pom.xml里面不需要打包配置 2.2.在需要打包的项目pom.xml文件里做如下打包配置 <build> <finalName>microservice-eureka-7001&l...
springboot多模块拆分与打jar包、war包
java_Linmingxing的博客
12-17 5645
模块划分的重要性就不说了，直接进入正题吧
SpringBoot 2 构建多模块项目
纽雪澳诺加海美德的博客
03-11 3144
开篇词 该指南向你展示如何使用 Spring Boot 创建一个多模块项目。该项目将具有一个库 jar 和使用该库的主应用。你还可以使用它来查看如何自行构建库（既不是应用的 jar 文件）。   你将创建的应用 我们将设置一个库 jar，它公开简单的 “Hello, World” 消息服务，然后将该服务包含在使用库作为依赖项的 Web 应用中。   你将需要的工具 大概 15...
SpringBoot 多模块项目打包部署教程
Blackjoker0的博客
09-24 6510
逐步部署项目到云服务器
springboot一个项目多模块打包踩过的坑
u012903926的专栏
07-12 2万+
转载：https://blog.csdn.net/qq_28929589/article/details/79267467 其实主要几点： 切记父文件不需要打包和对应的模块不要写 因为对应的模块文件不需要打包，因为我的主模块需要到对应包中的依赖，打包了就找不到了 &amp;amp;lt;plugins&amp;amp;gt; &amp;amp;lt;plugin&amp;amp;gt; &amp;amp
【Springboot-maven】Spring Boot 多模块项目实践（附打包方法）
Japathy
04-22 5667
原文地址：Spring Boot 多模块项目实践（附打包方法） 序言： 比起传统复杂的单体工程，使用Maven的多模块配置，可以帮助项目划分模块，鼓励重用，防止POM变得过于庞大，方便某个模块的构建，而不用每次都构建整个项目，并且使得针对某个模块的特殊控制更为方便。 接下来，本文将重点阐述SpringBoot在Maven环境的多模块构建过程。 本项目传送门： https://githu...
springboot多个模块中扫描其他jar包中的Controller。
热门推荐
u014253054的博客
10-04 4万+
今天写业务，然后突然想到业务中需要微信支付 微信支付之前就已经写好了 然后由于微信支付中业务跳转比较多，而我自己是懒人一只。不想去弄了 想拿来直接用？那咋办？ 直接依赖 然后加载     里面没有微信支付的Controller   参考了SpringBoot官网的ComponentScan 注意： 这里就不解释其作用了，自行参考SpringBoot官网 解决办法如...
IDEA+Gradle+Springboot2.1.5 搭建多模块项目（最详细版)
qq_29286569的博客
06-14 1844
一，进入新建项目窗口，选择 Spring Initializr ，这是spring官方提供的构建springboot demo的网站 https://start.spring.io，也可直接在此网站上初始化项目后，下载后在导入idea。 二，在Group处填入组织，在Artifact处填入项目名称，然后在type下拉框中选择第三个gradle构建，完成后点击next 三，此时我们先创建一个根...
SpringBoot 2.x项目jar包部署
程裕强的专栏
02-14 2727
1、修改pom.xml 修改两处： （1）修改maven中的package方式为jar &amp;amp;amp;lt;packaging&amp;amp;amp;gt;jar&amp;amp;amp;lt;/packaging&amp;amp;amp;gt; （2）修改&amp;amp;amp;lt;build&amp;amp;amp;gt;&amp;amp;amp;lt;/build&amp;amp;amp;gt; &am
SpringBoot1.5.x 升级 SpringBoot2.x 全局异常处理[处理404 500] 重写/error
06-03
1. 在 SpringBoot2.x 中，全局异常处理（包括404和500）可以通过实现 `ErrorController` 接口来实现。您可以继承 `BasicErrorController` 类，并重写 `getErrorPath()` 和 `error()` 方法来处理异常。 2. 如果您想...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值