一、创建流程
1、首先创建springboot项目作为父项目
只留下pom.xml 文件,删除src目录及其他无用文件
2、创建子项目
子项目可以是maven项目,也可以是springboot项目
3、父子项目关联
4、父项目中依赖管理
<?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>
<!-- 继承的springboot版本--><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.6.3</version><relativePath/> <!-- lookup parent from repository --></parent><!-- 引入子模块 --><modules><module>system</module><module>gateway</module><module>common</module></modules><groupId>com.matter</groupId><artifactId>record</artifactId><version>0.0.1-SNAPSHOT</version><name>syh_matter_record_server</name><description>syh_matter_record_server</description><packaging>pom</packaging><!-- 作用:公共依赖引入使用场景:基本所有子模块都用到的依赖--><dependencies><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId></dependency><!-- jdbc依赖包 --><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId></dependency></dependencies><!-- 版本管理 --><properties><java.version>1.8</java.version><spring.cloud.version>2021.0.1</spring.cloud.version><spring.cloud.alibaba.version>2021.0.1.0</spring.cloud.alibaba.version><mybatis.plus.version>3.4.3.4</mybatis.plus.version><fastjson2.version>2.0.9</fastjson2.version><pagehelper.version>1.4.3</pagehelper.version></properties><!-- 作用:依赖版本生命,不做依赖引入。使用dependencyManagement统一管理项目的版本号,确保应用的各个项目的依赖和版本一致,不用每个模块项目都弄一个版本号,不利于管理。 --><dependencyManagement><dependencies><!-- spring-loud --><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-dependencies</artifactId><version>${spring.cloud.version}</version><type>pom</type><scope>import</scope></dependency><!-- 阿里微服务 --><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-alibaba-dependencies</artifactId><version>${spring.cloud.alibaba.version}</version><type>pom</type><scope>import</scope></dependency><!-- mybatis-plus --><dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-boot-starter</artifactId><version>${mybatis.plus.version}</version></dependency><!-- 阿里json解析 --><dependency><groupId>com.alibaba.fastjson2</groupId><artifactId>fastjson2</artifactId><version>${fastjson2.version}</version></dependency><!-- 分页插件--><dependency><groupId>com.github.pagehelper</groupId><artifactId>pagehelper-spring-boot-starter</artifactId><version>${pagehelper.version}</version></dependency></dependencies></dependencyManagement><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build></project>
depedencyManagement标签介绍
在maven的聚合工程中,父模块的pom文件中,使用dependencyManagement统一管理项目的版本号,确保应用的各个项目的依赖和版本一致,不用每个模块项目都弄一个版本号,不利于管理。
dependencyManagement里只是声明依赖,并不自动实现引入,需要子项目声明需要用的依赖。
- 如果不在子项目中声明依赖,是不会从父项目中继承下来的;
- 如果在子项目中写了该依赖项,但是没有指定具体版本,这时候才会从父项目中继承相应依赖,以及相应的version和scope;
- 如果在子项目中写了该依赖项,并且项目中指定了版本号,那么会使用子项目中指定的版本,不再使用父项目指定的依赖版本号。
父项目使用depedencyManagement声明依赖,子工程引入依赖不需要声明版本
5、公共模块使用
第一步:创建公共模块 common
第二步:父子关联
第三步:其他模块使用公共模块 common
dependencies标签引入公共模块 common,然后就可以调用方法了
二、遇到的问题以及解决方法
1、公共模块被其他模块引入后使用,使用正常,打包报错 程序包 com.xxx.common.utils不存在或者xxx找不到符号
原因:SpringBoot工程打包编译时,会生成两种jar包,一种是普通的jar,另一种是可执行jar。默认情况下,这两种jar的名称相同,在不做配置的情况下,普通的jar先生成,可执行jar后生成,造成可执行jar会覆盖普通的jar。而service工程无法依赖common-utils工程的可执行jar,所以编译失败:程序包不存在。
解决:在common-utils工程中,pom.xml文件中加入配置即可:
<build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><configuration><classifier>exec</classifier></configuration></plugin></plugins></build>
2、Maven多模块项目无法加载其他模块(公共模块)下的Bean
比如公共模块中有redis序列化配置,以及redis工具类需要需要注入
在需要使用的模块中的启动类添加 @ComponentScan注解
// 值为一个数组,表示扫描的路径,递归扫描到最后
@ComponentScan(basePackages = {"com.example"})
这里看到我们两个模块刚好前缀一样,所以只配置一个路径即可