Java小白-管理项目工具Maven（3）Ma

一、pom.xml文件

pom.xml 文件是 Maven（Apache Maven）项目的核心配置文件，它定义了项目的构建、依赖管理和项目元数据等信息。Maven 是一个流行的 Java 项目管理和构建自动化工具，而 pom.xml 是 Maven 项目中不可或缺的一部分。

pom.xml 文件中定义了项目所需的依赖库。Maven 会根据这些依赖配置自动下载并管理这些依赖库。依赖管理是 Maven 的核心功能之一，它使得开发者能够轻松地管理项目所需的外部库，而无需手动下载和配置。

二、坐标

1、Maven 坐标啥意思，能干啥

它用于唯一标识一个 Maven 项目或依赖。Maven 坐标由以下三个主要部分组成：groupId、artifactId 和 version。这三个部分共同定义了一个 Maven 项目的唯一身份。

Maven世界拥有大量构建，我们需要找一个用来唯一标识一个构建的统一规范，拥有了统一规范，就可以把查找工作交给机器

2、Maven 坐标的三个主要部分是啥

1. groupId

   • 作用：定义项目的组 ID，通常是一个反向域名，用于区分不同的项目或组织。

   • 示例：com.example。这表示项目属于 com.example 这个组织或公司。

   • 重要性：groupId 是项目所属组织的唯一标识，用于避免不同组织之间的项目名称冲突。

2. artifactId

   • 作用：定义项目的唯一标识符，通常是一个项目名称。

   • 示例：example-project。这表示项目名称为 example-project。

   • 重要性：artifactId 是项目在所属组织中的唯一标识，用于区分同一组织下的不同项目。

3. version

   • 作用：定义项目的版本号，用于区分不同版本的项目。

   • 示例：1.0.0。这表示项目当前的版本是 1.0.0。

   • 重要性：version 是项目版本的唯一标识，用于管理项目的不同版本，确保依赖的正确性。

 三、依赖

1、依赖的意义

• 代码复用：就好像我们组装车时都需要轮子，但是我们每次从橡胶、螺丝开始也太麻烦了，为了避免重复造轮子，提高开发效率，依赖允许开发者复用已有的代码库拿来使用
• 功能扩展：通过引入依赖，项目可以扩展新的功能，如数据库访问、Web 开发、安全性等。
• 版本管理：依赖管理工具可以帮助开发者管理不同版本之间的兼容性问题，确保项目稳定运行。
• 构建自动化：自动化构建工具可以自动下载和配置依赖，简化了构建过程。

2、依赖的使用

在 Maven 中，依赖通常在 pom.xml 文件的 <dependencies> 部分进行配置。

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <version>2.7.0</version>
    </dependency>
</dependencies>

3、第三方依赖的查找方法

• Maven 中央仓库：

  • Maven 中央仓库是最大的公共 Maven 仓库，包含了大量的开源项目和库。

  • 可以通过访问 Maven Central 搜索依赖。

• 项目文档：

  • 许多开源项目在其文档中会列出所需的依赖，可以直接从文档中获取依赖信息。

• IDE 插件：

  • 许多集成开发环境（IDE）如 IntelliJ IDEA、Eclipse 等，都提供了 Maven 插件，可以直接在 IDE 中搜索和添加依赖。

• 社区和论坛：

  • 在 Stack Overflow、GitHub 等社区和论坛中，可以找到关于特定依赖的讨论和推荐。

• 依赖管理工具：

  • 一些工具如 Spring Initializr 可以帮助快速生成包含所需依赖的 Spring Boot 项目。

• 版本管理工具：

  • 使用如 Semantic Versioning 等版本管理工具，可以帮助选择合适的依赖版本。

 四、依赖范围

• 是否传递：表示该依赖范围是否会传递给依赖于当前项目的其他项目。例如，如果一个 compile 范围的依赖引入了一个 runtime 范围的依赖，那么这个 runtime 范围的依赖也会被打包到最终的 JAR 文件中。

• 是否包含在最终构建中：表示该依赖范围是否包含在最终的构建产物中，如 JAR 文件或 WAR 文件。

• 典型用途：表示该依赖范围的典型使用场景。

1. compile

   • 默认的依赖范围。

   • 编译、测试和运行时都需要的依赖。

   • 会被打包到最终的 JAR 文件中。

2. provided

   • 编译和测试时需要，但运行时由容器或运行环境提供。

   • 不会被打包到最终的 JAR 文件中。

   • 适用于如 Servlet API 这样的依赖，它们在运行时由 Web 容器提供。

3. runtime

   • 编译时不需要，但测试和运行时需要的依赖。

   • 不会被打包到最终的 JAR 文件中。

   • 适用于如数据库驱动这样的依赖，它们在运行时需要，但在编译时不需要。

4. test

   • 仅在测试时需要的依赖。

   • 不会被打包到最终的 JAR 文件中。

   • 适用于如 JUnit 这样的测试框架。

5. system

   • 编译、测试和运行时都需要的依赖。

   • 需要手动指定依赖的本地路径。

   • 不推荐使用，因为它使得项目依赖于本地文件，降低了可移植性。

五、依赖传递和可选依赖

在Spring Boot项目中，依赖传递是Maven和Gradle等构建工具的一个重要特性。当一个项目依赖某个库时，这个库所依赖的其他库(传递依赖)也会自动被包含进来。

依赖传递的特点

1. ‌自动解析‌：构建工具会自动解析并下载所有传递依赖
2. ‌依赖树‌：可以通过mvn dependency:tree命令查看完整的依赖关系树
3. ‌版本仲裁‌：当多个依赖对同一库有不同版本要求时，构建工具会选择一个版本(通常是最新版本)

Spring Boot中的依赖管理

Spring Boot通过spring-boot-starter-parent或spring-boot-dependencies提供了依赖管理功能：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.1.0</version>
</parent>

这确保了所有Spring Boot相关依赖的版本兼容性。

可选依赖(Optional Dependencies)

可选依赖是一种标记机制，表示某个依赖不是项目运行所必需的。

可选依赖的特点

1. ‌不自动传递‌：标记为optional的依赖不会被自动传递给依赖当前项目的其他项目
2. ‌显式声明‌：使用方需要显式声明这些依赖
3. ‌适用场景‌：适用于只在特定环境下需要的依赖

在Maven中声明可选依赖

<dependency>
    <groupId>com.example</groupId>
    <artifactId>optional-library</artifactId>
    <version>1.0.0</version>
    <optional>true</optional>
</dependency>

实际应用场景

1. ‌数据库驱动‌：项目可能支持多种数据库，但用户只需要其中一种

   <dependency>
       <groupId>mysql</groupId>
       <artifactId>mysql-connector-java</artifactId>
       <optional>true</optional>
   </dependency>
   <dependency>
       <groupId>org.postgresql</groupId>
       <artifactId>postgresql</artifactId>
       <optional>true</optional>
   </dependency>
   

2. ‌特定功能模块‌：某些功能只在特定环境下需要

3. ‌测试依赖‌：测试相关的依赖通常不应传递到生产环境

依赖冲突解决

当出现依赖冲突时，可以：

1. 使用<exclusions>排除特定传递依赖

   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-web</artifactId>
       <exclusions>
           <exclusion>
               <groupId>com.fasterxml.jackson.core</groupId>
               <artifactId>jackson-databind</artifactId>
           </exclusion>
       </exclusions>
   </dependency>
   

2. 显式声明所需版本，覆盖传递依赖的版本

3. 使用Maven的dependencyManagement统一管理版本