maven pom

pom(project object model) 即項(xiàng)目對象模型，它是 maven 工程的基本工作單元，是一個(gè) xml 文件，包含了項(xiàng)目的基本信息，用于描述項(xiàng)目如何構(gòu)建，聲明項(xiàng)目依賴等。

執(zhí)行任務(wù)或目標(biāo)時(shí)，maven 會(huì)在當(dāng)前目錄中查找 pom。它讀取 pom，獲取所需的配置信息，然后執(zhí)行目標(biāo)。

pom 中可以指定以下配置：

• 項(xiàng)目依賴
• 插件
• 執(zhí)行目標(biāo)
• 項(xiàng)目構(gòu)建 profile
• 項(xiàng)目版本
• 項(xiàng)目開發(fā)者列表
• 相關(guān)郵件列表信息

在創(chuàng)建 pom 之前，我們首先需要描述項(xiàng)目組 (groupid), 項(xiàng)目的唯一id。

<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>
    <!-- 公司或者組織的唯一標(biāo)志，并且配置時(shí)生成的路徑也是由此生成， 如com.companyname.project-group，maven會(huì)將該項(xiàng)目打成的jar包放本地路徑：/com/companyname/project-group -->
    <groupid>com.companyname.project-group</groupid>
 
    <!-- 項(xiàng)目的唯一id，一個(gè)groupid下面可能多個(gè)項(xiàng)目，就是靠artifactid來區(qū)分的 -->
    <artifactid>project</artifactid>
 
    <!-- 版本號(hào) -->
    <version>1.0</version>
</project>

所有 pom 文件都需要 project 元素和三個(gè)必需字段：groupid，artifactid，version。

com.company.bank:consumer-banking:1.0
com.company.bank:consumer-banking:1.1

1. 父（super）pom

父（super）pom是 maven 默認(rèn)的 pom。所有的 pom 都繼承自一個(gè)父 pom（無論是否顯式定義了這個(gè)父 pom）。父 pom 包含了一些可以被繼承的默認(rèn)設(shè)置。因此，當(dāng) maven 發(fā)現(xiàn)需要下載 pom 中的 依賴時(shí)，它會(huì)到 super pom 中配置的默認(rèn)倉庫 http://repo1.maven.org/maven2 去下載。

maven 使用 effective pom（super pom 加上工程自己的配置）來執(zhí)行相關(guān)的目標(biāo)，它幫助開發(fā)者在 pom.xml 中做盡可能少的配置，當(dāng)然這些配置可以被重寫。

使用以下命令來查看 super pom 默認(rèn)配置：

mvn help:effective-pom

接下來我們創(chuàng)建目錄 mvn/project，在該目錄下創(chuàng)建 pom.xml，內(nèi)容如下：

<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>
    <!-- 公司或者組織的唯一標(biāo)志，并且配置時(shí)生成的路徑也是由此生成， 如com.companyname.project-group，maven會(huì)將該項(xiàng)目打成的jar包放本地路徑：/com/companyname/project-group -->
    <groupid>com.companyname.project-group</groupid>
 
    <!-- 項(xiàng)目的唯一id，一個(gè)groupid下面可能多個(gè)項(xiàng)目，就是靠artifactid來區(qū)分的 -->
    <artifactid>project</artifactid>
 
    <!-- 版本號(hào) -->
    <version>1.0</version>
</project>

在命令控制臺(tái)，進(jìn)入 mvn/project 目錄，執(zhí)行以下命令：

c:\mvn\project>mvn help:effective-pom

maven 將會(huì)開始處理并顯示 effective-pom。

[info] scanning for projects...
downloading: https://repo.maven.apache.org/maven2/org/apache/maven/plugins/maven-clean-plugin/2.5/maven-clean-plugin-2.5.pom
...
[info] ------------------------------------------------------------------------
[info] build success
[info] ------------------------------------------------------------------------
[info] total time: 01:36 min
[info] finished at: 2018-09-05t11:31:28+08:00
[info] final memory: 15m/149m
[info] ------------------------------------------------------------------------

effective pom 的結(jié)果就像在控制臺(tái)中顯示的一樣，經(jīng)過繼承、插值之后，使配置生效。

<?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 在執(zhí)行目標(biāo)時(shí)需要用到的默認(rèn)工程源碼目錄結(jié)構(gòu)、輸出目錄、需要的插件、倉庫和報(bào)表目錄。

maven 的 pom.xml 文件也不需要手工編寫。

maven 提供了大量的原型插件來創(chuàng)建工程，包括工程結(jié)構(gòu)和 pom.xml。

2. pom 標(biāo)簽大全詳解：

