Maven 教程之 pom.xml 詳解

靜默虛空發表於2019-04-16

:notebook: 本文已歸檔到：「blog」

簡介

什麼是 pom？

POM 是 Project Object Model 的縮寫，即專案物件模型。

pom.xml 就是 maven 的配置檔案，用以描述專案的各種資訊。

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

  <!-- The Basics -->
  <groupId>...</groupId>
  <artifactId>...</artifactId>
  <version>...</version>
  <packaging>...</packaging>
  <dependencies>...</dependencies>
  <parent>...</parent>
  <dependencyManagement>...</dependencyManagement>
  <modules>...</modules>
  <properties>...</properties>

  <!-- Build Settings -->
  <build>...</build>
  <reporting>...</reporting>

  <!-- More Project Information -->
  <name>...</name>
  <description>...</description>
  <url>...</url>
  <inceptionYear>...</inceptionYear>
  <licenses>...</licenses>
  <organization>...</organization>
  <developers>...</developers>
  <contributors>...</contributors>

  <!-- Environment Settings -->
  <issueManagement>...</issueManagement>
  <ciManagement>...</ciManagement>
  <mailingLists>...</mailingLists>
  <scm>...</scm>
  <prerequisites>...</prerequisites>
  <repositories>...</repositories>
  <pluginRepositories>...</pluginRepositories>
  <distributionManagement>...</distributionManagement>
  <profiles>...</profiles>
</project>
複製程式碼

基本配置

project - project 是 pom.xml 中描述符的根。
modelVersion - modelVersion 指定 pom.xml 符合哪個版本的描述符。maven 2 和 3 只能為 4.0.0。

一般 jar 包被識別為： groupId:artifactId:version 的形式。

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

  <groupId>org.codehaus.mojo</groupId>
  <artifactId>my-project</artifactId>
  <version>1.0</version>
  <packaging>war</packaging>
</project>
複製程式碼

maven 座標

在 maven 中，根據 groupId、artifactId、version 組合成 groupId:artifactId:version 來唯一識別一個 jar 包。

groupId - 團體、組織的識別符號。團體標識的約定是，它以建立這個專案的組織名稱的逆向域名(reverse domain name)開頭。一般對應著 java 的包結構。
artifactId - 單獨專案的唯一識別符號。比如我們的 tomcat、commons 等。不要在 artifactId 中包含點號(.)。
version - 一個專案的特定版本。
- maven 有自己的版本規範，一般是如下定義 major version、minor version、incremental version-qualifier ，比如 1.2.3-beta-01。要說明的是，maven 自己判斷版本的演算法是 major、minor、incremental 部分用數字比較，qualifier 部分用字串比較，所以要小心 alpha-2 和 alpha-15 的比較關係，最好用 alpha-02 的格式。
- maven 在版本管理時候可以使用幾個特殊的字串 SNAPSHOT、LATEST、RELEASE。比如 1.0-SNAPSHOT。各個部分的含義和處理邏輯如下說明：
  - SNAPSHOT - 這個版本一般用於開發過程中，表示不穩定的版本。
  - LATEST - 指某個特定構件的最新發布，這個釋出可能是一個釋出版，也可能是一個 snapshot 版，具體看哪個時間最後。
  - RELEASE ：指最後一個釋出版。
packaging - 專案的型別，描述了專案打包後的輸出，預設是 jar。常見的輸出型別為：pom, jar, maven-plugin, ejb, war, ear, rar, par。

依賴配置

dependencies

<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">
  ...
  <dependencies>
    <dependency>
     <groupId>org.apache.maven</groupId>
      <artifactId>maven-embedder</artifactId>
      <version>2.0</version>
      <type>jar</type>
      <scope>test</scope>
      <optional>true</optional>
      <exclusions>
        <exclusion>
          <groupId>org.apache.maven</groupId>
          <artifactId>maven-core</artifactId>
        </exclusion>
      </exclusions>
    </dependency>
    ...
  </dependencies>
  ...
</project>
複製程式碼

