IDEA SpringBoot多模块项目搭建详细过程

Bertha 。 2023-02-17 05:19 20阅读 0赞

转载：[https://blog.csdn.net/zcf980/article/details/83040029?utm\_medium=distribute.pc\_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-1.nonecase&depth\_1-utm\_source=distribute.pc\_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-1.nonecase][https_blog.csdn.net_zcf980_article_details_83040029_utm_medium_distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-1.nonecase_depth_1-utm_source_distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-1.nonecase]

参考博客：https://blog.csdn.net/wanghantong/article/details/36427411

1. 项目介绍：

本项目包含一个父工程 demo  和 四 个子模块（demo-base, demo-dao, demo-service, demo-web)， demo-base 为其他三个模块的公共内容， 四个模块都依赖父模块， demo-dao 依赖 demo-base；   demo-service 依赖 demo-dao，也就间接依赖 demo-base;   demo-web 依赖 demo-service,，也就间接依赖demo-base和demo-dao

2. 搭建思路：

先创建一个 Spring Initializr工程 demo 作为 父工程， 然后在父工程再建四个子 Module (demo-base, demo-demo-dao, demo-service)，其实他们就是四个普通的Spring Initializr工程

3.开始搭建

首先，创建一个Spring Initializr项目 和 子Module

！！！！注意：  修改demo 的 pom 文件中的打包方式为 pom

好戏开始：

刚才演示创建成一个SpringBoot 工程， 下面正式开始演示搭建多模块

(1) 第一步， 删除刚才创建工程里的文件， 只保留(.idea文件夹 , 和项目 pom 文件, 以及一个 \*.iml 文件 )

（2）第二步， 创建子 Module （demo-base， demo-dao,  demo-service 和 demo-web）  先创建demo-base子工程

创建好了 demo-base 子项目 ， 为子工程 demo-base 生命父工程以及 为 父工程声明子 Module（在 demo 和 demo-base 的 pom 文件中添加如下代码）

---->在 demo-base 中 声明父工程， 注意：此时demo-base继承的是 SpringBoot提供的父工程， 需要修改<parent></parent>

中的版本信息， 修改成父项目 demo 的版本信息（直接将父项目 demo 的pom文件 中的版本信息复制粘贴到 mode-base             中即可）

--- 声明父工程

<parent>  
        <groupId>demo</groupId>  
        <artifactId>demo</artifactId>  
        <version>0.0.1-SNAPSHOT</version>  
        <relativePath/>   
</parent>  
    ----声明子 Module

<modules>  
         <module>demo-base</module>  
</modules>  
  修改后的父工程 demo 的 pom 文件

<?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">  
    <modelVersion>4.0.0</modelVersion>  
   
      
    <groupId>demo</groupId>  
    <artifactId>demo</artifactId>  
    <version>0.0.1-SNAPSHOT</version>  
    <packaging>jar</packaging>  
   
    <name>demo</name>  
    <description>Demo project for Spring Boot</description>  
   
      
    <parent>  
        <groupId>org.springframework.boot</groupId>  
        <artifactId>spring-boot-starter-parent</artifactId>  
        <version>1.5.16.RELEASE</version>  
        <relativePath/>   
    </parent>  
   
      
    <modules>  
        <module>demo-base</module>  
    </modules>  
   
    <properties>  
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>  
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>  
        <java.version>1.8</java.version>  
    </properties>  
   
    <dependencies>  
        <dependency>  
            <groupId>org.springframework.boot</groupId>  
            <artifactId>spring-boot-starter</artifactId>  
        </dependency>  
   
        <dependency>  
            <groupId>org.springframework.boot</groupId>  
            <artifactId>spring-boot-starter-test</artifactId>  
            <scope>test</scope>  
        </dependency>  
    </dependencies>  
   
    <build>  
        <plugins>  
            <plugin>  
                <groupId>org.springframework.boot</groupId>  
                <artifactId>spring-boot-maven-plugin</artifactId>  
            </plugin>  
        </plugins>  
    </build>  
   
   
</project>  
修改后的 demo-base 的 pom 文件

