知识点19--springboot多模块开发

本篇向大家介绍本系列demo教程中最后一个知识点就是多模块开发，多模块听着高大上，其实就是依靠maven相互之间的依赖，把多个模块融合进一个项目中而已，说的再直白一些就是像日常开发那样把其他模块导入一个模块，这个模块用来启动并调用所有模块而已。下面通过一个例子整体走一遍模块化开发。

第一步：建立父工程，

注意

通常情况下，父工程是一个spring initializr模式下创建出来的，但同样存在少量的人会先创建maven在转换成spring boot项目，这个其实就是手动添加所有依赖而已，那种方便用就用那种。

父模块任何环境依赖都不要，只需要指定springboot版本就行

建好的项目结构默认是下面这个样子

我们需要把父项目里，写代码的资源目录删掉，当然，如果看其他的不顺眼你也可以一起删掉，原则上保留

.idea、.mvn、父项目的pom

文件即可。

父项目的pom中查看是否指定了pom打包方式

<packaging>pom</packaging>

第二步：建立子项目为模块，我们总共创建三个子模块，

commons

为公共模块，

service

为Service功能模块，

web

为Controller功能以及启动模块，因此在依赖关系上组成

web依赖于service，service依赖commons

在父项目名上右键单击创建module

子模块创建的时候，你要注意使用maven模式还是spring initializr，因为如果用spring initializr创建的是一个完整相对独立的springboot项目，它的父子关系、jar依赖以及作为子模块有一些东西是不需要的这些你都要自己操作，而maven创建就比较方便

我们先创建一个普通的maven项目为commons模块，maven项目创建时可以直接选择父工程

commons是一个公共包它不需要任何的支持，所以它的项目结构很简洁

下面我们创建service模块，同样也是一个普通的maven项目，当然如果你觉得有必要可以创建一个springboot项目

最后是web模块，由于web模块还负责启动项目的功能，因此我们要用spring initializr创建一个相对完整的springboot项目，应当注意有的时候由于操作问题，在创建好springboot框架的子模块后，该模块很可能缺少context配置，直观的表现为配置文件无提示，并且代码源为灰色普通目录，这种情况右键代码源文件路径进行设置，而context和配置文件识别见知识点8

web模块需要web环境的支持

由于不是maven创建，所以需要手动维护父子项目关系，在web模块pom中修改

parent

标签为父项目

<parent><artifactId>boot-par</artifactId><groupId>com.wy</groupId><version>0.1</version><relativePath>../pom.xml</relativePath></parent>

web模块的pom文件中还要依赖service模块

<dependency><groupId>com.wy</groupId><artifactId>boot-service</artifactId><version>0.1</version></dependency>

service模块要依赖commons模块，也就是说我们要在service模块的pom中添加commons的依赖。

<dependency><groupId>com.wy</groupId><artifactId>boot-commons</artifactId><version>0.1</version></dependency>

在父项目中要确保声明了所有的子模块

<modules><module>boot-commons</module><module>boot-service</module><module>boot-web</module></modules>

到此项目结构就准备好了。最后要注意二种情况，第一个如果你的子模块是直接从外部复制进去的，一定要维护好父子pom的同时，确保模块名字没有和路径名字是一样的，不要出现

路径名[模块名]

这种格式，如果出现了，右键模块rename修改即可。第二个是复制过来的模块代码源路径常常后面存在

resource root

的字样，这种情况选择

File --> Project Structure -->Modules 

，随后找到模块的source内容，右侧会有灰色的内容删除掉即可。

第三步：写一套测试代码。首先在commons中写一个工具类，简单的输出一句话。

packagecom.wy.utils;/**
 * @创建人 wangyang
 * @创建时间 2022/10/2
 * @描述
 */publicclassOutPutUtil{publicstaticvoidoutMes(){System.out.println("commos模块的输出");}}

随后在Service模块中写一个测试Service调用commons的工具类

packagecom.wy;importcom.wy.utils.OutPutUtil;/**
 * @创建人 wangyang
 * @创建时间 2022/10/2
 * @描述
 */@ServicepublicclassOutPutService{publicvoidoutMes(){OutPutUtil.outMes();System.out.println("这里是Service");}}

这里注意子模块是可以使用父项目的依赖的，所以不要疑惑service模块没有依赖怎么可以用Service注解。顺带着还要说明springboot可以直接使用ssm的service和dao开放方式，并不是说只能继承IService等资源，区别就在于如果继承你可以拥有框架内部给你写好的基本方法