groupId, artifactId, version - 和基本配置中的 groupId、artifactId、version 意義相同。
type - 對應 packaging 的型別，如果不使用 type 標籤，maven 預設為 jar。
scope - 此元素指的是任務的類路徑（編譯和執行時，測試等）以及如何限制依賴關係的傳遞性。有 5 種可用的限定範圍：
- compile - 如果沒有指定 scope 標籤，maven 預設為這個範圍。編譯依賴關係在所有 classpath 中都可用。此外，這些依賴關係被傳播到依賴專案。
- provided - 與 compile 類似，但是表示您希望 jdk 或容器在執行時提供它。它只適用於編譯和測試 classpath，不可傳遞。
- runtime - 此範圍表示編譯不需要依賴關係，而是用於執行。它是在執行時和測試 classpath，但不是編譯 classpath。
- test - 此範圍表示正常使用應用程式不需要依賴關係，僅適用於測試編譯和執行階段。它不是傳遞的。
- system - 此範圍與 provided 類似，除了您必須提供明確包含它的 jar。該 artifact 始終可用，並且不是在倉庫中查詢。
systemPath - 僅當依賴範圍是系統時才使用。否則，如果設定此元素，構建將失敗。該路徑必須是絕對路徑，因此建議使用 propertie 來指定特定的路徑，如$ {java.home} / lib。由於假定先前安裝了系統範圍依賴關係，maven 將不會檢查專案的倉庫，而是檢查庫檔案是否存在。如果沒有，maven 將會失敗，並建議您手動下載安裝。
optional - optional 讓其他專案知道，當您使用此專案時，您不需要這種依賴性才能正常工作。
exclusions - 包含一個或多個排除元素，每個排除元素都包含一個表示要排除的依賴關係的 groupId 和 artifactId。與可選項不同，可能或可能不會安裝和使用，排除主動從依賴關係樹中刪除自己。

parent

maven 支援繼承功能。子 POM 可以使用 parent 指定父 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
                      https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <parent>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>my-parent</artifactId>
    <version>2.0</version>
    <relativePath>../my-parent</relativePath>
  </parent>

  <artifactId>my-project</artifactId>
</project>
複製程式碼

relativePath - 注意 relativePath 元素。在搜尋本地和遠端儲存庫之前，它不是必需的，但可以用作 maven 的指示符，以首先搜尋給定該專案父級的路徑。

dependencyManagement

dependencyManagement 是表示依賴 jar 包的宣告。即你在專案中的 dependencyManagement 下宣告瞭依賴，maven 不會載入該依賴，dependencyManagement 宣告可以被子 POM 繼承。

dependencyManagement 的一個使用案例是當有父子專案的時候，父專案中可以利用 dependencyManagement 宣告子專案中需要用到的依賴 jar 包，之後，當某個或者某幾個子專案需要載入該依賴的時候，就可以在子專案中 dependencies 節點只配置 groupId 和 artifactId 就可以完成依賴的引用。

dependencyManagement 主要是為了統一管理依賴包的版本，確保所有子專案使用的版本一致，類似的還有plugins和pluginManagement。

modules

子模組列表。

<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>

  <groupId>org.codehaus.mojo</groupId>
  <artifactId>my-parent</artifactId>
  <version>2.0</version>
  <packaging>pom</packaging>

  <modules>
    <module>my-project</module>
    <module>another-project</module>
    <module>third-project/pom-example.xml</module>
  </modules>
</project>
複製程式碼

properties

屬性列表。定義的屬性可以在 pom.xml 檔案中任意處使用。使用方式為 ${propertie} 。

<project>
  ...
  <properties>
    <maven.compiler.source>1.7<maven.compiler.source>
    <maven.compiler.target>1.7<maven.compiler.target>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
  </properties>
  ...
</project>
複製程式碼

構建配置

build

build 可以分為 "project build" 和 "profile build"。

<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">
  ...
  <!-- "Project Build" contains more elements than just the BaseBuild set -->
  <build>...</build>

  <profiles>
    <profile>
      <!-- "Profile Build" contains a subset of "Project Build"s elements -->
      <build>...</build>
    </profile>
  </profiles>
</project>
複製程式碼

基本構建配置：

<build>
  <defaultGoal>install</defaultGoal>
  <directory>${basedir}/target</directory>
  <finalName>${artifactId}-${version}</finalName>
  <filters>
    <filter>filters/filter1.properties</filter>
  </filters>
  ...
</build>
複製程式碼

defaultGoal : 預設執行目標或階段。如果給出了一個目標，它應該被定義為它在命令列中（如 jar：jar）。如果定義了一個階段（如安裝），也是如此。

directory ：構建時的輸出路徑。預設為：${basedir}/target 。

finalName ：這是專案的最終構建名稱（不包括副檔名，例如：my-project-1.0.jar）

