IDEA创建SpringBoot父子Module项目的实现

更新时间：2023年05月15日 10:43:26 作者：马称同

本文主要介绍了IDEA创建SpringBoot父子Module项目的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧

前言

作者正在筹备一个专题 《SpringCloud Alibaba 源码解析》，会在正式发布 SpringCloud Alibaba 源码系列文章之前，将一些准备工作先做好

创建 SpringBoot 父子模块项目
Docker 安装 Nacos Server 端
Docker 安装 RocketMQ 端
…

本篇文章从第一步开始详细讲解如何 《创建 SpringBoot 父子模块项目》

如果将 SpringBoot 框架用作与单体项目，可能不存在多模块的情况

但是并不代表没有，因为父子模块并不局限于微服务，单体项目也可以进行明确的职责划分

如果是构建微服务项目，基本上会对模块进行明确的划分，比如：

抽象定义公共代码及Util封装进行引用
业务代码进行单独定义模块
数据库等DB操作相关抽离单独模块
提供外部平台调取的接口单独定义模块
…

上面的拆分也并非绝对，随着架构师对于项目结构的不同理解，可能会衍生出不同的模块

比较经典的就是 Dubbo 将接口 API 进行抽离提供生产者接口，打为 Jar 包供消费端调用

本篇文章也会从零到一创建 SpringBoot 父子模块的项目，演示聚合、继承的项目特性，并针对不引人注意的知识点进行讲解

在这里假设读者小伙伴已经 掌握了什么是 SpringBoot 概念

1. 软硬件环境

电脑： McaBook Pro
创建项目工具： IDEA 2019.3.4
JDK 版本： 还能再坚持20年的 JDK8
Maven版本： 3.5.4

2. 创建 SpringBoot 项目

1）首先打开 IDEA 工具，点击 + Create New Project

2）选择 Spring Initializr（初始化），选择Project SDK 1.8，使用默认的 SpringBoot 脚手架即可

大家可以访问 Default 的网址，在这个网址中也可以进行 SpringBoot 项目的创建

3）创建项目详细信息，会逐一进行讲解

Group： 项目组织唯一的标识符，实际对应 Java 的包的结构，是 main 目录里 Java 的目录结构

Group 也就是 groupId，分为多个段；一般情况下 第一段为域，第二段为公司，第三段为项目名称

以 Nacos 源码进行举例，Group 为 com.alibaba.nacos

com 为商业组织，alibaba 为公司名称，nacos 就是项目名称

Artifact： 项目的唯一的标识符，实际对应项目的名称，就是项目根目录的名称

Artifact 即为 artifactId，还是以 Nacos 举例，因为最近在看它～

Nacos 不同功能组件的 artifactId 各不相同，比如权限相关的子模块就是 nacos-auth，客户端相关是 nacos-client，具体到了项目功能组件

Type： 分为四种不同的类型，日常我们选择默认第一条就行，也就是 Maven Project

Language： 开发语言的话自然就是默认的 Java

Packaging： 打包方式，分为 War 包和 Jar 包，这里选择 Jar 包

Java Version： 选择 Java 的一个版本，再坚持 20 年的 JDK 1.8

Version： 当前项目的一个版本，SNAPSHOT 为快照的意思

开发时一般使用此类型，因为对于 Maven 仓库的同步较为友好，有不同纬度的同步选择

Name： 定义项目名称

Description： 定义项目描述信息，帮助别人更好的了解项目

Package： 定义 main.java 目录下的结构

最终定义项目选项及配置名称如下，点击 Next 按钮继续进行

4）选择 SpringBoot 版本信息以及 Pom.xml 文件依赖组件

这里选择的 SpringBoot 版本是 2.2.10，选择了 Spring Web 当作 Maven 依赖项

后续会使用发布 Web 测试项目整体是否成功，接下来点击 Next 继续进行下一步

5）这里需要确定项目名称以及项目的存放地址，确认无误点击 Finish

6）一个标准的 SpringBoot 项目就产生了

3. 构建子 Module

1）Mac 电脑是点击菜单栏中 File -> New -> Module，Windos 中可能会有一点差异

2）这里就是重复上述在创建 SpringBoot 项目时的步骤，Next 下一步

3）Group 与 Parent 项目保持一致即可，Artifact 修改为 Module 项目作用域名城即可

4）配置可按照需求进行选择，因为不同的 Module 需要引用不同的 Pom 依赖，后面会与 Parent 保持一个交互

5）确认创建信息，点击 Finish 生成项目

6）最终结构目录如下，项目已成功创建，后续我们要修改其中的 Pom.xml 使其成为真正的父子项目

4. 建立父子 Module 依赖

如果将建立的 Parent 项目与后面创建的 Module 产生关联，需要改动以下几点

修改 Parent 项目 Pom.xml 的 packaging 标签打包方式为 pom
修改 Module 项目 Pom.xml 文件依赖 Parent 项目
删除不必要文件并梳理 Pom.xml 依赖上下级关系

4.1 修改 Parent 项目 packaging

打开 Parent 项目的根 Pom.xml 文件，新增下方代码

<packaging>pom</packaging>
<modules>
    <module>bootdemo-remote-api</module>
</modules>

packaging 包含三个值 Jar、War、Pom，默认 Jar的方式

首先来解释下 packaging 为 Pom 的意思，宏观而言即没有代码需要测试或者编译，也没有资源需要处理

Jar： 内部调用或作为服务进行发布使用
War： 需要部署的项目
Pom： 寓意为一个父级项目，一般作为项目聚合和依赖传递使用

modules 代表了 Parent 项目下的子 Module，体现了聚合的思想

