project

Maven 是一个强大的构建和依赖管理工具，pom.xml 文件是 Maven 项目的核心配置文件，用于定义项目的构建、依赖关系、插件、目标等。它是 Maven 构建过程的基础，所有的构建配置都需要在该文件中进行定义。

project元素代表整个Maven项目，是POM文件中最外层的元素。

一个完整的 pom.xml 文件大致包括以下几个部分：

• 项目基础信息
• 组织与许可信息
• 自定义属性信息
• 模块配置
• 项目依赖配置
• Maven依赖仓库信息
• Maven插件仓库信息
• 构建配置
• 版本控制信息
• 分发信息
• 报告配置
• 环境配置

子元素分类

项目基础信息

元素名称	描述
parent	指定父POM文件的坐标，继承父项目的配置
modelVersion	POM模型的版本，通常为4.0.0
groupId	唯一标识项目的组织或公司名称
artifactId	唯一标识项目的模块名
name	项目的名称
version	项目的版本号
packaging	项目的打包类型，如jar、war、pom等
description	项目的简短描述
url	项目主页的URL地址
inceptionYear	项目开始年份

- parent

parent元素用于定义当前项目的父项目信息，即当前项目所在的模块继承自哪个模块。可被继承的信息包括但不限于：dependencies、plugins、build、reporting等。常用于项目中许多模块都存在共性配置的情况。

通过parent元素从父级POM文件继承属性，可以使子模块重用父级组件中定义的配置和元素等，同时方便子模块修改和覆盖继承的内容。

• 一个完整的parent元素应该至少包含两个必需的子元素：groupId和artifactId，分别表示父项目的groupId和artifactId。
• 另外，还可以使用version元素指定父项目的版本号。如果省略了版本，则Maven会自动搜索本地仓库和远程仓库以查找最新版本。

Maven先查找本地仓库，然后去中央仓库下载指定的父级artifactId和groupId的POM文件，通过继承父POM文件，可以避免在子模块中重复定义相同的属性。

属性：

• groupId：父项目的GroupId。
• artifactId：父项目的ArtifactId。
• version：定义继承自父级的版本号。
• relativePath：为确定父级POM的位置提供一个可选的相对路径。当该元素未定义时，默认从本地仓库和Maven中央仓库搜索。

继承父级的限制：

• 发布你自己的项目时，使用继承层次结构作为中心库不是一个好的设计选择。尽管这样做会更方便，但它强制了许多限制。
• 如果依赖于某个库，并且发现该库没有定义你需要的一些配置信息，那么你可以通过独立定义一个父级（调整相应的部分）点解决问题。
• 如果某个库的父级中的管理版本并不符合最新标准，而你又无法通知该项目的作者更新其父级，在这种情况下，你也可以独立地定义一个POM文件并继承自期望的目标。

示例：

1 2 3 4 5 6

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

- modelVersion

modelVersion元素指定当前POM文件的版本号，用于标识当前POM使用的Maven模型版本。如果该元素未被显式定义，并且当前POM文件是基于4.0.0或更高版本创建的，那么它将默认采用4.0.0版本。

modelVersion只能使用Maven支持的版本号。一旦确定了版本号，就应该始终使用相同的版本号，除非你有很好的理由来升级它。另外，如果你想要向后兼容其他版本的POM文件，可以保留旧版本并添加新属性，而不是更新现有元素。

示例：

1	<modelVersion>4.0.0</modelVersion>

- groupId

groupId 元素定义了该项目所属组织或公司的唯一标识符。它是 Maven 项目的全局唯一 ID，用于在仓库中标识项目和依赖项。

通常情况下，groupId 建议以组织或公司的域名倒置为前缀，这样做可避免命名空间冲突。

• groupId 的值不应包含空格或其他特殊字符，建议使用小写字母和连字符作为单词之间的分隔符。
• groupId 元素应当在 POM 文件中显式指定，并且一旦指定，在整个项目中不应发生更改，否则可能会引起各种不同的问题。
• maven 对于 groupId 是区分大小写的。因此，在同一个项目的不同模块中，如果将 groupId 写成了不同的大小写形式，可能会导致依赖模块的构建失败。因此，建议在整个项目中保持 groupId 的一致性。

