Maven教學 » Maven POM

Maven POM

POM代表專案物件模型。它是 Maven 中工作的基本單位，這是一個 XML 檔案。它始終儲存在該專案基本目錄中的 pom.xml 檔案。
POM 包含的專案是使用 Maven 來構建的，它用來包含各種組態資訊。
POM 也包含了目標和外掛。在執行任務或目標時，Maven 會使用當前目錄中的 POM。它讀取POM得到所需要的組態資訊，然後執行目標。部分的組態可以在 POM 使用如下：

  • project dependencies
  • plugins
  • goals
  • build profiles
  • project version
  • developers
  • mailing list

建立一個POM之前，應該要先決定專案組(groupId)，它的名字(artifactId)和版本，因為這些屬性在專案倉庫是唯一標識的。

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>
   <groupId>com.yiibai.project-group</groupId>
   <artifactId>project</artifactId>
   <version>1.0</version>
<project>

要注意的是，每個專案只有一個POM檔案。

  • 所有的 POM 檔案要專案元素必須有三個必填欄位: groupId，artifactId，version
  • 在庫中的專案符號是：groupId:artifactId:version
  • pom.xml 的根元素是 project，它有三個主要的子節點。
節點 描述
groupId 這是專案組的編號，這在組織或專案中通常是獨一無二的。 例如，一家銀行集團com.company.bank擁有所有銀行相關專案。
artifactId 這是專案的ID。這通常是專案的名稱。 例如，consumer-banking。 除了groupId之外，artifactId還定義了artifact在儲存庫中的位置。
version 這是專案的版本。與groupId一起使用，artifact在儲存庫中用於將版本彼此分離。 例如：com.company.bank:consumer-banking:1.0，com.company.bank:consumer-banking:1.1

超級POM

所有的POM繼承自父類別(儘管明確界定)。這個基礎的 POM 被稱為超級 POM，並包含繼承預設值。 Maven使用有效的POM(超級POM加專案組態的組態)執行有關目標。它可以幫助開發人員指定最低組態的詳細資訊寫在 pom.xml 中。雖然組態可以很容易被覆蓋。 一個簡單的方法來看看超級POM的預設組態，通過執行下面的命令：mvn help:effective-pom 建立一個 pom.xml 。 在下面的例子中，已經建立了一個 pom.xml 在C:\MVN\ 專案檔案夾中。 現在，開啟命令控制台，進入包含 pom.xml 檔案夾並執行以下 mvn 命令。

C:\MVN\project> mvn help:effective-pom

Maven將開始處理，並顯示有效的 effective-pom 。

[INFO] Scanning for projects...
[INFO] Searching repository for plugin with prefix: 'help'.
[INFO] ------------------------------------------------------------------------
[INFO] Building Unnamed - com.companyname.project-group:project-name:jar:1.0
[INFO]    task-segment: [help:effective-pom] (aggregator-style)
[INFO] ------------------------------------------------------------------------
[INFO] [help:effective-pom {execution: default-cli}]
[INFO]

.....

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: < 1 second
[INFO] Finished at: Thu Jul 05 11:41:51 IST 2012
[INFO] Final Memory: 6M/15M
[INFO] ------------------------------------------------------------------------

在控制台顯示結果：有效POM，繼承，插值，應用組態檔案。