<?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">  
    <modelVersion>4.0.0</modelVersion>  
   
      
    <groupId>demo</groupId>  
    <artifactId>demo-base</artifactId>  
    <version>0.0.1-SNAPSHOT</version>  
    <packaging>jar</packaging>  
   
    <name>demo-base</name>  
    <description>Demo project for Spring Boot</description>  
   
      
    <parent>  
        <groupId>org.springframework.boot</groupId>  
        <artifactId>spring-boot-starter-parent</artifactId>  
        <version>1.5.16.RELEASE</version>  
        <relativePath/>   
    </parent>  
   
    <properties>  
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>  
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>  
        <java.version>1.8</java.version>  
    </properties>  
   
    <dependencies>  
        <dependency>  
            <groupId>org.springframework.boot</groupId>  
            <artifactId>spring-boot-starter-data-jpa</artifactId>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework.boot</groupId>  
            <artifactId>spring-boot-starter-web</artifactId>  
        </dependency>  
   
        <dependency>  
            <groupId>mysql</groupId>  
            <artifactId>mysql-connector-java</artifactId>  
            <scope>runtime</scope>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework.boot</groupId>  
            <artifactId>spring-boot-starter-test</artifactId>  
            <scope>test</scope>  
        </dependency>  
    </dependencies>  
   
    <build>  
        <plugins>  
            <plugin>  
                <groupId>org.springframework.boot</groupId>  
                <artifactId>spring-boot-maven-plugin</artifactId>  
            </plugin>  
        </plugins>  
    </build>  
   
   
</project>  
 创建demo-dao, demo-service  创建方法一样， 这里只演示demo-dao的创建

创建demo-web 模块与demo-dao创建除了第4步， 完全相同需要 添加 web依赖， 在创建过程的第4步需要添加 web 依赖

(4) 第三步 保留demo-web的启动类 和 配置文件， 其他项目的启动类都删除， 整个项目只需要一个启动类和一个配置文件

demo-base:    /demo/demo-base/src/main/java/demobase/demo/DemoBaseApplication.java   删除

/demo/demo-base/src/main/java/resource/\*   删除

demo-dao:    /demo/demo-dao/src/main/java/demodao/demo/DemoDaoApplication.java   删除

/demo/demo-dao/src/main/java/resource/\*   删除

demo-service:    /demo/demo-service/src/main/java/demoservice/demo/DemoServiceApplication.java   删除

/demo/demo-service/src/main/java/resource/\*   删除

(5)第四步 在 demo-dao 中添加 demo-base 的依赖信息， 在 demo-service 中添加 demo-dao 的依赖信息， 在 demo-web 中添加 demo-service 的依赖信息,  依赖信息添加到 各 pom 文件下的  <dependencies> </dependencies>节点下

添加依赖信息后的 demo-dao 的依赖信息

<dependencies>  
   
          
        <dependency>  
            <groupId>demo</groupId>  
            <artifactId>demo-base</artifactId>  
            <version>0.0.1-SNAPSHOT</version>  
            <scope>compile</scope>  
        </dependency>  
   
        <dependency>  
            <groupId>org.springframework.boot</groupId>  
            <artifactId>spring-boot-starter</artifactId>  
        </dependency>  
   
        <dependency>  
            <groupId>org.springframework.boot</groupId>  
            <artifactId>spring-boot-starter-test</artifactId>  
            <scope>test</scope>  
        </dependency>  
</dependencies>  
添加依赖信息后的 demo-service 的依赖信息  
<dependencies>  
   
          
        <dependency>  
            <groupId>demo</groupId>  
            <artifactId>demo-dao</artifactId>  
            <version>0.0.1-SNAPSHOT</version>  
            <scope>compile</scope>  
        </dependency>  
   
        <dependency>  
            <groupId>org.springframework.boot</groupId>  
            <artifactId>spring-boot-starter</artifactId>  
        </dependency>  
   
        <dependency>  
            <groupId>org.springframework.boot</groupId>  
            <artifactId>spring-boot-starter-test</artifactId>  
            <scope>test</scope>  
        </dependency>  
</dependencies>  
添加依赖信息后的 demo-web 的依赖信息

<dependencies>  
   
          
        <dependency>  
            <groupId>demo</groupId>  
            <artifactId>demo-service</artifactId>  
            <version>0.0.1-SNAPSHOT</version>  
            <scope>compile</scope>  
        </dependency>  
   
        <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>  
        </dependency>  
</dependencies>  
(6)第五步 编写测试代码

编写好代码后三个模块的目录结构（demo-base还未用上， 但实际项目中很有用）：

下面贴上代码：

给demo-dao 添加

Demo.java

package demo.demodao;  
   
import javax.persistence.\*;  
   
@Entity(name = "demo")  //设置实体名， 在数据库中是表名  
public class Demo \{  
   
    @Id  
    @GeneratedValue(strategy = GenerationType.AUTO)  //设置自动增长  
    @Column(name = "id")  
    private Integer id;  
      
   
    @Column(name = "name") //设置数据库字段名      
    private String name;  
   
    @Column(name = "id")  
    private Integer id;  
   
    public String getName() \{  
        return name;  
    \}  
   
    public void setName(String name) \{  
        this.name = name;  
    \}  
   
    public Integer getId() \{  
        return id;  
    \}  
   
