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标签中找,都没有就报错。