<?xml version="1.0" encoding="UTF-8"?>
<!-- ================================================================= -->
<!--                                                                   -->
<!-- Generated by Maven Help Plugin on 2012-07-05T11:41:51             -->
<!-- See: http://maven.apache.org/plugins/maven-help-plugin/           -->
<!--                                                                   -->
<!-- ================================================================= -->
<!-- ================================================================= -->
<!--                                                                   -->
<!-- Effective POM for project                                         -->
<!-- 'com.companyname.project-group:project-name:jar:1.0'              -->
<!--                                                                   -->
<!-- ================================================================= -->
<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 h
ttp://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.companyname.project-group</groupId>
  <artifactId>project</artifactId>
  <version>1.0</version>
  <build>
    <sourceDirectory>C:\MVN\project\src\main\java</sourceDirectory>
    <scriptSourceDirectory>src/main/scripts</scriptSourceDirectory>
    <testSourceDirectory>C:\MVN\project\src\test\java</testSourceDirectory>
    <outputDirectory>C:\MVN\project\target\classes</outputDirectory>
    <testOutputDirectory>C:\MVN\project\target\test-classes</testOutputDirectory>
    <resources>
      <resource>
        <mergeId>resource-0</mergeId>
        <directory>C:\MVN\project\src\main\resources</directory>
      </resource>
    </resources>
    <testResources>
      <testResource>
        <mergeId>resource-1</mergeId>
        <directory>C:\MVN\project\src\test\resources</directory>
      </testResource>
    </testResources>
    <directory>C:\MVN\project\target</directory>
    <finalName>project-1.0</finalName>
    <pluginManagement>
      <plugins>
        <plugin>
          <artifactId>maven-antrun-plugin</artifactId>
          <version>1.3</version>
        </plugin>
        <plugin>
          <artifactId>maven-assembly-plugin</artifactId>
          <version>2.2-beta-2</version>
        </plugin>
        <plugin>
          <artifactId>maven-clean-plugin</artifactId>
          <version>2.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>2.0.2</version>         </plugin>
        <plugin>
          <artifactId>maven-dependency-plugin</artifactId>
          <version>2.0</version>
        </plugin>
        <plugin>
          <artifactId>maven-deploy-plugin</artifactId>
          <version>2.4</version>
        </plugin>
        <plugin>
          <artifactId>maven-ear-plugin</artifactId>
          <version>2.3.1</version>
        </plugin>
        <plugin>
          <artifactId>maven-ejb-plugin</artifactId>
          <version>2.1</version>
        </plugin>
        <plugin>
          <artifactId>maven-install-plugin</artifactId>
          <version>2.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-jar-plugin</artifactId>
          <version>2.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-javadoc-plugin</artifactId>
          <version>2.5</version>
        </plugin>
        <plugin>
          <artifactId>maven-plugin-plugin</artifactId>
          <version>2.4.3</version>
        </plugin>
        <plugin>
          <artifactId>maven-rar-plugin</artifactId>
          <version>2.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-release-plugin</artifactId>
          <version>2.0-beta-8</version>
        </plugin>
        <plugin>
          <artifactId>maven-resources-plugin</artifactId>
          <version>2.3</version>
        </plugin>
        <plugin>
          <artifactId>maven-site-plugin</artifactId>
          <version>2.0-beta-7</version>
        </plugin>
        <plugin>
          <artifactId>maven-source-plugin</artifactId>
          <version>2.0.4</version>
        </plugin>
        <plugin>
          <artifactId>maven-surefire-plugin</artifactId>
          <version>2.4.3</version>
        </plugin>
        <plugin>
          <artifactId>maven-war-plugin</artifactId>
          <version>2.1-alpha-2</version>
        </plugin>
      </plugins>
    </pluginManagement>
    <plugins>

      <plugin>
        <artifactId>maven-help-plugin</artifactId>
        <version>2.1.1</version>
      </plugin>
    </plugins>
  </build>
  <repositories>
    <repository>
      <snapshots>
        <enabled>false</enabled>
      </snapshots>
      <id>central</id>
      <name>Maven Repository Switchboard</name>
      <url>http://repo1.maven.org/maven2</url>
    </repository>
  </repositories>
  <pluginRepositories>
    <pluginRepository>
      <releases>
        <updatePolicy>never</updatePolicy>
      </releases>
      <snapshots>
        <enabled>false</enabled>
      </snapshots>
      <id>central</id>
      <name>Maven Plugin Repository</name>
      <url>http://repo1.maven.org/maven2</url>
    </pluginRepository>
  </pluginRepositories>
  <reporting>
    <outputDirectory>C:\MVN\project\target/site</outputDirectory>
  </reporting>
</project>

在上面的pom.xml 中，可以看到預設的專案原始檔夾結構，輸出目錄，外掛，資料庫，報表目錄，Maven將使用它們來執行預期的目標。

Maven pom.xml 無須手動寫入。

Maven提供了大量的原型外掛以建立專案，包括專案結構 和 pom.xml

如上述詳細資訊中提到 Maven外掛和Maven建立專案部分。