maven详细介绍-CSDN博客

常规
1

1.简介

Maven是一个基于项目对象模型（POM）的软件项目管理工具，主要用于Java项目的构建、依赖管理和项目信息管理。通过一小段描述信息，Maven能够管理项目的构建、报告和文档等各个环节。它提供了一种标准化的构建方式，使得项目的构建过程更加简单一致，极大地避免了不必要的学习成本，并促进了项目团队的标准化。
Maven不仅是一个构建工具，更是一个依赖管理工具。在Java项目开发中，往往需要引入大量的第三方库，而Maven通过自动管理这些依赖关系，极大地简化了项目的配置和管理。此外，Maven还提供了中央仓库，能够自动下载项目所需的构件，进一步简化了项目的构建过程。
除了构建和依赖管理，Maven还是一个项目信息管理工具。它能够管理原本分散在项目中各个角落的项目信息，包括项目描述、开发者列表、版本控制系统地址、许可证、缺陷管理系统地址等。这些信息通过Maven的配置文件进行管理，使得项目的交接和维护变得更加容易。

2.pom.xml文件概述

pom.xml是Maven项目的核心配置文件，全称为Project Object Model（项目对象模型），它使用XML格式来描述项目的基本信息、依赖关系、构建配置等。这个文件是Maven项目构建、依赖管理和版本控制等功能的基础。

以下是pom.xml文件的主要组成部分和概述：

  1. 项目基本信息：包括项目的名称、描述、组织信息、开发者信息等。这些信息对于项目的识别和交流非常重要。
  2. 依赖管理：在pom.xml中，可以定义项目所需的第三方库和模块，Maven会自动下载并管理这些依赖。这大大简化了依赖管理的过程，避免了手动下载和配置库的繁琐工作。
  3. 构建配置：pom.xml包含了构建项目所需的各种配置，如编译器版本、字符集、源代码目录、测试代码目录等。此外，还可以配置插件来执行特定的构建任务，如编译、测试、打包等。
  4. 版本控制：pom.xml中定义了项目的版本号，这对于项目的版本控制和发布非常重要。通过修改版本号，可以方便地管理和跟踪项目的不同版本。
  5. 仓库配置：在pom.xml中，可以配置项目的远程仓库和本地仓库，以管理项目的构建输出和依赖库。
  6. 环境配置：通过pom.xml中的profiles元素，可以为不同的环境配置不同的构建和依赖设置，以实现灵活的项目构建和管理。

3.pom.xml核心标签解析

pom.xml文件是Maven项目的核心，其中包含了定义项目构建、依赖、插件、目标平台和其他项目相关信息的标签。以下是pom.xml中一些核心标签的解析：

3.1. <project>

这是pom.xml文件的根元素，它包含了所有其他元素。<project>标签内部通常定义了项目的坐标、模型版本、包装类型等信息。

  • <modelVersion>: 指定POM模型版本，通常为4.0.0。
  • <groupId>: 定义项目属于哪个组，通常是公司或组织的唯一标识符。
  • <artifactId>: 定义项目的唯一ID，在组内唯一。
  • <version>: 定义项目的版本号。
  • <packaging>: 指定项目的打包类型，如jar、war、pom等。

3.2. <name>

项目的名称，通常用于生成文档和作为项目的人类可读标识符。

3.3. <description>

项目的简短描述，用于提供关于项目用途和功能的额外信息。

3.4. <url>

项目的官方网址，通常指向项目的网站或文档。

3.5. <dependencies>

包含项目所有依赖的列表。每个依赖都由<dependency>标签定义，并包含以下子标签：

  • <groupId>: 依赖的组ID。
  • <artifactId>: 依赖的项目ID。
  • <version>: 依赖的版本号。
  • <scope>: 依赖的范围，如compile、test、runtime等。

3.6. <build>

包含构建项目所需的所有配置。这个标签可以包含很多子标签，例如：

  • <sourceDirectory>: 源代码目录的位置。
  • <testSourceDirectory>: 测试源代码目录的位置。
  • <plugins>: 使用的插件列表。每个插件都由<plugin>标签定义，并包含插件的坐标和配置。

3.7. <properties>

定义可以在POM中重复使用的属性。这些属性可以在POM文件的任何地方通过${propertyName}的形式引用。

3.8. <modules>

对于多模块项目，这个标签列出了所有子模块的相对路径或目录名。

3.9. <repositories> 和 <pluginRepositories>

定义用于搜索项目依赖和插件的远程仓库。<repositories>用于项目依赖，而<pluginRepositories>用于Maven插件。

3.10. <distributionManagement>

配置项目部署相关信息，包括发布到远程仓库和快照仓库的设置。

3.11. <profiles>

定义项目的环境特定配置，如不同的构建环境或部署环境。每个<profile>可以包含激活条件、依赖、插件、属性等配置。

4.依赖管理标签

4.1. <dependencies>

这是包含所有项目依赖项的顶级标签。每个依赖项都由一个<dependency>标签定义。

4.2. <dependency>

这个标签用于定义一个具体的依赖项。它通常包含以下子标签：

  • <groupId>：定义依赖项所属的组织或项目的唯一标识符。
  • <artifactId>：定义依赖项的项目名称。
  • <version>：指定依赖项的版本号。

这三个标签组合起来构成了依赖项的坐标，Maven通过这些坐标在仓库中查找并下载依赖项。

4.3. <scope>

