POM文件详解

Posted 2020-08-28 Joyson

POM文件详解

<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/maven-v4_0_0.xsd ">

1      Parent坐标

<!-- 父项目的坐标。如果项目中没有规定某个元素的值，那么父项目中的对应值即为项目的默认值。 坐标包括group ID，artifact ID和 version。 -->

<parent>

<!-- 被继承的父项目的构件标识符 -->

<artifactId />

<!-- 被继承的父项目的全球唯一标识符 -->

<groupId />

<!-- 被继承的父项目的版本 -->

<version />

<!-- 父项目的pom.xml文件的相对路径。相对路径允许你选择一个不同的路径。默认值是../pom.xml。Maven首先在构建当前项目的地方寻找父项目的pom，其次在文件系统的这个位置（relativePath位置），然后在本地仓库，最后在远程仓库寻找父项目的pom。 -->

<relativePath />

</parent>

2      项目基本属性

<!-- 声明项目描述符遵循哪一个POM模型版本。模型本身的版本很少改变，虽然如此，但它仍然是必不可少的，这是为了当Maven引入了新的特性或者其他模型变更的时候，确保稳定性。 -->

<modelVersion> 4.0.0 </modelVersion>

<!-- 项目的全球唯一标识符，通常使用全限定的包名区分该项目和其他项目。并且构建时生成的路径也是由此生成， 如com.mycompany.app生成的相对路径为：/com/mycompany/app -->

<groupId> asia.banseon </groupId>

<!-- 构件的标识符，它和group ID一起唯一标识一个构件。换句话说，你不能有两个不同的项目拥有同样的artifact ID和groupID；在某个特定的group ID下，artifact ID也必须是唯一的。构件是项目产生的或使用的一个东西，Maven为项目产生的构件包括：JARs，源码，二进制发布和WARs等。 -->

<artifactId> banseon-maven2 </artifactId>

<!-- 项目产生的构件类型，例如jar、war、ear、pom、bundle。插件可以创建他们自己的构件类型，所以前面列的不是全部构件类型 -->

<packaging> jar </packaging>

<!-- 项目当前版本，格式为:主版本.次版本.增量版本-限定版本号 -->

<version> 1.0-SNAPSHOT </version>

<!-- 项目的名称, Maven产生的文档用 -->

<name> banseon-maven </name>

<!-- 项目主页的URL, Maven产生的文档用 -->

<url> http://www.baidu.com/banseon </url>

<!-- 项目的详细描述, Maven 产生的文档用。 当这个元素能够用html格式描述时（例如，CDATA中的文本会被解析器忽略，就可以包含HTML标签）， 不鼓励使用纯文本描述。如果你需要修改产生的web站点的索引页面，你应该修改你自己的索引页文件，而不是调整这里的文档。 -->

<description> A maven project to study maven. </description>

3      项目依赖

<!-- 该元素描述了项目相关的所有依赖。 这些依赖组成了项目构建过程中的一个个环节。它们自动从项目定义的仓库中下载。要获取更多信息，请看项目依赖机制。 -->

<dependencies>

<dependency>

<!-- 依赖的group ID -->

<groupId> org.apache.maven </groupId>

<!-- 依赖的artifact ID -->

<artifactId> maven-artifact </artifactId>

<!-- 依赖的版本号。 在Maven 2里, 也可以配置成版本号的范围。 -->

<version> 3.8.1 </version>

<!-- 依赖类型，默认类型是jar。它通常表示依赖的文件的扩展名，但也有例外。一个类型可以被映射成另外一个扩展名或分类器。类型经常和使用的打包方式对应，尽管这也有例外。一些类型的例子：jar，war，ejb-client和test-jar。如果设置extensions为 true，就可以在plugin里定义新的类型。所以前面的类型的例子不完整。 -->

<type> jar </type>

<!-- 依赖的分类器。分类器可以区分属于同一个POM，但不同构建方式的构件。分类器名被附加到文件名的版本号后面。例如，如果你想要构建两个单独的构件成JAR，一个使用Java 1.4编译器，另一个使用Java 6编译器，你就可以使用分类器来生成两个单独的JAR构件。 -->

<classifier></classifier>

<!-- 依赖范围。在项目发布过程中，帮助决定哪些构件被包括进来。欲知详情请参考依赖机制。

- compile ：默认范围，用于编译

 

- provided：类似于编译，但支持你期待jdk或者容器提供，类似于classpath

 

- runtime: 在执行时需要使用

 

- test: 用于test任务时使用

 

- system: 需要外在提供相应的元素。通过systemPath来取得

 

- systemPath: 仅用于范围为system。提供相应的路径

 

- optional: 当项目自身被依赖时，标注依赖是否传递。用于连续依赖时使用 -->

<scope> test </scope>

<!-- 仅供system范围使用。注意，不鼓励使用这个元素，并且在新的版本中该元素可能被覆盖掉。该元素为依赖规定了文件系统上的路径。需要绝对路径而不是相对路径。推荐使用属性匹配绝对路径，例如${java.home}。 -->

<systemPath></systemPath>

<!-- 当计算传递依赖时， 从依赖构件列表里，列出被排除的依赖构件集。即告诉maven你只依赖指定的项目，不依赖项目的依赖。此元素主要用于解决版本冲突问题 -->

<exclusions>

<exclusion>

<artifactId> spring-core </artifactId>

<groupId> org.springframework </groupId>

</exclusion>

</exclusions>

<!-- 可选依赖，如果你在项目B中把C依赖声明为可选，你就需要在依赖于B的项目（例如项目A）中显式的引用对C的依赖。可选依赖阻断依赖的传递性。 -->

<optional> true </optional>

</dependency>

</dependencies>