Maven POM 模型

在上一節(jié)當中，我們使用 Maven 創(chuàng)建了我們的第一個項目，今天我們來介紹一下 Maven 中重要的概念 POM 模型。

1. POM 模型

1.1 什么是 POM？

POM（項目對象模型）是 Maven 最基本，也是非常重要的一個概念。通常情況下，我們可以看到 POM 的表現(xiàn)形式是 pom.xml，在這個 XML 文件中定義著關(guān)于我們工程的方方面面，當我們想要通過 Maven 命令來進行操作的時候，例如：編譯，打包等等，Maven 都會從 pom.xml 文件中來讀取工程相關(guān)的信息。

1.2 查看項目結(jié)構(gòu)

我們在 cmd 中打開項目根目錄，執(zhí)行 tree /f 命令?？梢钥吹饺缦聢D的項目結(jié)構(gòu)：

• 每個項目都有一個 pom.xml 文件，該文件中定義本項目的對象模型，描述本項目，配置插件，聲明依賴；
• 對于簡單的 Maven 項目，src/main 目錄放置項目的源碼和資源文件，一般情況下，源碼放置在 Java 目錄下，App.java 就是 Maven Archtype 插件生成的一個簡單類，classpath 資源文件放置在resources 目錄下。
• src/test 目錄下放置我們的測試用例，與 main 目錄類似，src/test/java 目錄下放置我們的測試類源碼，AppTest.java 則是 Maven Archtype 插件生成的一個簡單測試類，src/test/resources 放置測試用到的 classpath 資源文件。

注： 這里 Maven 只是幫我們創(chuàng)建了一個簡單的 Maven 項目，其中 resources 目錄則需要手動創(chuàng)建。

1.2 查看項目 pom.xml 文件

我們打開項目中的 pom.xml 文件，如下圖：

現(xiàn)在看到的這個 pom.xml 是 Maven 項目中最基礎(chǔ)的 POM，后面隨著項目的慢慢的進行，這個 pom.xml會變得更加復(fù)雜，我們可以向其中添加更多的依賴，也可以在里面配置我們需要的插件。

從頭開始看：groupId，artifactId，packaging，version 幾個元素是 Maven 的坐標，用來唯一標識一個項目。

接下來是 name，url 這兩個元素則是用來描述信息，給人更好的可讀性。

最后是 dependencies，這里 Maven 默認依賴了 3.8.1 版本的 junit，其中 scope 用來標記該依賴的范圍為 test。

1.3 Maven 的坐標

接下來我們就重點介紹一下 Maven 的坐標（Coordinates）。

• groupId：groupId 為我們組織的逆向域名，這里的組織可以是公司，團體，小組等等。例如Apache 基金會的項目都是以 org.apache 來作為 groupId 的；

• artifactId：該組織下，項目的唯一標識；

• packaging：項目類型，描述的是項目在打包之后的輸出結(jié)果，常見的 jar 類型的輸出結(jié)果是一個jar 包，war 類型則輸入 war 包，一般 Web 項目的打包方式為 war。

• version：項目的版本號，用來標記本項目的某一特定版本。SNAPSHOT 則是用來標記項目過程中的快照版本，該版本類型表明本項目不是穩(wěn)定版本，常見的還有 RELEASE，則表示該版本為本項目的穩(wěn)定版本。

2. 超級 POM

在我們這個項目的 pom.xml 文件中，只有短短的幾行信息，但是這就全部嗎？其實不然。

在 Maven 的世界中，存在著一個超級 POM（super POM），所有通過 Maven 創(chuàng)建的項目，其 pom.xml 文件都會繼承這個超級 POM。所以在默認情況下，使用 Maven 創(chuàng)建出來的項目基本上都是很類似的。

那么這個超級 POM 在哪呢？長什么樣呢？

2.1 超級 POM 路徑位置

如下圖，先找到指定的 jar 包，路徑：.\apache-maven-3.6.3\lib\maven-model-builder-3.6.3.jar：

然后我們可以使用解壓工具查看該 jar 包，找到對應(yīng)的 pom.xml。

具體路徑：org\apache\maven\model\pom-4.0.0.xml。

2.2 查看超級 POM 結(jié)構(gòu)