    public void setId(Integer id) \{  
        this.id = id;  
    \}  
\}  
  DemoRepository.java

package demo.demodao;  
   
import org.springframework.data.jpa.repository.JpaRepository;  
   
public interface DemoRepository extends JpaRepository<Demo, Integer> \{  
   
\}  
  DemoService.java

package demo.demoservice;  
   
import demo.demodao.Demo;  
   
import java.util.List;  
   
   
public interface DemoService \{  
   
    Demo addOne(Demo demo);  
   
\}  
 DemoServiceImpl.java

package demo.demoservice.impl;  
   
import demo.demodao.Demo;  
import demo.demodao.DemoRepository;  
import demo.demoservice.DemoService;  
import org.springframework.beans.factory.annotation.Autowired;  
import org.springframework.stereotype.Service;  
   
@Service  
public class DemoServiceImpl implements DemoService \{  
   
    @Autowired  
    private DemoRepository demoRepository;  
   
    @Override  
    public Demo addOne(Demo demo) \{  
        return this.demoRepository.save(demo);  
    \}  
\}  
 DemoController.java

package demo.demoweb;  
   
import demo.demodao.Demo;  
import demo.demoservice.DemoService;  
import org.springframework.beans.factory.annotation.Autowired;  
import org.springframework.stereotype.Controller;  
import org.springframework.web.bind.annotation.GetMapping;  
import org.springframework.web.bind.annotation.ResponseBody;  
   
@Controller  
public class DemoController \{  
   
    @Autowired  
    private DemoService demoService;  
   
    @ResponseBody  // 返回 Json 数据  
    @GetMapping("add")  
    private Demo add()\{  
        Demo demo = new Demo();  
        demo.setName("姓名");  
        demo.setId(1);  
        return demoService.addOne(demo); // 成功返回 保存后的 demo  
    \}  
   
\}  
第六步： 创建数据库， 修改配置文件

创建输数据库 test

修改配置文件： 将 demo-web Resource目录下 application.properties 文件名改为 applicatin.yml并添加以下内容：

spring:  
  datasource:  
    \# jdbc:mysql://localhost:3306/test 数据库地址  
    url: jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=UTF-8&useSSL=false  
    username: root \# 数据库用户名  
    password: xxxxxx  \# 数据库密码  
    driver-class-name: com.mysql.jdbc.Driver  \# 数据库驱动  
   
  jpa:  
      hibernate:  
        ddl-auto: create-drop  \#  create-drop  如果实体对应的表已存在，先删除再创建，否则直接创建  
        \#  ！！！注意： 第一次运行时可设置为 create-drop, 这样就不需要手动创建数据库表, 但是后面运行务必设置为none

(7) 第七步： 大功告成， 运行项目

直接运行会报错

已解决：将启动类 DemoApplication 移动到 demo 包下

移动：

运行成功！！！！！！！

项目搭建过程中遇到的问题：

Error:(3, 20) java: 程序包demo.demodao不存在

解决方法：在控制台执行 mvn clean

项目打包遇到的问题：

1. 打包时需使用：mvn clean package -Dmaven.test.skip=true 忽略测试进行打包。测试代码不会影响项目发布，但是会影响项目的打包。

2. 项目打包报错：Non-resolvable parent POM for demo:demo-base:0.0.1-SNAPSHOT: Could not find artifact   
demo:demo:pom:0.0.1-SNAPSHOT and 'parent.relativePath' points at no local POM

解决方法：修改父项目，子Module：demo-base,demo-dao,demo-service,demo-web的 pom 文件，删除<parent></parent>标签的这句 <relativePath/>

3. 项目打包报错：\[ERROR\] Failed to execute goal org.springframework.boot:spring-boot-maven-plugin:1.5.16.RELEASE:  
repackage (default) on project demo-base: Execution default of goal org.springframework.boot:spring-boot-maven-plugin:1.5.16.RELEASE:repackage failed: Unable to find main class -> \[Help 1\]

原因：这是 demo-base 找不到主类的问题。因为此项目为多模块项目，但并不是每一个子模块都需要打成可执行的 Jar 包，如此项目中实际需要打成可执行的Jar 包的只有demo-web，且我们在构建项目之前已经将出demo-web外的项目的启动类即主类删了。所以此处会报错。

解决方法：修改处demo-web外的项目：父项目demo，demo-base、demo-dao、demo-service 的 pom 文件，删除其中关于打包的配置。

[https_blog.csdn.net_zcf980_article_details_83040029_utm_medium_distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-1.nonecase_depth_1-utm_source_distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-1.nonecase]: https://blog.csdn.net/zcf980/article/details/83040029?utm_medium=distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-1.nonecase&depth_1-utm_source=distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-1.nonecase