springboot项目的pom文件中,我们经常看见这样(下图)两种springboot的版本依赖管理方式;图片中的这两种依赖声明方式任意用其中一种都可以。文章后面会简单阐述一下区别和使用场景。
事例中完整的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 https://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.zhh.platform</groupId><artifactId>demo2</artifactId><version>0.0.1-SNAPSHOT</version><name>demo2</name><description>Demo project for Spring Boot</description><properties><java.version>1.8</java.version><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding><spring-boot.version>2.6.13</spring-boot.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></dependency></dependencies><!-- 声明依赖 --><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.6.13</version></parent><!-- 声明依赖 --><!-- <dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>2.6.13</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement>--><build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.8.1</version><configuration><source>1.8</source><target>1.8</target><encoding>UTF-8</encoding></configuration></plugin><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><version>${spring-boot.version}</version><configuration><mainClass>com.zhh.platform.Demo2Application</mainClass><skip>true</skip></configuration><executions><execution><id>repackage</id><goals><goal>repackage</goal></goals></execution></executions></plugin></plugins></build></project>
1. 两者的区别和作用
spring-boot-starter-parent继承了spring-boot-dependencies,打开spring-boot-starter-parent的pom文件就能看见他的父级就是spring-boot-dependencies,不过他多了一些配置,比如配置了UTF-8编码格式,如果我们继承了spring-boot-starter-parent,就可以不用再配置编码格式,否则还是需要配置一下
下面是spring-boot-dependencies的pom文件部分截图
他提供了相关的默认版本依赖,使用它之后,常用的包依赖可以省去version标签,例如:
在使用过程中,如果用的是spring-boot-starter-parent,一般会把他写在parent标签中;如果用的是spring-boot-dependencies,一般会把他写在dependencyManagement标签中,例如:
<!-- 声明依赖 --><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.6.13</version></parent><!-- 两者选择其一,另一个注释掉 --><!-- 声明依赖 --><dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>2.6.13</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement>
其实反过来写也可以,不过还是不要独行特立,例如:
<!-- 声明依赖 --><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>2.6.13</version></parent><!-- 两者选择其一,另一个注释掉 --><!-- 声明依赖 --><dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.6.13</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement>
上面说到了两种声明父依赖的方式分别是在<parent>标签和<dependencyManagement>标签中声明,有什么区别呢?
2. parent标签和dependencyManagement标签中声明父依赖的区别
<parent>标签只支持单继承,如果需要多个父级,就需要用到dependencyManagement标签。
假如我们现在要添加 spring-boot-starter-web 依赖,我们是不需要声明版本的,
但是如果现在我们需要添加 spring-cloud-starter-gateway 依赖,你会发现,如果不声明版本根本就不行,因为spring-cloud-starter-gateway是springCloud的相关依赖,他在spring-boot-starter-parent的父级spring-boot-dependencies中根本就没有对应的版本声明,这个时候如果不想自己声明版本,就需要在dependencyManagement标签中添加spring-cloud-dependencies的声明,spring-cloud-dependencies的pom文件中声明了springcloud相关依赖的版本
在使用过程中,如果需要多个父依赖,就需要用到dependencyManagement标签,可以一个父依赖在parent标签中,其他的父依赖在dependencyManagement标签中,也可以都在dependencyManagement标签中。
如果只有一个父依赖,可以在dependencyManagement标签中声明,也可以在parent标签中声明。
随便理一下dependencyManagement标签和dependencies标签的区别
a.dependencyManagement标签
dependencyManagement标签可以理解成一个maven中的依赖管理器,他只声明不引入。在maven多模块项目(父子工程)中,一般都是在dependencyManagement标签中声明所有需要的依赖,然后子模块中只需要添加相应的groupId和artifactId即可,并不需要声明版本号。这样做的目的是为了方便jar包版本的统一管理,如果需要修改jar依赖的版本,只需要修改父pom一个地方即可。
b. dependencies标签
dependencies标签中引入了一个jar包之后,如果没有加上version版本号的话,那么maven就会去<dependencyManagement>里找对应groupId和artifactId的声明并使用对应的版本号,先在当前pom文件的dependencyManagement标签中找,如果没有,就到父模块的dependencyManagement标签中找,都没有就报错。