<project>
  <modelVersion>4.0.0</modelVersion>

  <repositories>
    <repository>
      <id>central</id>
      <name>Central Repository</name>
      <url>https://repo.maven.apache.org/maven2</url>
      <layout>default</layout>
      <snapshots>
        <enabled>false</enabled>
      </snapshots>
    </repository>
  </repositories>

  <pluginRepositories>
    <pluginRepository>
      <id>central</id>
      <name>Central Repository</name>
      <url>https://repo.maven.apache.org/maven2</url>
      <layout>default</layout>
      <snapshots>
        <enabled>false</enabled>
      </snapshots>
      <releases>
        <updatePolicy>never</updatePolicy>
      </releases>
    </pluginRepository>
  </pluginRepositories>

  <build>
    <directory>${project.basedir}/target</directory>
    <outputDirectory>${project.build.directory}/classes</outputDirectory>
    <finalName>${project.artifactId}-${project.version}</finalName>
    <testOutputDirectory>${project.build.directory}/test-classes</testOutputDirectory>
    <sourceDirectory>${project.basedir}/src/main/java</sourceDirectory>
    <scriptSourceDirectory>${project.basedir}/src/main/scripts</scriptSourceDirectory>
    <testSourceDirectory>${project.basedir}/src/test/java</testSourceDirectory>
    <resources>
      <resource>
        <directory>${project.basedir}/src/main/resources</directory>
      </resource>
    </resources>
    <testResources>
      <testResource>
        <directory>${project.basedir}/src/test/resources</directory>
      </testResource>
    </testResources>
    <pluginManagement>
      <!-- NOTE: These plugins will be removed from future versions of the super POM -->
      <!-- They are kept for the moment as they are very unlikely to conflict with lifecycle mappings (MNG-4453) -->
      <plugins>
        <plugin>
          <artifactId>maven-antrun-plugin</artifactId>
          <version>1.3</version>
        </plugin>
        <plugin>
          <artifactId>maven-assembly-plugin</artifactId>
          <version>2.2-beta-5</version>
        </plugin>
        <plugin>
          <artifactId>maven-dependency-plugin</artifactId>
          <version>2.8</version>
        </plugin>
        <plugin>
          <artifactId>maven-release-plugin</artifactId>
          <version>2.5.3</version>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>

  <reporting>
    <outputDirectory>${project.build.directory}/site</outputDirectory>
  </reporting>

  <profiles>
    <!-- NOTE: The release profile will be removed from future versions of the super POM -->
    <profile>
      <id>release-profile</id>

      <activation>
        <property>
          <name>performRelease</name>
          <value>true</value>
        </property>
      </activation>

      <build>
        <plugins>
          <plugin>
            <inherited>true</inherited>
            <artifactId>maven-source-plugin</artifactId>
            <executions>
              <execution>
                <id>attach-sources</id>
                <goals>
                  <goal>jar-no-fork</goal>
                </goals>
              </execution>
            </executions>
          </plugin>
          <plugin>
            <inherited>true</inherited>
            <artifactId>maven-javadoc-plugin</artifactId>
            <executions>
              <execution>
                <id>attach-javadocs</id>
                <goals>
                  <goal>jar</goal>
                </goals>
              </execution>
            </executions>
          </plugin>
          <plugin>
            <inherited>true</inherited>
            <artifactId>maven-deploy-plugin</artifactId>
            <configuration>
              <updateReleaseInfo>true</updateReleaseInfo>
            </configuration>
          </plugin>
        </plugins>
      </build>
    </profile>
  </profiles>
</project>

對于我們的項目，我們稱超級 POM 為父 POM，我們項目中的 POM 為子 POM，一般情況下如果父子 POM 中存在相同的元素或者節(jié)點，那么子 POM 會覆蓋父 POM 的元素或者節(jié)點（有點類似 Java 中的 override），但是，也會有這么幾個例外存在：

• dependencies；
• developers 和 contributors；
• plugins；
• resources。

子 POM 在繼承這些元素的時候，并不會直接覆蓋，而是在其基礎(chǔ)上繼續(xù)追加。

3. 小結(jié)

本節(jié)中，我們介紹了 Maven 的 POM 模型，查看 Maven 工程的 pom.xml 文件，以及 pom.xml 文件中的坐標，最后我們還介紹了超級 POM，這樣，我們就對 Maven 的 POM 模型有了一個基本的認識。