这个可选的标签定义了依赖项的作用范围，即它在哪些Maven生命周期阶段有效。常见的scope值包括：

  • compile：默认值，表示依赖项在项目的所有阶段都可用，包括编译、运行和打包。
  • test：表示依赖项仅在测试阶段有效，例如JUnit测试框架。
  • runtime：表示依赖项在编译时不需要，但在运行时需要。这通常适用于某些API的运行时实现。
  • provided：表示依赖项在编译和运行时都可用，但不应该被打包到最终的发布件中。这通常用于那些在运行环境中已经提供的库。

4.4. <exclusions>

有时，一个依赖项会传递性地引入其他不需要的依赖项。<exclusions>标签允许你排除这些传递性依赖。每个要排除的依赖项都由一个<exclusion>标签定义，其中包含<groupId>和<artifactId>来指定要排除的依赖项。

4.5. <dependencyManagement>

这个标签用于管理项目依赖项的版本，而不是直接引入依赖项。在<dependencyManagement>中定义的依赖项不会直接添加到项目中，但它们会影响子模块和传递性依赖的版本解析。这允许你在父POM中集中管理依赖项的版本，而无需在每个子模块中重复声明。

4.6.示例：

<dependencies>
    <dependency>
        <groupId>org.example</groupId>
        <artifactId>my-library</artifactId>
        <version>1.0.0</version>
        <scope>compile</scope>
        <exclusions>
            <exclusion>
                <groupId>unwanted-group</groupId>
                <artifactId>unwanted-artifact</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    <!-- 其他依赖项 -->
</dependencies>

<dependencyManagement>

<dependencies>

<dependency>

<groupId>org.example</groupId>

<artifactId>managed-library</artifactId>

<version>2.0.0</version>

</dependency>

<!-- 其他管理的依赖项 –>

</dependencies>

</dependencyManagement>


  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26

在这个示例中，my-library是项目直接依赖的库，并且排除了unwanted-group:unwanted-artifact这个传递性依赖。而managed-library则是在<dependencyManagement>中管理的依赖项，它不会直接添加到项目中，但会影响项目中的传递性依赖解析。

5.构建配置标签

在Maven的pom.xml文件中，构建配置是与项目构建过程相关的一组设置和指令。这些配置指定了如何编译、测试、打包和部署项目。以下是与构建配置相关的一些核心标签及其详解：

5.1. <build>

这是包含所有构建配置信息的顶级标签。

5.2. <sourceDirectory>

指定项目主源代码的位置。默认情况下，Maven会在src/main/java目录下查找源代码。

5.3. <testSourceDirectory>

指定项目测试源代码的位置。默认情况下，Maven会在src/test/java目录下查找测试代码。

5.4. <resources>

包含项目主资源的配置。资源是项目中非代码的文件，如配置文件、图像或文本文件。<resources>标签内可以包含多个<resource>标签，每个<resource>标签定义了一组资源的位置和其他设置。

5.5. <testResources>

与<resources>类似，但用于测试资源的配置。

5.6. <plugins>

这个标签包含构建过程中要使用的Maven插件的列表。每个插件都由一个<plugin>标签定义，并包含插件的坐标（groupId、artifactId和version）以及插件的特定配置。

5.7. <pluginManagement>

这个标签用于管理插件的版本和配置，而不是直接应用插件。在<pluginManagement>中定义的插件不会直接执行，但可以在<plugins>中通过简化的方式引用，从而继承在<pluginManagement>中定义的版本和配置。

5.8. <finalName>

指定构建产生的artifact的名称，不包括文件扩展名。例如，如果<finalName>设置为myapp，则生成的JAR文件将是myapp.jar。

5.9. <directory>

指定构建输出的目录，即target目录的位置。默认情况下，Maven会在项目根目录下的target目录中执行所有构建操作。

5.10示例：

<build>
    <sourceDirectory>src/main/java</sourceDirectory>
    <testSourceDirectory>src/test/java</testSourceDirectory>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
        </resource>
    </resources>
    <testResources>
        <resource>
            <directory>src/test/resources</directory>
        </resource>
    </testResources>
    <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>
            </configuration>
        </plugin>
        <!-- 其他插件 -->
    </plugins>
    <finalName>myapp</finalName>
</build>

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27

在这个示例中，<build>标签包含了源代码目录、测试源代码目录、资源目录、测试资源目录、插件配置以及构建输出的最终名称等构建配置信息。这些配置将指导Maven如何编译、测试和打包项目。

6.仓库与分发标签

6.1.仓库相关标签

6.1.1. <repositories>

这个标签用于定义项目依赖的远程仓库列表。每个远程仓库都由一个<repository>标签定义，包含仓库的ID、URL和其他可选配置。

6.1.2. <repository>

定义单个远程仓库的详细配置。通常包含id、url、name等子标签。

6.1.3. <pluginRepositories>

与<repositories>类似，但专门用于定义Maven插件的远程仓库。

6.1.4. <pluginRepository>

定义单个插件远程仓库的详细配置，与<repository>结构相似。

6.2.分发相关标签

6.2.1. <distributionManagement>

这个标签用于定义项目构建产物的分发配置，包括发布到哪个仓库、快照仓库的配置等。

6.2.2. <repository> (在<distributionManagement>内部)

定义发布项目构建产物到的仓库。通常包含id、url、name、uniqueVersion等配置。这里的id通常与在settings.xml中配置的服务器（server）ID相对应，以便进行身份验证。

6.2.3. <snapshotRepository> (在<distributionManagement>内部)

定义发布项目快照（snapshot）到的仓库。结构与<repository>相似。