示例：

1	<groupId>org.xxok.boot</groupId>

- artifactId

artifactId 元素是指当前Maven项目的唯一标识符，用于表示当前构建的项目。

artifactId 元素同样可以让其他依赖引用到它作为依赖的项目POM文件中。

假如项目B需要依赖A项目的jar包，则需要配置A项目的坐标（groupId、artifactId、version），Maven 就会检索并下载 A 项目的 jar 包来满足 B 项目的依赖关系。

示例：

1	<artifactId>my-project</artifactId>

- name

name元素定义项目名称。该元素是一个可选项，但强烈建议在每个POM中都使用它来描述当前项目，以便更容易地理解和识别项目的作用。在Maven生命周期、插件等其他各个地方，也会经常使用到该属性。

需要注意的是，在IDE或其他Maven工具中使用时，name元素可以帮助用户识别并区分不同的模块，以及帮助用户快速找到文档或其他相关信息。

示例：

1	<name>My App Name</name>

- version

version元素表示当前项目的版本号，它用于唯一标识项目和管理依赖项。

在Maven中，通常存在三种类型的版本号：

• SNAPSHOT：开发版本，表示还处于开发过程中，会随着开发的进行不断更新；
• RELEASE：稳定版本，表示已经完成开发工作，可以正式发布使用；
• 其他自定义版本号：根据具体需要自行指定。

version元素可以定义在以下几个位置：

• 外部父POM文件中的version元素：如果您正在使用一个外部的父POM来管理项目，那么版本号可以从那里定义。
• 项目自身的version元素：如果您没有使用一个外部的父POM，那么您可以在项目自身的pom.xml文件中定义版本号。
• 依赖项中的version元素：在项目的依赖项中也可以指定版本号。优先级最高的是直接在依赖项中指定的版本号，其次是继承自父POM文件、再次是项目自身定义的版本号。

示例：

1	<version>1.0-SNAPSHOT</version>

- packaging

packaging元素指定了项目打包的类型。

packaging的可选值：

• jar：以JAR形式打包，默认值
• war：以Web应用程序形式打包
• ear：以Enterprise应用程序形式打包
• pom：仅作为依赖项存在，不生成输出文件

Maven将按照packaging元素指定的类型对项目进行打包，并将输出内容保存到目标目录中（默认为target目录）。

- description

description元素用于描述该项目的简短说明。description元素并不影响项目的构建和部署过程，只是作为一个文本描述的附加信息存在。

通常情况下，description元素紧随groupId、artifactId和version元素之后，位于pom.xml文件的顶部。

示例：

1	<description>This project description</description>

- url

url元素用于指定项目的URL地址。 该元素通常用于指定项目主页、文档位置或者源代码仓库的地址等。

示例：

1	<url>https://github.com/username/projectname</url>

- inceptionYear

inceptionYear元素代表了项目的创建年份。

示例：

1	<inceptionYear>2010</inceptionYear>

组织与许可信息

元素名称	描述
organization	项目的组织信息，如公司或开发者团队
licenses	项目所使用的开源许可证信息
developers	项目开发人员的列表
contributors	提供贡献但未参与开发的人员列表
mailingLists	项目的邮件讨论列表

- organization

organization元素代表了项目所属的组织信息。

这个元素是可选的，主要用作标识项目所属机构的相关信息，例如组织名称、组织URL等。如果指定了organization元素，Maven会使用该信息生成默认的开发者和组织元素。

示例：

1 2 3 4

<organization>     <name>ACME Corporation</name>     <url>http://www.acme.com</url> </organization>

- licenses

licenses元素用于指定项目相关的许可证信息。

该元素通常包含多个license元素，每个license元素对应一个许可证信息。

示例：

1 2 3 4 5 6 7 8

<licenses>     <license>       <name>The Apache Software License, Version 2.0</name>       <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>       <distribution>repo</distribution>     </license>     ... </licenses>

- developers

developers元素用于列出项目的开发者和其联系方式。

通常情况下，developers元素紧随description元素之后，位于pom.xml文件的顶部。developers元素提供的信息不会直接影响项目的构建和部署过程，只是作为一个文本描述的附加信息存在。

