Maven中dependencyManagement标签的正确使用方法

目录

• 前言
• 使用方法
• 结束语

前言

  Maven中的dependencyManagement元素提供了一种管理依赖版本号的方式，她用于声明所依赖的jar包的版本号等信息。当所有子项目再次引入这些jar包时，则无需显式的定义version属性。Maven会沿着父子层级向上寻找拥有dependencyManagement 元素的项目，然后继承它约定的版本号。

使用方法

  pom文件中，有两种途径判断jar的版本号。

• 子项目未声明依赖版本号，则继承父项目中的。如果dependency标签未曾声明version元素，那么maven就会到父项目dependencyManagement标签里面去找该artifactId和groupId 的版本声明信息，如果找到了，就继承它；否则，就会抛出异常，告诉你必须为dependency声明version属性。

• 子项目定义的依赖版本号优先级高于父项目的。如果dependency标签声明了version属性，那么无论dependencyManagement中有无对该jar的version声明，都以dependency里的为准。

  在父项目的POM.xml中配置dependencyManagement标签，定义基本的父依赖。这里仅仅定义一个Junit5的依赖：

<?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>com.wiener</groupId>
    <artifactId>springBoot</artifactId>
    <version>1.0-SNAPSHOT</version>

    <modules>
        <module>wiener-demo</module>
    </modules>
    <!--打包方式pom-->
    <packaging>pom</packaging>

    <properties>
		<junit-jupiter.version>5.5.2</junit-jupiter.version>
    </properties>

    <!--   版本管理，导入需要的模块-->
    <dependencyManagement>
      <dependencies>
	   <!-- junit 5 -->
	   <dependency>
	      <groupId>org.junit.jupiter</groupId>
	      <artifactId>junit-jupiter-engine</artifactId>
	      <version>${junit-jupiter.version}</version>
	      <scope>test</scope>
	   </dependency>
        </dependencies>
     </dependencyManagement>

    <build>
    </build>
</project>

  在wiener-demo(pom.xml)中定义Junit5依赖：

//子项目实际引用的jar包 
<dependencies>
	<!-- junit 5 -->
	<dependency>
		<groupId>org.junit.jupiter</groupId>
		<artifactId>junit-jupiter-engine</artifactId>
	</dependency>
 </dependencies>

  modules标签中的模块就是项目的子模块，他们都受到父模块的版本约束，但是需要自己导入子模块的依赖。dependencyManagement标签定义项目通用的父依赖，各个依赖的版本号由properties标签定义，通过${变量名}的形式动态获取版本号。

  例如，在父依赖中junit5依赖的版本号5.5.2就定义在properties标签中，变量名是junit-jupiter.version，而dependencyManagement标签通过${junit-jupiter.version}导入版本号；在用到Junit5依赖的子模块中，只需声明依赖，无需描述版本信息。

结束语

  在顶层pom文件中，通过标签dependencyManagement定义公共的依赖关系，让所有的子项目使用依赖项的统一版本，确保应用的各个项目的依赖项和版本一致，保证测试的和发布的是相同的结果。

  这样做的优点是避免在每个子项目里都声明一个版本号，当想升级或切换到另一个版本时，只需要在顶层父容器里更新，而避免逐个修改子项目；另外如果某个子项目需要另外的一个版本，只需要在子项目声明version即可。温馨提示，dependencyManagement标签中定义的只是依赖的声明，并不实现引入，因此子项目需要显式的声明需要用的依赖。