这里把 Parent 项目的 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>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.10.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>cn.machen.bootdemo</groupId>
    <artifactId>bootdemo-parent</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>bootdemo-parent</name>
    <description>创建 SpringBoot 父子模块项目</description>
    <packaging>pom</packaging>
    <modules>
        <module>bootdemo-remote-api</module>
        <module>bootdemo-biz</module>
    </modules>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintage</groupId>
                    <artifactId>junit-vintage-engine</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

spring-boot-maven-plugin 的作用是运行 mvn package 时会将项目打包为可运行的 jar 包，java -jar 运行即可

如果不加这个 plugins，java -jar xxx.jar 会报出如下错误

xxx/target/bootdemo-remote-api-0.0.1-SNAPSHOT.jar中没有主清单属性

4.2 修改 Module Pom.xml 信息

创建后的 Module 项目的 Parent 信息是 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>cn.machen.bootdemo</groupId>
        <artifactId>bootdemo-parent</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>
    <artifactId>bootdemo-remote-api</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>bootdemo-remote-api</name>
    <description>SpringBoot Module 项目</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
</project>

4.3 删除不必要文件

删除 bootdemo-parent 项目下 src 包，因为 bootdemo-parent 作为聚合型项目，不会产生业务数据以及相关配置

另外说一下 dependencies 和 dependencyManagement 标签做一个讲解

dependencies

如果 Parent 项目中使用 dependencies 标签，标签内的依赖默认传递子 Module，不用子 Module 进行显示书写依赖

dependencyManagement

dependencyManagement 与dependencies 不同的是，标签内的依赖不会默认传递子 Module，其作用只是为了统一版本声明

如果子 Module 依赖 Parent 项目中 dependencyManagement 标签内的 pom 依赖，需要显示在子 Module 的 pom 文件中进行书写

5. 项目继承关系

我们按照《构建子 Module》章节的内容，构建出如下所述的子 Module

<groupId>cn.machen.bootdemo</groupId>
<artifactId>bootdemo-biz</artifactId>
<version>0.0.1-SNAPSHOT</version>

然后修改 bootdemo-biz 子 Module 的 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>
    <parent>
        <groupId>cn.machen.bootdemo</groupId>
        <artifactId>bootdemo-parent</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>
    <artifactId>bootdemo-biz</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>bootdemo-biz</name>
    <description>创建 SpringBoot 父子模块业务 Module</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
      	<!--继承bootdemo-remote-api项目-->
        <dependency>
            <groupId>cn.machen.bootdemo</groupId>
            <artifactId>bootdemo-remote-api</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>
    </dependencies>
</project>

通过继承关系的设置，bootdemo-remote-api 中的代码就可以被 bootdemo-biz Module 项目进行引用

6. 发布 WEB 服务

在 Parent 项目 Pom.xml dependencies 标签中定义了 spring-boot-starter-web 依赖，直接使用 web 相关内容即可

我们在 bootdemo-biz 中创建 Controller 控制器

@RestController
public class DemoController {
    @GetMapping("/echo/{name}")
    public String sayHello(@PathVariable("name") String name) {
        return "Hello World " + name;
    }
}

启动后端项目成功后，浏览器输入 http://localhost:8080/echo/mahua 请求后端服务

到此这篇关于IDEA创建SpringBoot父子Module项目的实现的文章就介绍到这了,更多相关IDEA 创建SpringBoot父子项目内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

详解mall整合SpringBoot+MyBatis搭建基本骨架
这篇文章主要介绍了详解mall整合SpringBoot+MyBatis搭建基本骨架，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-08-08
JNDI具体用法详解
JNDI是java命名和目录接口，本文主要介绍了JNDI具体用法详解，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-12-12
spring-boot-plus V1.4.0发布集成用户角色权限部门管理(推荐)
这篇文章主要介绍了spring-boot-plus V1.4.0发布集成用户角色权限部门管理,本文给大家介绍的非常详细，具有一定的参考借鉴价值需要的朋友可以参考下
2019-11-11
Spring Cloud Hystrix 线程池队列配置(踩坑)
这篇文章主要介绍了Spring Cloud Hystrix 线程池队列配置(踩坑)，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2019-01-01
Java详解实现ATM机模拟系统
这篇文章主要为大家详细介绍了如何利用Java语言实现控制台版本的ATM银行管理系统，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-06-06
java中http请求之restTemplate配置超时时间问题解决
这篇文章主要介绍了java中http请求之restTemplate配置超时时间,本文给大家分享三种解决方法，结合实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2023-05-05
Java中的弗洛伊德(Floyd)算法
这篇文章主要介绍了Java中的弗洛伊德(Floyd)算法,Floyd算法又称为插点法,是一种利用动态规划的思想寻找给定的加权图中多源点之间最短路径的算法,与Dijkstra算法类似,需要的朋友可以参考下
2024-01-01
Java分布式锁理论(redis、zookeeper))案例详解
zookeeper有个节点路径的概念,节点路径不能重复,保证了唯一性,这篇文章给大家介绍Java分布式锁理论(redis、zookeeper) 案例详解,感兴趣的朋友跟随小编一起看看吧
2024-01-01
Java实现自定义语言和表达式解析的解释器模式
Java解释器设计模式通过解析自定义语言和表达式，实现对复杂逻辑的处理，提高程序可扩展性和灵活性。它将语法解析和执行过程分离，通过抽象语法树和解释器实现对语言和表达式的解析和求值，避免了硬编码和复杂的条件判断，提高了程序的可读性和可维护性
2023-04-04
Java 异步回调机制实例分析
这篇文章主要介绍了Java 异步回调机制实例解析的相关资料,需要的朋友可以参考下
2017-02-02