示例：

1 2 3 4 5 6 7 8 9 10 11 12

<developers>   <developer>     <id>john_doe</id>     <name>John Doe</name>     <email>john.doe@example.com</email>   </developer>   <developer>     <id>jane_doe</id>     <name>Jane Doe</name>     <email>jane.doe@example.com</email>   </developer> </developers>

- contributors

contributors元素可以用来列举该项目的贡献者列表。元素可以包含多个contributor元素。

每个contributor元素应该至少包含name元素用于指定贡献者的姓名或昵称，可选地，还可以包含email、url和organization等子元素以提供更详细的贡献者信息。

示例：

1 2 3 4 5 6 7 8 9 10 11 12

<contributors>     <contributor>       <name>John Doe</name>       <email>johndoe@example.com</email>       <url>http://example.com</url>       <organization>Acme Organization</organization>       <organizationUrl>http://acme.org</organizationUrl>     </contributor>     <contributor>       <name>Jane Smith</name>     </contributor>   </contributors>

- mailingLists

mailingLists元素用于指定项目相关的邮件列表信息。该元素通常包含多个mailingList元素，每个mailingList元素对应一个邮件列表信息。

通常情况下，mailingLists元素紧随developers元素之后，位于pom.xml文件的顶部。mailingLists元素提供的信息不会直接影响项目的构建和部署过程，只是作为一个文本描述的附加信息存在。

示例：

1 2 3 4 5 6 7 8 9

<mailingLists>   <mailingList>     <name>Developers List</name>     <subscribe>dev-subscribe@example.com</subscribe>     <unsubscribe>dev-unsubscribe@example.com</unsubscribe>     <post>dev-post@example.com</post>     <archive>http://example.com/mailman/private/dev-list/</archive>   </mailingList> </mailingLists>

自定义属性信息

元素名称	描述
properties	定义项目使用的自定义属性，供整个项目使用

- properties

properties元素用于定义一些可以在该POM及其子项目中重复引用的常量值。该元素通常包含各种 key-value对，其中key代表属性的名称，value代表属性所表示的常量值。

需要注意的是，properties元素的定义仅仅是对属性进行了声明或赋值，并没有定义这些属性具体用于什么目的。确切的属性用途，要依据实际情况而定。

示例：

1 2 3

<properties>   <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties>

除此之外，Maven还有很多内置的属性。

Maven内置属性：

属性名	描述
${project.version}	当前项目的版本号
${project.groupId}	当前项目的组 ID
${project.artifactId}	当前项目的 artifactId
${project.name}	当前项目的名称
${project.description}	当前项目的描述
${project.url}	当前项目的网址（主页）
${project.build.directory}	构建输出目录，默认是 target
${project.build.outputDirectory}	编译后的 .class 文件输出目录
${project.build.finalName}	构建后生成的最终文件名（通常是 <artifactId>-<version>）
${project.build.sourceDirectory}	源代码目录，默认是 src/main/java
${project.build.testSourceDirectory}	测试代码目录，默认是 src/test/java
${maven.version}	当前使用的 Maven 版本号
${maven.home}	Maven 的安装目录
${basedir}	项目的根目录路径，通常与 pom.xml 文件所在目录相同
${user.home}	当前用户的主目录路径
${env.<variable>}	获取系统环境变量的值，例如 ${env.PATH} 获取 PATH 环境变量
${project.build.plugins}	当前项目的构建插件
${project.build.pluginManagement}	项目中插件管理部分
${session}	当前 Maven 构建会话对象
${settings.localRepository}	本地 Maven 仓库的路径
${settings.userSettingsFile}	用户的 Maven 配置文件路径（~/.m2/settings.xml）
${settings.globalSettingsFile}	全局 Maven 配置文件路径
${project.basedir}	项目的根目录路径
${project.compileSourceRoots}	编译源文件的根目录列表
${project.testCompileSourceRoots}	测试源文件的根目录列表
${project.testOutputDirectory}	测试编译输出目录
${project.reporting.outputDirectory}	项目报告输出目录（默认 target/site）
${build.timestamp}	构建时间戳，表示构建时间（如 yyyyMMdd-HHmm 格式）
${project.reporting.pluginGroups}	报告插件的组 ID
${project.build.extensions}	项目的构建扩展
${project.distModule}	项目的分发模块信息
${project.testPlugin}	项目的测试插件信息
${project.version}	当前项目的版本号
${project.artifactId}	当前项目的 artifactId
${project.parent.version}	父项目的版本号（如果存在父项目的话）
${project.parent.groupId}	父项目的 Group ID
${project.parent.artifactId}	父项目的 Artifact ID
${project.parent.relativePath}	父项目的 pom.xml 相对路径