filter ：定義 * .properties 檔案，其中包含適用於接受其設定的資源的屬性列表（如下所述）。換句話說，過濾器檔案中定義的“name = value”對在程式碼中替換$ {name}字串。

resources

資源的配置。資原始檔通常不是程式碼，不需要編譯，而是在專案需要捆綁使用的內容。

<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">
  <build>
    ...
    <resources>
      <resource>
        <targetPath>META-INF/plexus</targetPath>
        <filtering>false</filtering>
        <directory>${basedir}/src/main/plexus</directory>
        <includes>
          <include>configuration.xml</include>
        </includes>
        <excludes>
          <exclude>**/*.properties</exclude>
        </excludes>
      </resource>
    </resources>
    <testResources>
      ...
    </testResources>
    ...
  </build>
</project>
複製程式碼

resources: 資源元素的列表，每個資源元素描述與此專案關聯的檔案和何處包含檔案。
targetPath: 指定從構建中放置資源集的目錄結構。目標路徑預設為基本目錄。將要包裝在 jar 中的資源的通常指定的目標路徑是 META-INF。
filtering: 值為 true 或 false。表示是否要為此資源啟用過濾。請注意，該過濾器 * .properties 檔案不必定義為進行過濾 - 資源還可以使用預設情況下在 POM 中定義的屬性（例如$ {project.version}），並將其傳遞到命令列中“-D”標誌（例如，“-Dname = value”）或由 properties 元素顯式定義。過濾檔案覆蓋上面。
directory: 值定義了資源的路徑。構建的預設目錄是${basedir}/src/main/resources。
includes: 一組檔案匹配模式，指定目錄中要包括的檔案，使用*作為萬用字元。
excludes: 與 includes 類似，指定目錄中要排除的檔案，使用*作為萬用字元。注意：如果 include 和 exclude 發生衝突，maven 會以 exclude 作為有效項。
testResources: testResources 與 resources 功能類似，區別僅在於：testResources 指定的資源僅用於 test 階段，並且其預設資源目錄為：${basedir}/src/test/resources 。

plugins

<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">
  <build>
    ...
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-jar-plugin</artifactId>
        <version>2.6</version>
        <extensions>false</extensions>
        <inherited>true</inherited>
        <configuration>
          <classifier>test</classifier>
        </configuration>
        <dependencies>...</dependencies>
        <executions>...</executions>
      </plugin>
    </plugins>
  </build>
</project>
複製程式碼

groupId, artifactId, version ：和基本配置中的 groupId、artifactId、version 意義相同。
extensions ：值為 true 或 false。是否載入此外掛的副檔名。預設為 false。
inherited ：值為 true 或 false。這個外掛配置是否應該適用於繼承自這個外掛的 POM。預設值為 true。
configuration - 這是針對個人外掛的配置，這裡不擴散講解。
dependencies ：這裡的 dependencies 是外掛本身所需要的依賴。
executions ：需要記住的是，外掛可能有多個目標。每個目標可能有一個單獨的配置，甚至可能將外掛的目標完全繫結到不同的階段。執行配置外掛的目標的執行。
- id: 執行目標的標識。
- goals: 像所有多元化的 POM 元素一樣，它包含單個元素的列表。在這種情況下，這個執行塊指定的外掛目標列表。
- phase: 這是執行目標列表的階段。這是一個非常強大的選項，允許將任何目標繫結到構建生命週期中的任何階段，從而改變 maven 的預設行為。
- inherited: 像上面的繼承元素一樣，設定這個 false 會阻止 maven 將這個執行傳遞給它的子代。此元素僅對父 POM 有意義。
- configuration: 與上述相同，但將配置限制在此特定目標列表中，而不是外掛下的所有目標。

<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">
  ...
  <build>
    <plugins>
      <plugin>
        <artifactId>maven-antrun-plugin</artifactId>
        <version>1.1</version>
        <executions>
          <execution>
            <id>echodir</id>
            <goals>
              <goal>run</goal>
            </goals>
            <phase>verify</phase>
            <inherited>false</inherited>
            <configuration>
              <tasks>
                <echo>Build Dir: ${project.build.directory}</echo>
              </tasks>
            </configuration>
          </execution>
        </executions>

      </plugin>
    </plugins>
  </build>
</project>
複製程式碼

pluginManagement

與 dependencyManagement 很相似，在當前 POM 中僅宣告外掛，而不是實際引入外掛。子 POM 中只配置 groupId 和 artifactId 就可以完成外掛的引用，且子 POM 有權重寫 pluginManagement 定義。

它的目的在於統一所有子 POM 的外掛版本。

directories

<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">
  ...
  <build>
    <sourceDirectory>${basedir}/src/main/java</sourceDirectory>
    <scriptSourceDirectory>${basedir}/src/main/scripts</scriptSourceDirectory>
    <testSourceDirectory>${basedir}/src/test/java</testSourceDirectory>
    <outputDirectory>${basedir}/target/classes</outputDirectory>
    <testOutputDirectory>${basedir}/target/test-classes</testOutputDirectory>
    ...
  </build>
</project>
複製程式碼

目錄元素集合存在於 build 元素中，它為整個 POM 設定了各種目錄結構。由於它們在配置檔案構建中不存在，所以這些不能由配置檔案更改。

如果上述目錄元素的值設定為絕對路徑（擴充套件屬性時），則使用該目錄。否則，它是相對於基礎構建目錄：${basedir}。

extensions

擴充套件是在此構建中使用的 artifacts 的列表。它們將被包含在執行構建的 classpath 中。它們可以啟用對構建過程的擴充套件（例如為 Wagon 傳輸機制新增一個 ftp 提供程式），並使活動的外掛能夠對構建生命週期進行更改。簡而言之，擴充套件是在構建期間啟用的 artifacts。擴充套件不需要實際執行任何操作，也不包含 Mojo。因此，擴充套件對於指定普通外掛介面的多個實現中的一個是非常好的。

<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">
  ...
  <build>
    ...
    <extensions>
      <extension>
        <groupId>org.apache.maven.wagon</groupId>
        <artifactId>wagon-ftp</artifactId>
        <version>1.0-alpha-3</version>
      </extension>
    </extensions>
    ...
  </build>
</project>
複製程式碼

reporting

報告包含特定針對 site 生成階段的元素。某些 maven 外掛可以生成 reporting 元素下配置的報告，例如：生成 javadoc 報告。reporting 與 build 元素配置外掛的能力相似。明顯的區別在於：在執行塊中外掛目標的控制不是細粒度的，報表通過配置 reportSet 元素來精細控制。而微妙的區別在於 reporting 元素下的 configuration 元素可以用作 build 下的 configuration ，儘管相反的情況並非如此（ build 下的 configuration 不影響 reporting 元素下的 configuration ）。

另一個區別就是 plugin 下的 outputDirectory 元素。在報告的情況下，預設輸出目錄為 ${basedir}/target/site。

<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">
  ...
  <reporting>
    <plugins>
      <plugin>
        ...
        <reportSets>
          <reportSet>
            <id>sunlink</id>
            <reports>
              <report>javadoc</report>
            </reports>
            <inherited>true</inherited>
            <configuration>
              <links>
                <link>http://java.sun.com/j2se/1.5.0/docs/api/</link>
              </links>
            </configuration>
          </reportSet>
        </reportSets>
      </plugin>
    </plugins>
  </reporting>
  ...
</project>
複製程式碼

專案資訊

專案資訊相關的這部分標籤都不是必要的，也就是說完全可以不填寫。

它的作用僅限於描述專案的詳細資訊。

下面的示例是專案資訊相關標籤的清單：

<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">
  ...

  <!-- 專案資訊 begin -->

  <!--專案名-->
  <name>maven-notes</name>

  <!--專案描述-->
  <description>maven 學習筆記</description>

  <!--專案url-->
  <url>https://github.com/dunwu/maven-notes</url>

  <!--專案開發年份-->
  <inceptionYear>2017</inceptionYear>

  <!--開源協議-->
  <licenses>
    <license>
      <name>Apache License, Version 2.0</name>
      <url>https://www.apache.org/licenses/LICENSE-2.0.txt</url>
      <distribution>repo</distribution>
      <comments>A business-friendly OSS license</comments>
    </license>
  </licenses>

  <!--組織資訊(如公司、開源組織等)-->
  <organization>
    <name>...</name>
    <url>...</url>
  </organization>

  <!--開發者列表-->
  <developers>
    <developer>
      <id>victor</id>
      <name>Zhang Peng</name>
      <email>forbreak at 163.com</email>
      <url>https://github.com/dunwu</url>
      <organization>...</organization>
      <organizationUrl>...</organizationUrl>
      <roles>
        <role>architect</role>
        <role>developer</role>
      </roles>
      <timezone>+8</timezone>
      <properties>...</properties>
    </developer>
  </developers>

  <!--程式碼貢獻者列表-->
   <contributors>
    <contributor>
      <!--標籤內容和<developer>相同-->
    </contributor>
  </contributors>

  <!-- 專案資訊 end -->

  ...
</project>
複製程式碼

這部分標籤都非常簡單，基本都能做到顧名思義，且都屬於可有可無的標籤，所以這裡僅簡單介紹一下：

name - 專案完整名稱
description - 專案描述
url - 一般為專案倉庫的 host
inceptionYear - 開發年份
licenses - 開源協議
organization - 專案所屬組織資訊
developers - 專案開發者列表
contributors - 專案貢獻者列表，<contributor> 的子標籤和 <developer> 的完全相同。

環境配置

issueManagement

這定義了所使用的缺陷跟蹤系統（Bugzilla，TestTrack，ClearQuest 等）。雖然沒有什麼可以阻止外掛使用這些資訊的東西，但它主要用於生成專案文件。

<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">
  ...
  <issueManagement>
    <system>Bugzilla</system>
    <url>http://127.0.0.1/bugzilla/</url>
  </issueManagement>
  ...
</project>
複製程式碼

ciManagement

CI 構建系統配置，主要是指定通知機制以及被通知的郵箱。

<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">
  ...
  <ciManagement>
    <system>continuum</system>
    <url>http://127.0.0.1:8080/continuum</url>
    <notifiers>
      <notifier>
        <type>mail</type>
        <sendOnError>true</sendOnError>
        <sendOnFailure>true</sendOnFailure>
        <sendOnSuccess>false</sendOnSuccess>
        <sendOnWarning>false</sendOnWarning>
        <configuration><address>continuum@127.0.0.1</address></configuration>
      </notifier>
    </notifiers>
  </ciManagement>
  ...
</project>
複製程式碼

mailingLists

郵件列表

<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">
  ...
  <mailingLists>
    <mailingList>
      <name>User List</name>
      <subscribe>user-subscribe@127.0.0.1</subscribe>
      <unsubscribe>user-unsubscribe@127.0.0.1</unsubscribe>
      <post>user@127.0.0.1</post>
      <archive>http://127.0.0.1/user/</archive>
      <otherArchives>
        <otherArchive>http://base.google.com/base/1/127.0.0.1</otherArchive>
      </otherArchives>
    </mailingList>
  </mailingLists>
  ...
</project>
複製程式碼

scm

SCM（軟體配置管理，也稱為原始碼/控制管理或簡潔的版本控制）。常見的 scm 有 svn 和 git 。

<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">
  ...
  <scm>
    <connection>scm:svn:http://127.0.0.1/svn/my-project</connection>
    <developerConnection>scm:svn:https://127.0.0.1/svn/my-project</developerConnection>
    <tag>HEAD</tag>
    <url>http://127.0.0.1/websvn/my-project</url>
  </scm>
  ...
</project>
複製程式碼

prerequisites

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
                      https://maven.apache.org/xsd/maven-4.0.0.xsd">
  ...
  <prerequisites>
    <maven>2.0.6</maven>
  </prerequisites>
  ...
</project>
複製程式碼

repositories

repositories 是遵循 Maven 儲存庫目錄佈局的 artifacts 集合。預設的 Maven 中央儲存庫位於https://repo.maven.apache.org/maven2/上。

<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">
  ...
  <repositories>
    <repository>
      <releases>
        <enabled>false</enabled>
        <updatePolicy>always</updatePolicy>
        <checksumPolicy>warn</checksumPolicy>
      </releases>
      <snapshots>
        <enabled>true</enabled>
        <updatePolicy>never</updatePolicy>
        <checksumPolicy>fail</checksumPolicy>
      </snapshots>
      <id>codehausSnapshots</id>
      <name>Codehaus Snapshots</name>
      <url>http://snapshots.maven.codehaus.org/maven2</url>
      <layout>default</layout>
    </repository>
  </repositories>
  <pluginRepositories>
    ...
  </pluginRepositories>
  ...
</project>
複製程式碼

pluginRepositories

與 repositories 差不多。

<project xmlns="http://maven.apache.org/POM/4.0.0"
  xmlns:xsi="http://www.w3.org/001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
                      https://maven.apache.org/xsd/maven-4.0.0.xsd">
  ...
  <distributionManagement>
    ...
    <downloadUrl>http://mojo.codehaus.org/my-project</downloadUrl>
    <status>deployed</status>
  </distributionManagement>
  ...
</project>
複製程式碼

distributionManagement

它管理在整個構建過程中生成的 artifact 和支援檔案的分佈。從最後的元素開始：

<project xmlns="http://maven.apache.org/POM/4.0.0"
  xmlns:xsi="http://www.w3.org/001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
                      https://maven.apache.org/xsd/maven-4.0.0.xsd">
  ...
  <distributionManagement>
    ...
    <downloadUrl>http://mojo.codehaus.org/my-project</downloadUrl>
    <status>deployed</status>
  </distributionManagement>
  ...
</project>
複製程式碼

repository - 與 repositories 相似
site - 站點資訊
relocation - 專案遷移位置

profiles

activation 是一個 profile 的關鍵。配置檔案的功能來自於在某些情況下僅修改基本 POM 的功能。這些情況通過 activation 元素指定。

<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">
  ...
  <profiles>
    <profile>
      <id>test</id>
      <activation>
        <activeByDefault>false</activeByDefault>
        <jdk>1.5</jdk>
        <os>
          <name>Windows XP</name>
          <family>Windows</family>
          <arch>x86</arch>
          <version>5.1.2600</version>
        </os>
        <property>
          <name>sparrow-type</name>
          <value>African</value>
        </property>
        <file>
          <exists>${basedir}/file2.properties</exists>
          <missing>${basedir}/file1.properties</missing>
        </file>
      </activation>
      ...
    </profile>
  </profiles>
</project>
複製程式碼

參考資料

maven 官方文件之 pom

Maven中的pom.xml詳解
2016-07-18
MavenXML
Maven的pom.xml檔案詳解
2020-04-04
MavenXML
Maven pom.xml檔案配置詳解
2017-03-23
MavenXML
Maven快速入門（四）Maven中的pom.xml檔案詳解
2020-08-31
MavenXML
pom.xml詳解
2018-04-10
XML
Maven之pom.xml與setting.xml配置檔案詳解
2018-01-23
MavenXML
Maven專案中POM.xml檔案內的標籤大全詳解
2017-11-17
MavenXML
Maven中pom.xml解析
2017-02-18
MavenXML
POM.xml 標籤詳解
2019-07-19
XML
maven的pom.xml用解決版本問題
2018-06-05
MavenXML
maven詳解
2017-08-19
Maven
Maven安裝詳解
2023-03-18
Maven
Maven入門詳解
2016-03-24
Maven
Python改寫maven的pom.xml檔案
2018-04-29
PythonMavenXML
【SSM整合】-Maven管理SSM框架的pom.xml配置
2017-05-10
SSMMaven框架XML
Maven實戰：pom.xml與settings.xml
2016-07-30
MavenXML
Maven 教程之入門指南
2019-04-16
Maven
maven中profiles使用詳解
2022-02-06
Maven
SpringBoot專案maven pom.xml警告Overriding managed version問題解決
2020-10-09
Spring BootMavenXML
Maven 教程（21）— maven-compiler-plugin 外掛詳解
2019-01-09
MavenCompilePlugin
Maven依賴scope範圍詳解
2021-02-06
Maven
Maven依賴中的scope詳解
2018-03-02
Maven
Maven中optional標籤詳解（轉）
2024-03-14
Maven
J2EE開發筆記（四）—— pom.xml檔案詳解
2017-05-12
筆記XML
Vue 進階教程之：詳解 v-model
2020-04-04
Vue
Django基礎教程之配置檔案詳解
2021-04-05
Django
Pandas高階教程之:plot畫圖詳解
2021-07-07
正規表示式教程之位置匹配詳解
2022-03-15
如何在maven專案的pom.xml檔案中新增jar包
2016-03-16
MavenXMLJAR
Maven私服倉庫配置-Nexus詳解！
2024-02-26
Maven
IDEA執行maven專案詳解
2024-10-11
IdeaMaven
gitbook 入門教程之常用命令詳解
2019-04-05
Git
前端進階課程之跨域問題詳解
2018-11-07
前端跨域
前端進階課程之物件屬性特性詳解
2018-11-15
前端物件
Nmap掃描教程之基礎掃描詳解
2015-06-29
maven中的scope標籤類別詳解
2018-08-26
Maven
Maven中的dependency的scope作用域詳解
2018-07-03
Maven
Maven系列1--settings.xml 配置詳解
2010-11-26
MavenXML