Maven-dependencyManagement和dependencies

概述

在《Maven-modules》文章中，我们说到父子模块的好处，提到父模块可以统一管理依赖包版本号。本章具体说明下标签dependencyManagement和dependencies如何管理项目依赖项信息。

DepencyManagement

dependencyManagement标签一般在父模块中配置JAR包的版本，让子模块中引用一个依赖而不用显示的列出版本号。Maven会沿着父子层次向上走，直到找到一个拥有dependencyManagement元素的项目，然后它就会使用在这个dependencyManagement元素中指定的版本号。

项目结构图：

父项目earth的pom.xml：

<?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>ymqx.com</groupId>
    <artifactId>earth</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>
    <modules>
        <module>tool</module>
    </modules>

    <properties>
        <!-- 依赖包版本号 -->
        <slf4j.version>1.7.30</slf4j.version>
        <lombok.version>1.18.8</lombok.version>
        <fasterxml.version>2.11.1</fasterxml.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.slf4j</groupId>
                <artifactId>slf4j-api</artifactId>
                <version>${slf4j.version}</version>
            </dependency>

            <dependency>
                <groupId>com.fasterxml.jackson.core</groupId>
                <artifactId>jackson-core</artifactId>
                <version>${fasterxml.version}</version>
            </dependency>

            <dependency>
                <groupId>com.fasterxml.jackson.core</groupId>
                <artifactId>jackson-databind</artifactId>
                <version>${fasterxml.version}</version>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>${lombok.version}</version>
        </dependency>
    </dependencies>

</project>

dependencyManagement配置了slf4j-api.1.7.30、jackson-core.2.11.1、jackson-databind.2.11.1。
dependencies配置了lombok.1.18.8。

子模块tool的pom.xml：

<?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">
    <parent>
        <artifactId>earth</artifactId>
        <groupId>ymqx.com</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>tool</artifactId>

    <properties>
        <!-- 依赖包版本号 -->
        <fasterxml.version>2.11.2</fasterxml.version>
    </properties>

    <!--依赖关系-->
    <dependencies>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
        </dependency>

        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-core</artifactId>
            <version>${fasterxml.version}</version>
        </dependency>
    </dependencies>
</project>

配置slf4j-api没有声明版本号，jackson-core声明了版本号2.11.2。

好处：

• 统一管理项目的版本号，确保所有项目的依赖版本一致，防止版本混乱冲突。
• 顶层pom中定义共同的依赖信息，避免每个使用的子项目中都声明一个版本号，如果变更版本时，只需要在父类pom里更新。
• 如果某个子模块需要其他版本号时，只需要在子模块的dependencies中声明一个版本号即可。子模块就会使用子模块声明的版本号，不继承于父类版本号。

Dependencies

相对于dependencyManagement，所有声明在dependencies里的依赖都会自动引入，并默认被所有的子项目继承。

区别

先看依赖信息情况：

结果分析：
slf4j-api.1.7.30：子模块引用依赖slf4j-api，默认使用父项目版本号1.7.30。
jackson-core.2.11.2：子模块引用依赖jackson-core，并声明了版本号2.11.2，会覆盖父项目版本号（2.11.1）。
lombok.1.18.8：父项目dependencies声明的所有依赖默认被所有的子项目继承。

注：因为子模块没有引用父项目dependencyManagement声明的jackson-databind，默认不会被继承。

总结如下：

• dependencies即使在子项目中不写该依赖项，那么子项目仍然会从父项目中继承该依赖项（全部继承）
• dependencyManagement里只是声明依赖，并不实现引入。子项目需要显式声明需要用的依赖，并且不指定具体版本，才会从父项目中继承该项；如果子项目中指定了版本号，就会覆盖父项目版本号。