模块配置

元素名称	描述
modules	列出项目包含的子模块列表

- modules

modules元素用于指定一个多模块项目的子模块列表。可以包含多个module元素。

每个module元素应该只包含一个子元素：一个目录名或相对路径（默认相对于父项目的pom.xml文件）。当使用mvn命令执行某个多模块项目时，Maven会根据modules元素列出的子模块进行构建。

示例：

1 2 3 4 5

<modules>     <module>module-a</module>     <module>module-b</module>     <module>module-c</module>   </modules>

项目依赖配置

元素名称	描述
dependencyManagement	统一管理项目依赖版本，避免版本冲突
dependencies	项目运行所需的外部依赖库

- dependencyManagement

dependencyManagement元素提供了一种集中式管理依赖项版本号的机制。该元素包含各种子元素，用于指定项目使用的各种依赖项及其版本。

示例：

1 2 3 4 5 6 7 8 9 10 11

<dependencyManagement>   <dependencies>     <dependency>       <groupId>junit</groupId>       <artifactId>junit</artifactId>       <version>4.13.1</version>       <scope>test</scope>     </dependency>     <!-- ... -->   </dependencies> </dependencyManagement>

需要注意的是，dependencyManagement元素中的依赖项声明并没有直接使用在项目中，他只是定义了版本和相关配置信息，以供项目的其他模块继承使用。

- dependencies

dependencies元素用于列出项目所依赖的外部库，也就是所谓的“依赖项”。该元素可以包含多个dependency元素。

dependency元素：

• 一个完整的dependency元素应该至少包括groupId、artifactId和version三个必需的子元素。
• 当使用Maven构建项目时，它会根据这些元素自动从仓库下载对应的依赖包到本地存储库中。

dependency的子元素：

• groupId：依赖项所属的组织或公司的唯一标识符。
• artifactId：依赖项的名称，通常由项目名和模块名组成。
• version：依赖项的版本号。
• scope：依赖项的作用范围，可选值包括compile、provided、runtime、test等。
• type：依赖项的类型，默认为jar。
• classifier：用于区分同一artifactId和version下不同的构建版本。
• optional：指定是否将该依赖项传递给项目的依赖项。
• exclusions：用于排除掉某个依赖项的传递依赖项。

示例：

1 2 3 4 5 6 7 8 9 10 11 12 13

<dependencies>     <dependency>       <groupId>org.springframework</groupId>       <artifactId>spring-core</artifactId>       <version>5.2.9.RELEASE</version>     </dependency>     <dependency>       <groupId>junit</groupId>       <artifactId>junit</artifactId>       <version>4.13.1</version>       <scope>test</scope>     </dependency>   </dependencies>

Maven依赖仓库信息

元素名称	描述
repositories	定义项目依赖的Maven仓库

- repositories

repositories元素用于定义该项目依赖库（dependency）从哪里下载，以及下载顺序。该元素主要包含了一组子元素，用于指定各种资源库。该元素可以包含多个repository元素。

repository元素：

repository元素用于指定Maven项目的远程仓库信息。repository元素应该至少包含一个id、name和url子元素。

• id：仓库ID，用于唯一标识该仓库。
• name：仓库名称，用于描述该仓库。
• url：仓库URL，指向存储依赖项的远程仓库地址。

多数情况下，Maven会自动下载所需的依赖项，因为它能够从本地仓库中找到这些依赖项。当然，如果某个依赖项需要从远程仓库下载，那么就需要先配置好这些仓库。

示例：

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