<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.0http://maven.apache.org/maven-v4_0_0.xsd">
    <!--父項(xiàng)目的坐標(biāo)。如果項(xiàng)目中沒有規(guī)定某個(gè)元素的值，那么父項(xiàng)目中的對應(yīng)值即為項(xiàng)目的默認(rèn)值。 坐標(biāo)包括group id，artifact id和 
        version。 -->
    <parent>
        <!--被繼承的父項(xiàng)目的構(gòu)件標(biāo)識(shí)符 -->
        <artifactid />
        <!--被繼承的父項(xiàng)目的全球唯一標(biāo)識(shí)符 -->
        <groupid />
        <!--被繼承的父項(xiàng)目的版本 -->
        <version />
        <!-- 父項(xiàng)目的pom.xml文件的相對路徑。相對路徑允許你選擇一個(gè)不同的路徑。默認(rèn)值是../pom.xml。maven首先在構(gòu)建當(dāng)前項(xiàng)目的地方尋找父項(xiàng) 
            目的pom，其次在文件系統(tǒng)的這個(gè)位置（relativepath位置），然后在本地倉庫，最后在遠(yuǎn)程倉庫尋找父項(xiàng)目的pom。 -->
        <relativepath />
    </parent>
    <!--聲明項(xiàng)目描述符遵循哪一個(gè)pom模型版本。模型本身的版本很少改變，雖然如此，但它仍然是必不可少的，這是為了當(dāng)maven引入了新的特性或者其他模型變更的時(shí)候，確保穩(wěn)定性。 -->
    <modelversion>4.0.0</modelversion>
    <!--項(xiàng)目的全球唯一標(biāo)識(shí)符，通常使用全限定的包名區(qū)分該項(xiàng)目和其他項(xiàng)目。并且構(gòu)建時(shí)生成的路徑也是由此生成， 如com.mycompany.app生成的相對路徑為：/com/mycompany/app -->
    <groupid>asia.banseon</groupid>
    <!-- 構(gòu)件的標(biāo)識(shí)符，它和group id一起唯一標(biāo)識(shí)一個(gè)構(gòu)件。換句話說，你不能有兩個(gè)不同的項(xiàng)目擁有同樣的artifact id和groupid；在某個(gè) 
        特定的group id下，artifact id也必須是唯一的。構(gòu)件是項(xiàng)目產(chǎn)生的或使用的一個(gè)東西，maven為項(xiàng)目產(chǎn)生的構(gòu)件包括：jars，源 碼，二進(jìn)制發(fā)布和wars等。 -->
    <artifactid>banseon-maven2</artifactid>
    <!--項(xiàng)目產(chǎn)生的構(gòu)件類型，例如jar、war、ear、pom。插件可以創(chuàng)建他們自己的構(gòu)件類型，所以前面列的不是全部構(gòu)件類型 -->
    <packaging>jar</packaging>
    <!--項(xiàng)目當(dāng)前版本，格式為:主版本.次版本.增量版本-限定版本號(hào) -->
    <version>1.0-snapshot</version>
    <!--項(xiàng)目的名稱, maven產(chǎn)生的文檔用 -->
    <name>banseon-maven</name>
    <!--項(xiàng)目主頁的url, maven產(chǎn)生的文檔用 -->
    <url>http://www.baidu.com/banseon</url>
    <!-- 項(xiàng)目的詳細(xì)描述, maven 產(chǎn)生的文檔用。 當(dāng)這個(gè)元素能夠用html格式描述時(shí)（例如，cdata中的文本會(huì)被解析器忽略，就可以包含html標(biāo) 
        簽）， 不鼓勵(lì)使用純文本描述。如果你需要修改產(chǎn)生的web站點(diǎn)的索引頁面，你應(yīng)該修改你自己的索引頁文件，而不是調(diào)整這里的文檔。 -->
    <description>a maven project to study maven.</description>
    <!--描述了這個(gè)項(xiàng)目構(gòu)建環(huán)境中的前提條件。 -->
    <prerequisites>
        <!--構(gòu)建該項(xiàng)目或使用該插件所需要的maven的最低版本 -->
        <maven />
    </prerequisites>
    <!--項(xiàng)目的問題管理系統(tǒng)(bugzilla, jira, scarab,或任何你喜歡的問題管理系統(tǒng))的名稱和url，本例為 jira -->
    <issuemanagement>
        <!--問題管理系統(tǒng)（例如jira）的名字， -->
        <system>jira</system>
        <!--該項(xiàng)目使用的問題管理系統(tǒng)的url -->
        <url>http://jira.baidu.com/banseon</url>
    </issuemanagement>
    <!--項(xiàng)目持續(xù)集成信息 -->
    <cimanagement>
        <!--持續(xù)集成系統(tǒng)的名字，例如continuum -->
        <system />
        <!--該項(xiàng)目使用的持續(xù)集成系統(tǒng)的url（如果持續(xù)集成系統(tǒng)有web接口的話）。 -->
        <url />
        <!--構(gòu)建完成時(shí)，需要通知的開發(fā)者/用戶的配置項(xiàng)。包括被通知者信息和通知條件（錯(cuò)誤，失敗，成功，警告） -->
        <notifiers>
            <!--配置一種方式，當(dāng)構(gòu)建中斷時(shí)，以該方式通知用戶/開發(fā)者 -->
            <notifier>
                <!--傳送通知的途徑 -->
                <type />
                <!--發(fā)生錯(cuò)誤時(shí)是否通知 -->
                <sendonerror />
                <!--構(gòu)建失敗時(shí)是否通知 -->
                <sendonfailure />
                <!--構(gòu)建成功時(shí)是否通知 -->
                <sendonsuccess />
                <!--發(fā)生警告時(shí)是否通知 -->
                <sendonwarning />
                <!--不贊成使用。通知發(fā)送到哪里 -->
                <address />
                <!--擴(kuò)展配置項(xiàng) -->
                <configuration />
            </notifier>
        </notifiers>
    </cimanagement>
    <!--項(xiàng)目創(chuàng)建年份，4位數(shù)字。當(dāng)產(chǎn)生版權(quán)信息時(shí)需要使用這個(gè)值。 -->
    <inceptionyear />
    <!--項(xiàng)目相關(guān)郵件列表信息 -->
    <mailinglists>
        <!--該元素描述了項(xiàng)目相關(guān)的所有郵件列表。自動(dòng)產(chǎn)生的網(wǎng)站引用這些信息。 -->
        <mailinglist>
            <!--郵件的名稱 -->
            <name>demo</name>
            <!--發(fā)送郵件的地址或鏈接，如果是郵件地址，創(chuàng)建文檔時(shí)，mailto: 鏈接會(huì)被自動(dòng)創(chuàng)建 -->
            <post>banseon@126.com</post>
            <!--訂閱郵件的地址或鏈接，如果是郵件地址，創(chuàng)建文檔時(shí)，mailto: 鏈接會(huì)被自動(dòng)創(chuàng)建 -->
            <subscribe>banseon@126.com</subscribe>
            <!--取消訂閱郵件的地址或鏈接，如果是郵件地址，創(chuàng)建文檔時(shí)，mailto: 鏈接會(huì)被自動(dòng)創(chuàng)建 -->
            <unsubscribe>banseon@126.com</unsubscribe>
            <!--你可以瀏覽郵件信息的url -->
            <archive>http:/hi.baidu.com/banseon/demo/dev/</archive>
        </mailinglist>
    </mailinglists>
    <!--項(xiàng)目開發(fā)者列表 -->
    <developers>
        <!--某個(gè)項(xiàng)目開發(fā)者的信息 -->
        <developer>
            <!--scm里項(xiàng)目開發(fā)者的唯一標(biāo)識(shí)符 -->
            <id>hello world</id>
            <!--項(xiàng)目開發(fā)者的全名 -->
            <name>banseon</name>
            <!--項(xiàng)目開發(fā)者的email -->
            <email>banseon@126.com</email>
            <!--項(xiàng)目開發(fā)者的主頁的url -->
            <url />
            <!--項(xiàng)目開發(fā)者在項(xiàng)目中扮演的角色，角色元素描述了各種角色 -->
            <roles>
                <role>project manager</role>
                <role>architect</role>
            </roles>
            <!--項(xiàng)目開發(fā)者所屬組織 -->
            <organization>demo</organization>
            <!--項(xiàng)目開發(fā)者所屬組織的url -->
            <organizationurl>http://hi.baidu.com/banseon</organizationurl>
            <!--項(xiàng)目開發(fā)者屬性，如即時(shí)消息如何處理等 -->
            <properties>
                <dept>no</dept>
            </properties>
            <!--項(xiàng)目開發(fā)者所在時(shí)區(qū)， -11到12范圍內(nèi)的整數(shù)。 -->
            <timezone>-5</timezone>
        </developer>
    </developers>
    <!--項(xiàng)目的其他貢獻(xiàn)者列表 -->
    <contributors>
        <!--項(xiàng)目的其他貢獻(xiàn)者。參見developers/developer元素 -->
        <contributor>
            <name />
            <email />
            <url />
            <organization />
            <organizationurl />
            <roles />
            <timezone />
            <properties />
        </contributor>
    </contributors>
    <!--該元素描述了項(xiàng)目所有l(wèi)icense列表。 應(yīng)該只列出該項(xiàng)目的license列表，不要列出依賴項(xiàng)目的 license列表。如果列出多個(gè)license，用戶可以選擇它們中的一個(gè)而不是接受所有l(wèi)icense。 -->
    <licenses>
        <!--描述了項(xiàng)目的license，用于生成項(xiàng)目的web站點(diǎn)的license頁面，其他一些報(bào)表和validation也會(huì)用到該元素。 -->
        <license>
            <!--license用于法律上的名稱 -->
            <name>apache 2</name>
            <!--官方的license正文頁面的url -->
            <url>http://www.baidu.com/banseon/license-2.0.txt</url>
            <!--項(xiàng)目分發(fā)的主要方式： repo，可以從maven庫下載 manual， 用戶必須手動(dòng)下載和安裝依賴 -->
            <distribution>repo</distribution>
            <!--關(guān)于license的補(bǔ)充信息 -->
            <comments>a business-friendly oss license</comments>
        </license>
    </licenses>
    <!--scm(source control management)標(biāo)簽允許你配置你的代碼庫，供maven web站點(diǎn)和其它插件使用。 -->
    <scm>
        <!--scm的url,該url描述了版本庫和如何連接到版本庫。欲知詳情，請看scms提供的url格式和列表。該連接只讀。 -->
        <connection>
            scm:svn:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk)
        </connection>
        <!--給開發(fā)者使用的，類似connection元素。即該連接不僅僅只讀 -->
        <developerconnection>
            scm:svn:http://svn.baidu.com/banseon/maven/banseon/dao-trunk
        </developerconnection>
        <!--當(dāng)前代碼的標(biāo)簽，在開發(fā)階段默認(rèn)為head -->
        <tag />
        <!--指向項(xiàng)目的可瀏覽scm庫（例如viewvc或者fisheye）的url。 -->
        <url>http://svn.baidu.com/banseon</url>
    </scm>
    <!--描述項(xiàng)目所屬組織的各種屬性。maven產(chǎn)生的文檔用 -->
    <organization>
        <!--組織的全名 -->
        <name>demo</name>
        <!--組織主頁的url -->
        <url>http://www.baidu.com/banseon</url>
    </organization>
    <!--構(gòu)建項(xiàng)目需要的信息 -->
    <build>
        <!--該元素設(shè)置了項(xiàng)目源碼目錄，當(dāng)構(gòu)建項(xiàng)目的時(shí)候，構(gòu)建系統(tǒng)會(huì)編譯目錄里的源碼。該路徑是相對于pom.xml的相對路徑。 -->
        <sourcedirectory />
        <!--該元素設(shè)置了項(xiàng)目腳本源碼目錄，該目錄和源碼目錄不同：絕大多數(shù)情況下，該目錄下的內(nèi)容 會(huì)被拷貝到輸出目錄(因?yàn)槟_本是被解釋的，而不是被編譯的)。 -->
        <scriptsourcedirectory />
        <!--該元素設(shè)置了項(xiàng)目單元測試使用的源碼目錄，當(dāng)測試項(xiàng)目的時(shí)候，構(gòu)建系統(tǒng)會(huì)編譯目錄里的源碼。該路徑是相對于pom.xml的相對路徑。 -->
        <testsourcedirectory />
        <!--被編譯過的應(yīng)用程序class文件存放的目錄。 -->
        <outputdirectory />
        <!--被編譯過的測試class文件存放的目錄。 -->
        <testoutputdirectory />
        <!--使用來自該項(xiàng)目的一系列構(gòu)建擴(kuò)展 -->
        <extensions>
            <!--描述使用到的構(gòu)建擴(kuò)展。 -->
            <extension>
                <!--構(gòu)建擴(kuò)展的groupid -->
                <groupid />
                <!--構(gòu)建擴(kuò)展的artifactid -->
                <artifactid />
                <!--構(gòu)建擴(kuò)展的版本 -->
                <version />
            </extension>
        </extensions>
        <!--當(dāng)項(xiàng)目沒有規(guī)定目標(biāo)（maven2 叫做階段）時(shí)的默認(rèn)值 -->
        <defaultgoal />
        <!--這個(gè)元素描述了項(xiàng)目相關(guān)的所有資源路徑列表，例如和項(xiàng)目相關(guān)的屬性文件，這些資源被包含在最終的打包文件里。 -->
        <resources>
            <!--這個(gè)元素描述了項(xiàng)目相關(guān)或測試相關(guān)的所有資源路徑 -->
            <resource>
                <!-- 描述了資源的目標(biāo)路徑。該路徑相對target/classes目錄（例如${project.build.outputdirectory}）。舉個(gè)例 
                    子，如果你想資源在特定的包里(org.apache.maven.messages)，你就必須該元素設(shè)置為org/apache/maven /messages。然而，如果你只是想把資源放到源碼目錄結(jié)構(gòu)里，就不需要該配置。 -->
                <targetpath />
                <!--是否使用參數(shù)值代替參數(shù)名。參數(shù)值取自properties元素或者文件里配置的屬性，文件在filters元素里列出。 -->
                <filtering />
                <!--描述存放資源的目錄，該路徑相對pom路徑 -->
                <directory />
                <!--包含的模式列表，例如**/*.xml. -->
                <includes />
                <!--排除的模式列表，例如**/*.xml -->
                <excludes />
            </resource>
        </resources>
        <!--這個(gè)元素描述了單元測試相關(guān)的所有資源路徑，例如和單元測試相關(guān)的屬性文件。 -->
        <testresources>
            <!--這個(gè)元素描述了測試相關(guān)的所有資源路徑，參見build/resources/resource元素的說明 -->
            <testresource>
                <targetpath />
                <filtering />
                <directory />
                <includes />
                <excludes />
            </testresource>
        </testresources>
        <!--構(gòu)建產(chǎn)生的所有文件存放的目錄 -->
        <directory />
        <!--產(chǎn)生的構(gòu)件的文件名，默認(rèn)值是${artifactid}-${version}。 -->
        <finalname />
        <!--當(dāng)filtering開關(guān)打開時(shí)，使用到的過濾器屬性文件列表 -->
        <filters />
        <!--子項(xiàng)目可以引用的默認(rèn)插件信息。該插件配置項(xiàng)直到被引用時(shí)才會(huì)被解析或綁定到生命周期。給定插件的任何本地配置都會(huì)覆蓋這里的配置 -->
        <pluginmanagement>
            <!--使用的插件列表 。 -->
            <plugins>
                <!--plugin元素包含描述插件所需要的信息。 -->
                <plugin>
                    <!--插件在倉庫里的group id -->
                    <groupid />
                    <!--插件在倉庫里的artifact id -->
                    <artifactid />
                    <!--被使用的插件的版本（或版本范圍） -->
                    <version />
                    <!--是否從該插件下載maven擴(kuò)展（例如打包和類型處理器），由于性能原因，只有在真需要下載時(shí)，該元素才被設(shè)置成enabled。 -->
                    <extensions />
                    <!--在構(gòu)建生命周期中執(zhí)行一組目標(biāo)的配置。每個(gè)目標(biāo)可能有不同的配置。 -->
                    <executions>
                        <!--execution元素包含了插件執(zhí)行需要的信息 -->
                        <execution>
                            <!--執(zhí)行目標(biāo)的標(biāo)識(shí)符，用于標(biāo)識(shí)構(gòu)建過程中的目標(biāo)，或者匹配繼承過程中需要合并的執(zhí)行目標(biāo) -->
                            <id />
                            <!--綁定了目標(biāo)的構(gòu)建生命周期階段，如果省略，目標(biāo)會(huì)被綁定到源數(shù)據(jù)里配置的默認(rèn)階段 -->
                            <phase />
                            <!--配置的執(zhí)行目標(biāo) -->
                            <goals />
                            <!--配置是否被傳播到子pom -->
                            <inherited />
                            <!--作為dom對象的配置 -->
                            <configuration />
                        </execution>
                    </executions>
                    <!--項(xiàng)目引入插件所需要的額外依賴 -->
                    <dependencies>
                        <!--參見dependencies/dependency元素 -->
                        <dependency>
                            ......
                        </dependency>
                    </dependencies>
                    <!--任何配置是否被傳播到子項(xiàng)目 -->
                    <inherited />
                    <!--作為dom對象的配置 -->
                    <configuration />
                </plugin>
            </plugins>
        </pluginmanagement>
        <!--使用的插件列表 -->
        <plugins>
            <!--參見build/pluginmanagement/plugins/plugin元素 -->
            <plugin>
                <groupid />
                <artifactid />
                <version />
                <extensions />
                <executions>
                    <execution>
                        <id />
                        <phase />
                        <goals />
                        <inherited />
                        <configuration />
                    </execution>
                </executions>
                <dependencies>
                    <!--參見dependencies/dependency元素 -->
                    <dependency>
                        ......
                    </dependency>
                </dependencies>
                <goals />
                <inherited />
                <configuration />
            </plugin>
        </plugins>
    </build>
    <!--在列的項(xiàng)目構(gòu)建profile，如果被激活，會(huì)修改構(gòu)建處理 -->
    <profiles>
        <!--根據(jù)環(huán)境參數(shù)或命令行參數(shù)激活某個(gè)構(gòu)建處理 -->
        <profile>
            <!--構(gòu)建配置的唯一標(biāo)識(shí)符。即用于命令行激活，也用于在繼承時(shí)合并具有相同標(biāo)識(shí)符的profile。 -->
            <id />
            <!--自動(dòng)觸發(fā)profile的條件邏輯。activation是profile的開啟鑰匙。profile的力量來自于它 能夠在某些特定的環(huán)境中自動(dòng)使用某些特定的值；這些環(huán)境通過activation元素指定。activation元素并不是激活profile的唯一方式。 -->
            <activation>
                <!--profile默認(rèn)是否激活的標(biāo)志 -->
                <activebydefault />
                <!--當(dāng)匹配的jdk被檢測到，profile被激活。例如，1.4激活jdk1.4，1.4.0_2，而!1.4激活所有版本不是以1.4開頭的jdk。 -->
                <jdk />
                <!--當(dāng)匹配的操作系統(tǒng)屬性被檢測到，profile被激活。os元素可以定義一些操作系統(tǒng)相關(guān)的屬性。 -->
                <os>
                    <!--激活profile的操作系統(tǒng)的名字 -->
                    <name>windows xp</name>
                    <!--激活profile的操作系統(tǒng)所屬家族(如 'windows') -->
                    <family>windows</family>
                    <!--激活profile的操作系統(tǒng)體系結(jié)構(gòu) -->
                    <arch>x86</arch>
                    <!--激活profile的操作系統(tǒng)版本 -->
                    <version>5.1.2600</version>
                </os>
                <!--如果maven檢測到某一個(gè)屬性（其值可以在pom中通過${名稱}引用），其擁有對應(yīng)的名稱和值，profile就會(huì)被激活。如果值 字段是空的，那么存在屬性名稱字段就會(huì)激活profile，否則按區(qū)分大小寫方式匹配屬性值字段 -->
                <property>
                    <!--激活profile的屬性的名稱 -->
                    <name>mavenversion</name>
                    <!--激活profile的屬性的值 -->
                    <value>2.0.3</value>
                </property>
                <!--提供一個(gè)文件名，通過檢測該文件的存在或不存在來激活profile。missing檢查文件是否存在，如果不存在則激活 profile。另一方面，exists則會(huì)檢查文件是否存在，如果存在則激活profile。 -->
                <file>
                    <!--如果指定的文件存在，則激活profile。 -->
                    <exists>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/
                    </exists>
                    <!--如果指定的文件不存在，則激活profile。 -->
                    <missing>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/
                    </missing>
                </file>
            </activation>
            <!--構(gòu)建項(xiàng)目所需要的信息。參見build元素 -->
            <build>
                <defaultgoal />
                <resources>
                    <resource>
                        <targetpath />
                        <filtering />
                        <directory />
                        <includes />
                        <excludes />
                    </resource>
                </resources>
                <testresources>
                    <testresource>
                        <targetpath />
                        <filtering />
                        <directory />
                        <includes />
                        <excludes />
                    </testresource>
                </testresources>
                <directory />
                <finalname />
                <filters />
                <pluginmanagement>
                    <plugins>
                        <!--參見build/pluginmanagement/plugins/plugin元素 -->
                        <plugin>
                            <groupid />
                            <artifactid />
                            <version />
                            <extensions />
                            <executions>
                                <execution>
                                    <id />
                                    <phase />
                                    <goals />
                                    <inherited />
                                    <configuration />
                                </execution>
                            </executions>
                            <dependencies>
                                <!--參見dependencies/dependency元素 -->
                                <dependency>
                                    ......
                                </dependency>
                            </dependencies>
                            <goals />
                            <inherited />
                            <configuration />
                        </plugin>
                    </plugins>
                </pluginmanagement>
                <plugins>
                    <!--參見build/pluginmanagement/plugins/plugin元素 -->
                    <plugin>
                        <groupid />
                        <artifactid />
                        <version />
                        <extensions />
                        <executions>
                            <execution>
                                <id />
                                <phase />
                                <goals />
                                <inherited />
                                <configuration />
                            </execution>
                        </executions>
                        <dependencies>
                            <!--參見dependencies/dependency元素 -->
                            <dependency>
                                ......
                            </dependency>
                        </dependencies>
                        <goals />
                        <inherited />
                        <configuration />
                    </plugin>
                </plugins>
            </build>
            <!--模塊（有時(shí)稱作子項(xiàng)目） 被構(gòu)建成項(xiàng)目的一部分。列出的每個(gè)模塊元素是指向該模塊的目錄的相對路徑 -->
            <modules />
            <!--發(fā)現(xiàn)依賴和擴(kuò)展的遠(yuǎn)程倉庫列表。 -->
            <repositories>
                <!--參見repositories/repository元素 -->
                <repository>
                    <releases>
                        <enabled />
                        <updatepolicy />
                        <checksumpolicy />
                    </releases>
                    <snapshots>
                        <enabled />
                        <updatepolicy />
                        <checksumpolicy />
                    </snapshots>
                    <id />
                    <name />
                    <url />
                    <layout />
                </repository>
            </repositories>
            <!--發(fā)現(xiàn)插件的遠(yuǎn)程倉庫列表，這些插件用于構(gòu)建和報(bào)表 -->
            <pluginrepositories>
                <!--包含需要連接到遠(yuǎn)程插件倉庫的信息.參見repositories/repository元素 -->
                <pluginrepository>
                    <releases>
                        <enabled />
                        <updatepolicy />
                        <checksumpolicy />
                    </releases>
                    <snapshots>
                        <enabled />
                        <updatepolicy />
                        <checksumpolicy />
                    </snapshots>
                    <id />
                    <name />
                    <url />
                    <layout />
                </pluginrepository>
            </pluginrepositories>
            <!--該元素描述了項(xiàng)目相關(guān)的所有依賴。 這些依賴組成了項(xiàng)目構(gòu)建過程中的一個(gè)個(gè)環(huán)節(jié)。它們自動(dòng)從項(xiàng)目定義的倉庫中下載。要獲取更多信息，請看項(xiàng)目依賴機(jī)制。 -->
            <dependencies>
                <!--參見dependencies/dependency元素 -->
                <dependency>
                    ......
                </dependency>
            </dependencies>
            <!--不贊成使用. 現(xiàn)在maven忽略該元素. -->
            <reports />
            <!--該元素包括使用報(bào)表插件產(chǎn)生報(bào)表的規(guī)范。當(dāng)用戶執(zhí)行"mvn site"，這些報(bào)表就會(huì)運(yùn)行。 在頁面導(dǎo)航欄能看到所有報(bào)表的鏈接。參見reporting元素 -->
            <reporting>
                ......
            </reporting>
            <!--參見dependencymanagement元素 -->
            <dependencymanagement>
                <dependencies>
                    <!--參見dependencies/dependency元素 -->
                    <dependency>
                        ......
                    </dependency>
                </dependencies>
            </dependencymanagement>
            <!--參見distributionmanagement元素 -->
            <distributionmanagement>
                ......
            </distributionmanagement>
            <!--參見properties元素 -->
            <properties />
        </profile>
    </profiles>
    <!--模塊（有時(shí)稱作子項(xiàng)目） 被構(gòu)建成項(xiàng)目的一部分。列出的每個(gè)模塊元素是指向該模塊的目錄的相對路徑 -->
    <modules />
    <!--發(fā)現(xiàn)依賴和擴(kuò)展的遠(yuǎn)程倉庫列表。 -->
    <repositories>
        <!--包含需要連接到遠(yuǎn)程倉庫的信息 -->
        <repository>
            <!--如何處理遠(yuǎn)程倉庫里發(fā)布版本的下載 -->
            <releases>
                <!--true或者false表示該倉庫是否為下載某種類型構(gòu)件（發(fā)布版，快照版）開啟。 -->
                <enabled />
                <!--該元素指定更新發(fā)生的頻率。maven會(huì)比較本地pom和遠(yuǎn)程pom的時(shí)間戳。這里的選項(xiàng)是：always（一直），daily（默認(rèn)，每日），interval：x（這里x是以分鐘為單位的時(shí)間間隔），或者never（從不）。 -->
                <updatepolicy />
                <!--當(dāng)maven驗(yàn)證構(gòu)件校驗(yàn)文件失敗時(shí)該怎么做：ignore（忽略），fail（失敗），或者warn（警告）。 -->
                <checksumpolicy />
            </releases>
            <!-- 如何處理遠(yuǎn)程倉庫里快照版本的下載。有了releases和snapshots這兩組配置，pom就可以在每個(gè)單獨(dú)的倉庫中，為每種類型的構(gòu)件采取不同的 
                策略。例如，可能有人會(huì)決定只為開發(fā)目的開啟對快照版本下載的支持。參見repositories/repository/releases元素 -->
            <snapshots>
                <enabled />
                <updatepolicy />
                <checksumpolicy />
            </snapshots>
            <!--遠(yuǎn)程倉庫唯一標(biāo)識(shí)符。可以用來匹配在settings.xml文件里配置的遠(yuǎn)程倉庫 -->
            <id>banseon-repository-proxy</id>
            <!--遠(yuǎn)程倉庫名稱 -->
            <name>banseon-repository-proxy</name>
            <!--遠(yuǎn)程倉庫url，按protocol://hostname/path形式 -->
            <url>http://192.168.1.169:9999/repository/</url>
            <!-- 用于定位和排序構(gòu)件的倉庫布局類型-可以是default（默認(rèn)）或者legacy（遺留）。maven 2為其倉庫提供了一個(gè)默認(rèn)的布局；然 
                而，maven 1.x有一種不同的布局。我們可以使用該元素指定布局是default（默認(rèn)）還是legacy（遺留）。 -->
            <layout>default</layout>
        </repository>
    </repositories>
    <!--發(fā)現(xiàn)插件的遠(yuǎn)程倉庫列表，這些插件用于構(gòu)建和報(bào)表 -->
    <pluginrepositories>
        <!--包含需要連接到遠(yuǎn)程插件倉庫的信息.參見repositories/repository元素 -->
        <pluginrepository>
            ......
        </pluginrepository>
    </pluginrepositories>
 
 
    <!--該元素描述了項(xiàng)目相關(guān)的所有依賴。 這些依賴組成了項(xiàng)目構(gòu)建過程中的一個(gè)個(gè)環(huán)節(jié)。它們自動(dòng)從項(xiàng)目定義的倉庫中下載。要獲取更多信息，請看項(xiàng)目依賴機(jī)制。 -->
    <dependencies>
        <dependency>
            <!--依賴的group id -->
            <groupid>org.apache.maven</groupid>
            <!--依賴的artifact id -->
            <artifactid>maven-artifact</artifactid>
            <!--依賴的版本號(hào)。 在maven 2里, 也可以配置成版本號(hào)的范圍。 -->
            <version>3.8.1</version>
            <!-- 依賴類型，默認(rèn)類型是jar。它通常表示依賴的文件的擴(kuò)展名，但也有例外。一個(gè)類型可以被映射成另外一個(gè)擴(kuò)展名或分類器。類型經(jīng)常和使用的打包方式對應(yīng)， 
                盡管這也有例外。一些類型的例子：jar，war，ejb-client和test-jar。如果設(shè)置extensions為 true，就可以在 plugin里定義新的類型。所以前面的類型的例子不完整。 -->
            <type>jar</type>
            <!-- 依賴的分類器。分類器可以區(qū)分屬于同一個(gè)pom，但不同構(gòu)建方式的構(gòu)件。分類器名被附加到文件名的版本號(hào)后面。例如，如果你想要構(gòu)建兩個(gè)單獨(dú)的構(gòu)件成 
                jar，一個(gè)使用java 1.4編譯器，另一個(gè)使用java 6編譯器，你就可以使用分類器來生成兩個(gè)單獨(dú)的jar構(gòu)件。 -->
            <classifier></classifier>
            <!--依賴范圍。在項(xiàng)目發(fā)布過程中，幫助決定哪些構(gòu)件被包括進(jìn)來。欲知詳情請參考依賴機(jī)制。 - compile ：默認(rèn)范圍，用于編譯 - provided：類似于編譯，但支持你期待jdk或者容器提供，類似于classpath 
                - runtime: 在執(zhí)行時(shí)需要使用 - test: 用于test任務(wù)時(shí)使用 - system: 需要外在提供相應(yīng)的元素。通過systempath來取得 
                - systempath: 僅用于范圍為system。提供相應(yīng)的路徑 - optional: 當(dāng)項(xiàng)目自身被依賴時(shí)，標(biāo)注依賴是否傳遞。用于連續(xù)依賴時(shí)使用 -->
            <scope>test</scope>
            <!--僅供system范圍使用。注意，不鼓勵(lì)使用這個(gè)元素，并且在新的版本中該元素可能被覆蓋掉。該元素為依賴規(guī)定了文件系統(tǒng)上的路徑。需要絕對路徑而不是相對路徑。推薦使用屬性匹配絕對路徑，例如${java.home}。 -->
            <systempath></systempath>
            <!--當(dāng)計(jì)算傳遞依賴時(shí)， 從依賴構(gòu)件列表里，列出被排除的依賴構(gòu)件集。即告訴maven你只依賴指定的項(xiàng)目，不依賴項(xiàng)目的依賴。此元素主要用于解決版本沖突問題 -->
            <exclusions>
                <exclusion>
                    <artifactid>spring-core</artifactid>
                    <groupid>org.springframework</groupid>
                </exclusion>
            </exclusions>
            <!--可選依賴，如果你在項(xiàng)目b中把c依賴聲明為可選，你就需要在依賴于b的項(xiàng)目（例如項(xiàng)目a）中顯式的引用對c的依賴。可選依賴阻斷依賴的傳遞性。 -->
            <optional>true</optional>
        </dependency>
    </dependencies>
    <!--不贊成使用. 現(xiàn)在maven忽略該元素. -->
    <reports></reports>
    <!--該元素描述使用報(bào)表插件產(chǎn)生報(bào)表的規(guī)范。當(dāng)用戶執(zhí)行"mvn site"，這些報(bào)表就會(huì)運(yùn)行。 在頁面導(dǎo)航欄能看到所有報(bào)表的鏈接。 -->
    <reporting>
        <!--true，則，網(wǎng)站不包括默認(rèn)的報(bào)表。這包括"項(xiàng)目信息"菜單中的報(bào)表。 -->
        <excludedefaults />
        <!--所有產(chǎn)生的報(bào)表存放到哪里。默認(rèn)值是${project.build.directory}/site。 -->
        <outputdirectory />
        <!--使用的報(bào)表插件和他們的配置。 -->
        <plugins>
            <!--plugin元素包含描述報(bào)表插件需要的信息 -->
            <plugin>
                <!--報(bào)表插件在倉庫里的group id -->
                <groupid />
                <!--報(bào)表插件在倉庫里的artifact id -->
                <artifactid />
                <!--被使用的報(bào)表插件的版本（或版本范圍） -->
                <version />
                <!--任何配置是否被傳播到子項(xiàng)目 -->
                <inherited />
                <!--報(bào)表插件的配置 -->
                <configuration />
                <!--一組報(bào)表的多重規(guī)范，每個(gè)規(guī)范可能有不同的配置。一個(gè)規(guī)范（報(bào)表集）對應(yīng)一個(gè)執(zhí)行目標(biāo) 。例如，有1，2，3，4，5，6，7，8，9個(gè)報(bào)表。1，2，5構(gòu)成a報(bào)表集，對應(yīng)一個(gè)執(zhí)行目標(biāo)。2，5，8構(gòu)成b報(bào)表集，對應(yīng)另一個(gè)執(zhí)行目標(biāo) -->
                <reportsets>
                    <!--表示報(bào)表的一個(gè)集合，以及產(chǎn)生該集合的配置 -->
                    <reportset>
                        <!--報(bào)表集合的唯一標(biāo)識(shí)符，pom繼承時(shí)用到 -->
                        <id />
                        <!--產(chǎn)生報(bào)表集合時(shí)，被使用的報(bào)表的配置 -->
                        <configuration />
                        <!--配置是否被繼承到子poms -->
                        <inherited />
                        <!--這個(gè)集合里使用到哪些報(bào)表 -->
                        <reports />
                    </reportset>
                </reportsets>
            </plugin>
        </plugins>
    </reporting>
    <!-- 繼承自該項(xiàng)目的所有子項(xiàng)目的默認(rèn)依賴信息。這部分的依賴信息不會(huì)被立即解析,而是當(dāng)子項(xiàng)目聲明一個(gè)依賴（必須描述group id和 artifact 
        id信息），如果group id和artifact id以外的一些信息沒有描述，則通過group id和artifact id 匹配到這里的依賴，并使用這里的依賴信息。 -->
    <dependencymanagement>
        <dependencies>
            <!--參見dependencies/dependency元素 -->
            <dependency>
                ......
            </dependency>
        </dependencies>
    </dependencymanagement>
    <!--項(xiàng)目分發(fā)信息，在執(zhí)行mvn deploy后表示要發(fā)布的位置。有了這些信息就可以把網(wǎng)站部署到遠(yuǎn)程服務(wù)器或者把構(gòu)件部署到遠(yuǎn)程倉庫。 -->
    <distributionmanagement>
        <!--部署項(xiàng)目產(chǎn)生的構(gòu)件到遠(yuǎn)程倉庫需要的信息 -->
        <repository>
            <!--是分配給快照一個(gè)唯一的版本號(hào)（由時(shí)間戳和構(gòu)建流水號(hào)）？還是每次都使用相同的版本號(hào)？參見repositories/repository元素 -->
            <uniqueversion />
            <id>banseon-maven2</id>
            <name>banseon maven2</name>
            <url>file://${basedir}/target/deploy</url>
            <layout />
        </repository>
        <!--構(gòu)件的快照部署到哪里？如果沒有配置該元素，默認(rèn)部署到repository元素配置的倉庫，參見distributionmanagement/repository元素 -->
        <snapshotrepository>
            <uniqueversion />
            <id>banseon-maven2</id>
            <name>banseon-maven2 snapshot repository</name>
            <url>scp://svn.baidu.com/banseon:/usr/local/maven-snapshot</url>
            <layout />
        </snapshotrepository>
        <!--部署項(xiàng)目的網(wǎng)站需要的信息 -->
        <site>
            <!--部署位置的唯一標(biāo)識(shí)符，用來匹配站點(diǎn)和settings.xml文件里的配置 -->
            <id>banseon-site</id>
            <!--部署位置的名稱 -->
            <name>business api website</name>
            <!--部署位置的url，按protocol://hostname/path形式 -->
            <url>
                scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web
            </url>
        </site>
        <!--項(xiàng)目下載頁面的url。如果沒有該元素，用戶應(yīng)該參考主頁。使用該元素的原因是：幫助定位那些不在倉庫里的構(gòu)件（由于license限制）。 -->
        <downloadurl />
        <!--如果構(gòu)件有了新的group id和artifact id（構(gòu)件移到了新的位置），這里列出構(gòu)件的重定位信息。 -->
        <relocation>
            <!--構(gòu)件新的group id -->
            <groupid />
            <!--構(gòu)件新的artifact id -->
            <artifactid />
            <!--構(gòu)件新的版本號(hào) -->
            <version />
            <!--顯示給用戶的，關(guān)于移動(dòng)的額外信息，例如原因。 -->
            <message />
        </relocation>
        <!-- 給出該構(gòu)件在遠(yuǎn)程倉庫的狀態(tài)。不得在本地項(xiàng)目中設(shè)置該元素，因?yàn)檫@是工具自動(dòng)更新的。有效的值有：none（默認(rèn)），converted（倉庫管理員從 
            maven 1 pom轉(zhuǎn)換過來），partner（直接從伙伴maven 2倉庫同步過來），deployed（從maven 2實(shí)例部 署），verified（被核實(shí)時(shí)正確的和最終的）。 -->
        <status />
    </distributionmanagement>
    <!--以值替代名稱，properties可以在整個(gè)pom中使用，也可以作為觸發(fā)條件（見settings.xml配置文件里activation元素的說明）。格式是<name>value</name>。 -->
    <properties />
</project>