Maven 依赖管理

Maven 是一个强大的工具，它简化了项目依赖的管理。

Maven 自动化了下载和包含必要库的过程，这对于构建 Java 应用程序至关重要。

本文将涵盖 Maven 依赖管理的核心方面，包括如何声明依赖、依赖范围、传递依赖、依赖管理、排除依赖和解决冲突。

我们还将提供一个完整的示例来说明这些概念。

1. 了解依赖

在 Maven 中，依赖是指项目所需的外部库或模块。依赖在项目对象模型（POM）文件中指定。Maven 在构建过程中使用这些依赖，以确保所有必要的组件都可用。

2. 在 POM 中声明依赖

依赖在 POM 文件的 <dependencies> 部分声明。每个依赖项通过以下元素指定：

groupId：依赖所属的组或组织。
artifactId：依赖的唯一标识符。
version：要使用的依赖版本。
scope：依赖在构建过程中的作用范围。

示例：

<dependencies><dependency><groupId>org.junit.jupiter</groupId><artifactId>junit-jupiter-api</artifactId><version>5.9.3</version><scope>test</scope></dependency>
</dependencies>

3. 依赖范围

scope 元素定义了依赖的可见性。Maven 支持多种范围：

compile：默认范围，适用于所有类路径。
provided：编译时可用，但不会包含在最终的包中。
runtime：运行时可用，但编译时不可用。
test：仅在测试期间可用。
system：类似于 provided，但需要显式提供依赖。
import：仅在 dependencyManagement 部分可用，用于导入依赖 POM。

示例：

<dependency><groupId>javax.servlet</groupId><artifactId>javax.servlet-api</artifactId><version>4.0.1</version><scope>provided</scope>
</dependency>

4. 传递依赖

Maven 不仅解析直接依赖，还解析这些依赖的依赖，即传递依赖。这确保了所有必需的库都被包含在构建中。

示例：
如果 junit 依赖于 hamcrest-core，Maven 会自动将这些传递依赖包含在项目中。

5. 依赖管理

<dependencyManagement> 部分用于定义一组可以被子项目继承的依赖。它提供了一个集中管理依赖版本的地方。

示例：

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

6. 排除依赖

有时，您可能需要排除特定的传递依赖。这可以通过 <exclusions> 元素实现。

示例：

<dependency><groupId>org.hibernate</groupId><artifactId>hibernate-core</artifactId><version>5.4.32.Final</version><exclusions><exclusion><groupId>org.jboss.logging</groupId><artifactId>jboss-logging</artifactId></exclusion></exclusions>
</dependency>

7. 仓库

Maven 使用仓库来下载依赖。有两种类型的仓库：

本地仓库：位于开发者的机器上，Maven 将下载的依赖缓存于此。
远程仓库：公共仓库如 Maven Central 或公司自定义仓库，其中托管依赖。

配置仓库：
仓库可以在 POM 文件或 Maven 设置文件（settings.xml）中配置。

示例：

<repositories><repository><id>central</id><url>https://repo.maven.apache.org/maven2</url></repository>
</repositories>

8. 解决冲突

当多个版本的同一依赖被包含时，Maven 使用最近定义策略来解决冲突。最近的 POM 文件（最接近项目的 POM 文件）中指定的版本优先。

使用依赖调解：
为了显式控制依赖的版本，可以使用 <dependencyManagement> 部分。

示例：

<dependencyManagement><dependencies><dependency><groupId>com.google.guava</groupId><artifactId>guava</artifactId><version>31.0.1-jre</version></dependency></dependencies>
</dependencyManagement>

9. 完整示例

让我们通过一个完整的示例来整合所有内容，这是一个简单的 Java 项目。

项目结构：

my-app
│   pom.xml
└───src└───main└───java└───com└───example└───app│   App.java
└───src└───test└───java└───com└───example└───app│   AppTest.java

pom.xml：

<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.example</groupId><artifactId>my-app</artifactId><version>1.0-SNAPSHOT</version><packaging>jar</packaging><name>My Maven App</name><description>Example Maven Project</description><properties><maven.compiler.source>11</maven.compiler.source><maven.compiler.target>11</maven.compiler.target></properties><dependencyManagement><dependencies><dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.17.2</version></dependency></dependencies></dependencyManagement><dependencies><dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId></dependency><dependency><groupId>org.junit.jupiter</groupId><artifactId>junit-jupiter-api</artifactId><version>5.9.3</version><scope>test</scope></dependency></dependencies><repositories><repository><id>central</id><url>https://repo.maven.apache.org/maven2</url></repository></repositories><build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.8.1</version><configuration><source>11</source><target>11</target></configuration></plugin></plugins></build>
</project>

App.java：

java">package com.example.app;import com.fasterxml.jackson.databind.ObjectMapper;public class App {public static void main(String[] args) {ObjectMapper mapper = new ObjectMapper();System.out.println("Hello, Maven!");}
}

AppTest.java：

java">package com.example.app;import org.junit.jupiter.api.Test;import static org.junit.jupiter.api.Assertions.assertTrue;public class AppTest {@Testpublic void testApp() {assertTrue(true);}
}