<repositories>   <repository>     <id>central</id>     <url>https://repo1.maven.org/maven2/</url>   </repository>   <repository>     <id>jboss</id>     <name>JBoss Repository</name>     <url>https://repository.jboss.org/nexus/content/groups/public/</url>   </repository>   <repository>     <id>snapshots</id>     <name>Maven Snapshots</name>     <url>https://oss.sonatype.org/content/repositories/snapshots/</url>     <releases>       <enabled>false</enabled>     </releases>     <snapshots>       <enabled>true</enabled>     </snapshots>   </repository> </repositories>

使用maven中央仓库作为主要软件库，并添加了其他两个外部仓库

• 第一个repository元素指定了默认的中央仓库。
• 第二个repository元素是一个JBoss库，它只有元数据（pom），将无法下载包。
• 第三个repository元素是一个Sonatype的快照库，其中配置了禁用发布版本和启用快照版本支持。

需要注意的是，不必在每个pom.xml文件中都重新定义库。实际上你可以在Maven settings.xml文件中定义多个公共库(central、jcenter等), 项目会继承这些已定义的库。

Maven插件仓库信息

元素名称	描述
pluginRepositories	定义Maven插件的仓库

- pluginRepositories

pluginRepositories元素用于定义该项目使用到的插件库（plugins）从哪里下载以及下载顺序。

和repositories元素非常相似，pluginRepositories主要包含了一组子元素，用于指定各种插件资源库。该元素可以包含多个pluginRepository元素。

pluginRepository元素：

pluginRepository元素与repository 元素中的功能类似，pluginRepository 元素用于指定Maven插件库的位置。pluginRepository 元素可以包含以下子元素:

• id: 插件仓库ID，用于唯一标识该仓库。
• name: 插件仓库名称，用于描述该仓库。
• url: 插件仓库URL，指向存储插件的远程仓库地址。

示例：

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

<pluginRepositories>   <pluginRepository>     <id>central</id>     <url>https://repo1.maven.org/maven2/</url>   </pluginRepository>   <pluginRepository>     <id>jboss</id>     <name>JBoss Repository</name>     <url>https://repository.jboss.org/nexus/content/groups/public/</url>   </pluginRepository>   <pluginRepository>     <id>snapshots</id>     <name>Maven Snapshots</name>     <url>https://oss.sonatype.org/content/repositories/snapshots/</url>     <releases>       <enabled>false</enabled>     </releases>     <snapshots>       <enabled>true</enabled>     </snapshots>   </pluginRepository> </pluginRepositories>

使用maven中央仓库作为主要插件库，并添加了外部插件库

• 第一个pluginRepository元素指定了默认的中央仓库。
• 第二个pluginRepository元素是一个JBoss库，它只有元数据（pom），将无法下载包。
• 第三个pluginRepository元素是一个Sonatype的快照库，其中配置了禁用发布版本和启用快照版本支持。

需要注意的是，同样地，不必在每个pom.xml文件中都需要重新定义插件库。你可以在Maven settings.xml文件中定义多个公共库(central、jcenter等), 项目会继承这些已定义的库。

构建配置

元素名称	描述
build	定义项目的构建过程，包括插件和生命周期

- build

build元素用于配置一个项目的构建选项，主要包括了项目所依赖的插件、资源文件等构建相关信息。可以包含多个子元素，如plugins、resources等。

元素	描述	默认值
sourceDirectory	指定 Java 源代码的目录。	src/main/java
scriptSourceDirectory	指定脚本文件（如 Groovy）源代码的目录。
testSourceDirectory	指定测试源代码的目录。	src/test/java
outputDirectory	指定编译后的 .class 文件的输出目录。	target/classes
testOutputDirectory	指定测试编译后的 .class 文件的输出目录。	target/test-classes
finalName	指定最终构建文件的名称（不带扩展名）。	${project.artifactId}-${project.version}
resources	指定资源文件目录，资源文件会被复制到构建输出目录。
plugins	配置构建插件，用于处理具体的构建任务。
pluginManagement	集中管理插件的版本和配置。插件配置在此元素下不会直接生效，需在 plugins 元素中引用。
extensions	指定 Maven 构建过程中的扩展（如插件扩展）。
pluginRepositories	指定插件仓库的位置。
directory	为 Maven 指定其他目录，如编译文件夹、测试文件夹等。