如果你在写代码的时候commons的模块代码引用不到，就点击一下maven的刷新

最后在web模块中添加写一个测试用的Controller

package com.example.bootweb.controller;import com.wy.OutPutService;import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.RequestMapping;import javax.annotation.Resource;

/**
 * @创建人 wangyang
 * @创建时间 2022/10/2
 * @描述
 */
@RestController
public class OutController {

    @Resource
    private OutPutService outPutService;

    @RequestMapping("/getMes")
    public String outMes(){return"请求成功";}}

并且在web模块的启动类上添加一个扫描包的注解，如果从前面知识点看过来的会疑惑这个例子中没有写Dao层，为什么要写扫描包的注解？对此要解释一下，前面知识点使用的注解是

@MapperScan

，是MybatisPlus提供的用来指定Dao层包的，但是我们现在要用的注解是

@ComponentScan

，是springboot提供的用它来指定根包，将不同模块中的Bean提交到Spring容器里面

packagecom.example.bootweb;importorg.springframework.boot.SpringApplication;importorg.springframework.boot.autoconfigure.SpringBootApplication;importorg.springframework.context.annotation.ComponentScan;importorg.springframework.context.annotation.ComponentScans;@SpringBootApplication@ComponentScan(basePackages ={"com.wy","com.example"})publicclassBootWebApplication{publicstaticvoidmain(String[] args){SpringApplication.run(BootWebApplication.class, args);}}

在把web模块中的springboot配置文件设置一个端口

server.port=91

到此测试代码就写完了。

第四步：打包，但是我们要对每个模块pom依赖中的编译插件，做一下设置，让maven知道每个模块怎么编译，不设置的话会爆一些默认资源没有的错误。

首先父工程的编译插件不变

<plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin>

在web模块中你要手动指定启动类

<plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><configuration><mainClass>com.example.bootweb.BootWebApplication</mainClass></configuration></plugin>

而其它非启动模块，如service和commons模块中设置不让springboot-maven编译插件将当前模块作为启动模块编译

<plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><configuration><skip>true</skip></configuration></plugin>

最后一定要确保所有的模块pom文件声明了jar打包方式，如果你不申明很可能会报

'packaging' with value 'jar' is invalid. Aggregator projects require 'pom' as packaging.

的错误，并且注意父模块的打包方式应该是

pom

<packaging>jar</packaging>

此时，运行父项目的maven命令进行打包，等待结束可以在控制台中看到编译成功，

要注意，因为是首次编译，所以我们直接用父项目的命令将所有模块全部编译，如果你后面对某个模块单独的更新迭代，那么用模块的命令就可以

第六步：运行，我们通过web模块的启动类使用内部web软件运行项目，并发出请求。



当然你可以不在idea里面运行，而是在黑窗口中直接运行web项目的jar包

运行时应当注意多模块开发的时候，使用springboot框架的子模块常常会在运行的时候出现打包无异常，但运行的时候报错

org.springframework.stereotype

，这种情况你需要在idea开发工具的maven插件上找到如下图标

随着idea的版本不同，图标有的是个dos窗口图标

找到后选中你的web模块然后点击图标，在打开的窗口中运行如下命令，首次运行需要手动输入

运行后会重构项目，并在父项目的主路径下多出几个文件，如下图

此时重新编译打包web模块既可以了

特别说明

模块化开发，本质上是为了解决两个问题，第一个是让maven项目相互依赖，最终组成一个相对完整的项目运行，就像上面例子一样，这样的好处就是解耦开发，增强代码的复用。第二个是模块开发可以使得maven帮助我们调整jar依赖的版本并且解决jar包的冲突。不过jar冲突方面maven只能解决90%的问题，还有另外10%是这包本身没有向下兼容，不过Apache的包基本都是向下兼容的，出现这类问题基本是其他的包

同时本例中service模块和commons模块包路径其实不是很合理，应该在所有子模块中考虑有一个用来区分不同模块的包名这样逻辑更清晰一些。你也可以结合知识点18将web模块部署到外部的tomcat上。

在正式开发中存在着保存当前版本jar到本地maven库的需求，这个就是你运行maven的install命令就可以，可是千万要记得要从最底层依赖开始install，比如上面的例子中你需要按照

commons-》Service-》web

这样的顺序install，不然会报错。