我对maven有话说系列（一）pom.xml文件

学习任何一门技术，最好的方式就是参考官方手册，官方总比民间可信，这也是我们经常所说的相信官方。

maven的官方资料

1. maven的官网：http://maven.apache.org/index.html

2. maven依赖仓库：https://mvnrepository.com

maven的探索

一： pom.xml文件

     提到maven，不得不说pom.xml文件（pom: Project Object Model），我们经常称之为项目对象模型文件，通过在文件中定义标签，描述着项目的方方面面。

通过http://maven.apache.org/xsd/maven-4.0.0.xsd文件，可查看能在pom文件中声明的标签。

一个简单的pom文件大致如下：

<?xml version="1.0" encoding="UTF-8"?>
<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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    
    <parent>
        <groupId>com.stl</groupId>
        <artifactId>parent</artifactId>
        <version>1.0-SNAPSHOT</version>
        <relativePath/>
    </parent>

    <groupId>com.stl</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>demo</name>
    <description>Demo project for Spring Boot</description>

    <dependencies>
        <dependency>
            <groupId>com.stl</groupId>
            <artifactId>common</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>
    </dependencies>  

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
    
</project>

二： 标签及依赖的理解

在pom文件中我们通常可见如下标签：
1: < project>之< parent>标签

通过声明项目的父项目，可以继承父项目的项目声明，父项目的打包类型必须为pom。

2: < project>之< dependencies>之< dependency>标签

< project>之< dependencies>标签表示它所声明的是一个依赖组，每一个依赖我们可以通过< dependencies>中添加子标签< dependency>来声明，依赖可以从父项目继承。

一个依赖项dependency包含如下声明信息(见下图)，其中groupId、artifactId、version为必须项，通过这三项能很好的解释依赖属于哪一个组织、依赖的名称、依赖的版本。

3: < project>之< dependencyManagement>标签
    在maven中，依赖版本管理最好的方式是通过该标签管理，通过在该标签中声明依赖的版本，可以省去在< project>之< dependencies>中声明< dependency>时的< version>声明。

<dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
         <dependencies>
</dependencyManagement>

4: 插件依赖
    通过如下方式声明插件依赖，插件用于项目构建的每一项任务，如编译、打包、部署等

<build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>2.3.0.RELEASE</version>
            </plugin>
        </plugins>
    </build>

5：< project>之< pluginManagement>标签
    在maven中，插件版本管理最好的方式是通过该标签管理，通过在该标签中声明插件依赖的版本，可以省去在4: 插件管理添加插件时 < version>声明。

  <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.jetbrains.kotlin</groupId>
          <artifactId>kotlin-maven-plugin</artifactId>
          <version>${kotlin.version}</version>
          </plugin>
       </plugins>
       </pluginManagement>

三： 总结

    通过以上信息，知道了maven学习的官方文档，知道了依赖项的仓库，也可能初步掌握了一个简单的pom.xml文件等，当然这还远远不够，maven的探索之旅，进行中…