• plugins：插件相关配置，指定插件及插件内容，例如：

  • plugin：指定具体插件名称。
    • groupId：插件所在组 ID
    • artifactId：插件 ID
    • version：插件版本号
    • executions：插件执行的配置，定义插件的生命周期绑定。
    • configuration：指定插件的具体参数和设置。

• resources：用于指定项目中使用的资源文件，通常包括属性文件、XML 配置文件和 Spring 配置文件等。

  • resource：表示项目主要的资源路径。
    • directory：资源文件所在的目录路径。
    • includes：包含的资源文件路径模式，支持通配符。
    • excludes：排除的资源文件路径模式，支持通配符。
    • filtering：是否对资源文件进行过滤（如替换 ${} 占位符）。默认为 false。
    • targetPath：指定资源文件在构建输出目录中的目标路径。
    • encoding：资源文件的编码方式。默认为平台相关编码。
    • items：指定一个或多个资源项，进一步定义资源文件的行为。
    • nonFiltered：指定不进行过滤的资源文件路径模式。

示例：

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

<build>     <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>       <plugin>         <groupId>org.springframework.boot</groupId>         <artifactId>spring-boot-maven-plugin</artifactId>       </plugin>     </plugins>     <resources>       <resource>         <directory>src/main/resources</directory>         <includes>           <include>**/*.properties</include>           <include>**/*.xml</include>         </includes>       </resource>     </resources>   </build>

• 定义了两个插件：maven-compiler-plugin和spring-boot-maven-plugin，并配置了maven-compiler-plugin的源代码和目标代码版本为1.8。
• 指定了使用src/main/resources目录下的.properties和.xml文件作为项目资源文件。

版本控制信息

元素名称	描述
scm	配置源代码管理系统（如Git、SVN）的信息

- scm

scm元素用于定义一个项目的源代码管理（SCM）信息，以便Maven可以从这个仓库中检索和构建代码。

一个完整的scm元素至少应该包括两个必需的子元素：connection和developerConnection，它们分别表示开发者与版本控制库之间的连接方式。另外，还可以使用url、tag、branch等其他子元素进一步指定SCM信息。

scm子元素：

• connection：源代码仓库的连接 URL，用于从 SCM 获取元数据。
• developerConnection：开发者用来推送代码的连接 URL，通常是私有的。
• url：公开的源代码仓库访问 URL，通常用于查看源代码。
• tag：源代码仓库中的标签，标识一个特定的版本。
• branch：源代码仓库中的分支名称，表示开发或发布的分支。
• commit：指定源代码的某个特定提交（哈希值），确保构建时使用正确的代码。
• checkoutDirectory：源码检出的目录路径，默认是项目根目录，指定了检出源代码的具体路径。

SCM的用途：

• 通过指定源代码的版本控制系统信息，使得其他开发者能够更轻松地将项目检出到本地环境中，并参与项目的开发。
• 在项目构建期间，Maven可以利用SCM配置来自动从版本控制系统中获取源代码，并构建项目。
• 通过指定版本控制系统的分支或标签信息，Maven可以构建特定版本的项目，从而方便项目的发布和部署。
• SCM配置还可以用于指定版本控制系统的URL，以便Maven可以自动地为项目生成构建信息和版本号等元数据，这些信息对于跟踪和管理项目非常重要。

示例：

1 2 3 4 5 6

<scm>   <connection>scm:git:git://github.com/user/repo.git</connection>   <developerConnection>scm:git:ssh://github.com/user/repo.git</developerConnection>   <url>https://github.com/user/repo/tree/master</url>   <tag>1.0.0</tag> </scm>

上述代码中，定义了一个基于Git的源代码管理信息。

其中，connection元素通过https协议指定了与代码库的连接方式，而developerConnection元素则通过ssh协议进行连接。除此之外，还指定了代码库的URL（即主页地址）以及打标签时使用的默认tag。

分发信息

元素名称	描述
distributionManagement	配置项目的分发方式，如发布到Maven仓库或其他服务

- distributionManagement

• distributionManagement元素用于管理您构建后部署(或发布)到哪里。该元素中包含了各种子元素，用于指定项目的发行版本部署(或发布)相关配置。
• distributionManagement元素只是用于管理项目的分发版本部署(或发布)的相关配置，而不会影响项目的编译和构建过程。

示例：

1 2 3 4 5 6 7

<distributionManagement>   <repository>     <id>internal.repo</id>     <name>Internal Repository</name>     <url>file:///usr/local/repo</url>   </repository> </distributionManagement>

在上面的示例中，我们声明了一个名为"Internal Repository"的仓库，其地址为本地文件系统上的/usr/local/repo目录。

一旦定义了这个仓库之后，可以使用命令 mvn deploy 将此存储库作为项目的部署目标，在构建过程中上传并部署项目至该存储库。

报告配置

元素名称	描述
reporting	配置如何生成项目报告，如代码质量报告、测试报告等

- reporting

reporting元素用于为项目生成一些报告，例如代码覆盖率、静态代码分析结果等。该元素可以包含各种子元素，来配置需要生成哪些报告，以及如何生成这些报告。

reporting元素只是用于配置Maven生成报告的相关信息，它不影响项目的编译和构建过程，并且生成的报告通常是基于已经构建好的代码来进行分析处理的。

示例：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

<reporting>   <plugins>     <plugin>       <groupId>org.jacoco</groupId>       <artifactId>jacoco-maven-plugin</artifactId>       <version>0.8.6</version>     </plugin>     <plugin>       <groupId>org.sonarsource.scanner.maven</groupId>       <artifactId>sonar-maven-plugin</artifactId>       <version>3.9.0.2155</version>     </plugin>     <!-- ... -->   </plugins> </reporting>

在上面的示例中，我们定义了两个插件，分别是Jacoco和SonarQube。通过使用这些插件，Maven可以生成有关代码覆盖率、静态代码分析的报告。其他可供选择的报告插件包括FindBugs、Checkstyle、Javadoc等。

环境配置

元素名称	描述
profiles	定义不同构建环境下的配置文件，可根据需求启用不同的构建配置

- profiles

profiles元素用于定义一个或多个构建“配置”（profile），这些配置与通常的构建选项不同，能够根据不同的环境、需求等情况进行灵活地管理不同构建环境下的项目配置和依赖项。

profile

一个profile元素可以包含多个子元素，如id、activation、properties、dependencies等，每个子元素又可以包含具体的配置信息。

• id（名称）：必需，用于给对应的构建配置指定一个名称。
• activation（激活条件）：用于指定触发profile的条件，如：系统属性、JDK版本、Maven版本、操作系统等。
• properties（属性）：定义profile中使用的属性值。这些属性可以被其他元素引用，以便在不同的环境下使用不同的值。
• dependencies（依赖）：指定与profile相关的依赖项。这些依赖项仅在激活profile时才会被添加到项目中。
• dependencyManagement（依赖管理）：类似于dependencies，但是它只定义依赖版本号，而不引入实际依赖。
• build（构建）：用于定义与profile相关的构建设置，例如编译器版本、打包方式等。
• reporting（报告）：指定生成报告时使用的插件和配置。
• modules（模块）：定义特定的modules，这些modules仅在激活profile时才会被构建。
• repositories（仓库）：指定与profile相关的仓库配置。

在POM文件中定义了Profile元素之后，可以根据所需的构建环境激活或禁用它们。

要激活Profile元素，可以使用命令行选项、环境变量或其他Maven插件来指定所需的Profile。例如，使用“-P production”命令可以激活包含“production”Profile的POM文件。

示例：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

<profiles>     <profile>       <id>development</id>       <activation>         <activeByDefault>true</activeByDefault>       </activation>       <properties>         <jdbc.driverClassName>com.mysql.jdbc.Driver</jdbc.driverClassName>       </properties>       <dependencies>         <dependency>           <groupId>mysql</groupId>           <artifactId>mysql-connector-java</artifactId>           <version>8.0.23</version>         </dependency>       </dependencies>     </profile>   </profiles>

上述代码中，定义了一个名为development的构建配置，启动该配置的条件为默认激活（activeByDefault）。该配置使用MySQL驱动程序作为依赖项，并设置了jdbc.driverClassName属性值，以便在开发环境中使用正确的数据库连接驱动。