1. 程式人生 > >Maven配置檔案pom.xml詳解(轉)

Maven配置檔案pom.xml詳解(轉)

什麼是POM?

POM是專案物件模型(Project Object Model)的簡稱,它是Maven專案中的檔案,使用XML表示,名稱叫做pom.xml。在Maven中,當談到Project的時候,不僅僅是一堆包含程式碼的檔案。一個Project往往包含一個配置檔案,包括了與開發者有關的,缺陷跟蹤系統,組織與許可,專案的URL,專案依賴,以及其他。它包含了所有與這個專案相關的東西。事實上,在Maven世界中,project可以什麼都沒有,甚至沒有程式碼,但是必須包含pom.xml檔案。

概覽

下面是一個POM專案中的pom.xml檔案中包含的元素。注意,其中的modelVersion是4.0.0,這是當前僅有的可以被Maven2&3同時支援的POM版本,它是必須的。

複製程式碼

 1 <project xmlns="http://maven.apache.org/POM/4.0.0"
 2          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
 4             http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5     <modelVersion>4.0.0</modelVersion>
 6     
 7     <!-- 基本設定 -->
 8     <groupId>...</groupId>
 9     <artifactId>...</artifactId>
10     <version>...</version>
11     <packaging>...</packaging>
12     <dependencies>...</dependencies>
13     <parent>...</parent>
14     <dependencyManagement>...</dependencyManagement>
15     <modules>...</modules>
16     <properties>...</properties>
17     
18     <!-- 構建過程的設定 -->
19     <build>...</build>
20     <reporting>...</reporting>
21     
22     <!-- 專案資訊設定 -->
23     <name>...</name>
24     <description>...</description>
25     <url>...</url>
26     <inceptionYear>...</inceptionYear>
27     <licenses>...</licenses>
28     <organization>...</organization>
29     <developers>...</developers>
30     <contributors>...</contributors>
31     
32     <!-- 環境設定 -->
33     <issueManagement>...</issueManagement>
34     <ciManagement>...</ciManagement>
35     <mailingLists>...</mailingLists>
36     <scm>...</scm>
37     <prerequisites>...</prerequisites>
38     <repositories>...</repositories>
39     <pluginRepositories>...</pluginRepositories>
40     <distributionManagement>...</distributionManagement>
41     <profiles>...</profiles>
42 </project>

複製程式碼

基本的設定:

POM包含了一個project所需要的所有資訊,當然也就包含了構建過程中所需要的外掛的配置資訊,事實上,這裡申明瞭"who","what",和"where",然而構建生命週期(build lifecycle)s中說的是"when"和"how"。這並不是說POM並能影響生命週期的過程-事實上它可以。例如,配置一個可以嵌入ant任務到POM的mavem-antrun-plugin。它基本上就是一個宣告。就像build.xml告訴ant當執行時它該做什麼一樣,一個POM申明瞭它自己的配置。如果外力迫使生命週期跳過了ant外掛的執行,這並不影響那些已經執行過的外掛產生的效果。這一點和build.xml不一樣。

 

複製程式碼

1 <project xmlns="http://maven.apache.org/POM/4.0.0"
2          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
3          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
4             http://maven.apache.org/xsd/maven-4.0.0.xsd">
5     <modelVersion>4.0.0</modelVersion>
6     <groupId>org.codehaus.mojo</groupId>
7     <artifactId>my-project</artifactId>
8     <version>1.0</version>
9 </project>

複製程式碼

Maven座標

上面的POM定義的是Maven2&3都承認的最小部分。groupId:artifactId:version是必須的欄位(儘管在繼承中groupId和version不需要明確指出)。這三個欄位就像地址和郵戳,它標記了倉庫中的特定位置,就像Maven projects的座標系統一樣。

 

maven POM.xml詳解

[html] view plaincopy

 

  1. <project xmlns="http://maven.apache.org/POM/4.0.0"     
  2.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"     
  3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0http://maven.apache.org/maven-v4_0_0.xsd">     
  4.     <!--父專案的座標。如果專案中沒有規定某個元素的值,那麼父專案中的對應值即為專案的預設值。 座標包括group ID,artifact ID和 version。-->    
  5.     <parent>    
  6.      <!--被繼承的父專案的構件識別符號-->    
  7.      <artifactId/>    
  8.      <!--被繼承的父專案的全球唯一識別符號-->    
  9.      <groupId/>    
  10.      <!--被繼承的父專案的版本-->    
  11.      <version/>    
  12.      <!-- 父專案的pom.xml檔案的相對路徑。相對路徑允許你選擇一個不同的路徑。預設值是../pom.xml。Maven首先在構建當前專案的地方尋找父項 目的pom,其次在檔案系統的這個位置(relativePath位置),然後在本地倉庫,最後在遠端倉庫尋找父專案的pom。-->    
  13.      <relativePath/>    
  14.  </parent>    
  15.  <!--宣告專案描述符遵循哪一個POM模型版本。模型本身的版本很少改變,雖然如此,但它仍然是必不可少的,這是為了當Maven引入了新的特性或者其他模型變更的時候,確保穩定性。-->       
  16.     <modelVersion>4.0.0</modelVersion>     
  17.     <!--專案的全球唯一識別符號,通常使用全限定的包名區分該專案和其他專案。並且構建時生成的路徑也是由此生成, 如com.mycompany.app生成的相對路徑為:/com/mycompany/app-->     
  18.     <groupId>asia.banseon</groupId>     
  19.     <!-- 構件的識別符號,它和group ID一起唯一標識一個構件。換句話說,你不能有兩個不同的專案擁有同樣的artifact ID和groupID;在某個 特定的group ID下,artifact ID也必須是唯一的。構件是專案產生的或使用的一個東西,Maven為專案產生的構件包括:JARs,源 碼,二進位制釋出和WARs等。-->     
  20.     <artifactId>banseon-maven2</artifactId>     
  21.     <!--專案產生的構件型別,例如jar、war、ear、pom。外掛可以建立他們自己的構件型別,所以前面列的不是全部構件型別-->     
  22.     <packaging>jar</packaging>     
  23.     <!--專案當前版本,格式為:主版本.次版本.增量版本-限定版本號-->     
  24.     <version>1.0-SNAPSHOT</version>     
  25.     <!--專案的名稱, Maven產生的文件用-->     
  26.     <name>banseon-maven</name>     
  27.     <!--專案主頁的URL, Maven產生的文件用-->     
  28.     <url>http://www.baidu.com/banseon</url>     
  29.     <!-- 專案的詳細描述, Maven 產生的文件用。  當這個元素能夠用HTML格式描述時(例如,CDATA中的文字會被解析器忽略,就可以包含HTML標 籤), 不鼓勵使用純文字描述。如果你需要修改產生的web站點的索引頁面,你應該修改你自己的索引頁檔案,而不是調整這裡的文件。-->     
  30.     <description>A maven project to study maven.</description>     
  31.     <!--描述了這個專案構建環境中的前提條件。-->    
  32.  <prerequisites>    
  33.   <!--構建該專案或使用該外掛所需要的Maven的最低版本-->    
  34.     <maven/>    
  35.  </prerequisites>    
  36.  <!--專案的問題管理系統(Bugzilla, Jira, Scarab,或任何你喜歡的問題管理系統)的名稱和URL,本例為 jira-->     
  37.     <issueManagement>    
  38.      <!--問題管理系統(例如jira)的名字,-->     
  39.         <system>jira</system>     
  40.         <!--該專案使用的問題管理系統的URL-->    
  41.         <url>http://jira.baidu.com/banseon</url>     
  42.     </issueManagement>     
  43.     <!--專案持續整合資訊-->    
  44.  <ciManagement>    
  45.   <!--持續整合系統的名字,例如continuum-->    
  46.   <system/>    
  47.   <!--該專案使用的持續整合系統的URL(如果持續整合系統有web介面的話)。-->    
  48.   <url/>    
  49.   <!--構建完成時,需要通知的開發者/使用者的配置項。包括被通知者資訊和通知條件(錯誤,失敗,成功,警告)-->    
  50.   <notifiers>    
  51.    <!--配置一種方式,當構建中斷時,以該方式通知使用者/開發者-->    
  52.    <notifier>    
  53.     <!--傳送通知的途徑-->    
  54.     <type/>    
  55.     <!--發生錯誤時是否通知-->    
  56.     <sendOnError/>    
  57.     <!--構建失敗時是否通知-->    
  58.     <sendOnFailure/>    
  59.     <!--構建成功時是否通知-->    
  60.     <sendOnSuccess/>    
  61.     <!--發生警告時是否通知-->    
  62.     <sendOnWarning/>    
  63.     <!--不贊成使用。通知傳送到哪裡-->    
  64.     <address/>    
  65.     <!--擴充套件配置項-->    
  66.     <configuration/>    
  67.    </notifier>    
  68.   </notifiers>    
  69.  </ciManagement>    
  70.  <!--專案建立年份,4位數字。當產生版權資訊時需要使用這個值。-->    
  71.     <inceptionYear/>    
  72.     <!--專案相關郵件列表資訊-->     
  73.     <mailingLists>    
  74.      <!--該元素描述了專案相關的所有郵件列表。自動產生的網站引用這些資訊。-->     
  75.         <mailingList>     
  76.          <!--郵件的名稱-->    
  77.             <name>Demo</name>     
  78.             <!--傳送郵件的地址或連結,如果是郵件地址,建立文件時,mailto: 連結會被自動建立-->     
  79.             <post>[email protected]</post>     
  80.             <!--訂閱郵件的地址或連結,如果是郵件地址,建立文件時,mailto: 連結會被自動建立-->     
  81.             <subscribe>[email protected]</subscribe>     
  82.             <!--取消訂閱郵件的地址或連結,如果是郵件地址,建立文件時,mailto: 連結會被自動建立-->     
  83.             <unsubscribe>[email protected]</unsubscribe>     
  84.             <!--你可以瀏覽郵件資訊的URL-->    
  85.             <archive>http:/hi.baidu.com/banseon/demo/dev/</archive>     
  86.         </mailingList>     
  87.     </mailingLists>     
  88.     <!--專案開發者列表-->     
  89.     <developers>     
  90.      <!--某個專案開發者的資訊-->    
  91.         <developer>     
  92.          <!--SCM裡專案開發者的唯一識別符號-->    
  93.             <id>HELLO WORLD</id>     
  94.             <!--專案開發者的全名-->    
  95.             <name>banseon</name>     
  96.             <!--專案開發者的email-->    
  97.             <email>[email protected]</email>     
  98.             <!--專案開發者的主頁的URL-->    
  99.             <url/>    
  100.             <!--專案開發者在專案中扮演的角色,角色元素描述了各種角色-->    
  101.             <roles>     
  102.                 <role>Project Manager</role>     
  103.                 <role>Architect</role>     
  104.             </roles>    
  105.             <!--專案開發者所屬組織-->    
  106.             <organization>demo</organization>     
  107.             <!--專案開發者所屬組織的URL-->    
  108.             <organizationUrl>http://hi.baidu.com/banseon</organizationUrl>     
  109.             <!--專案開發者屬性,如即時訊息如何處理等-->    
  110.             <properties>     
  111.                 <dept>No</dept>     
  112.             </properties>    
  113.             <!--專案開發者所在時區, -11到12範圍內的整數。-->    
  114.             <timezone>-5</timezone>     
  115.         </developer>     
  116.     </developers>     
  117.     <!--專案的其他貢獻者列表-->     
  118.     <contributors>    
  119.      <!--專案的其他貢獻者。參見developers/developer元素-->    
  120.      <contributor>    
  121.    <name/><email/><url/><organization/><organizationUrl/><roles/><timezone/><properties/>    
  122.      </contributor>         
  123.     </contributors>       
  124.     <!--該元素描述了專案所有License列表。 應該只列出該專案的license列表,不要列出依賴專案的 license列表。如果列出多個license,使用者可以選擇它們中的一個而不是接受所有license。-->     
  125.     <licenses>    
  126.      <!--描述了專案的license,用於生成專案的web站點的license頁面,其他一些報表和validation也會用到該元素。-->     
  127.         <license>    
  128.          <!--license用於法律上的名稱-->    
  129.             <name>Apache 2</name>     
  130.             <!--官方的license正文頁面的URL-->    
  131.             <url>http://www.baidu.com/banseon/LICENSE-2.0.txt</url>     
  132.             <!--專案分發的主要方式:    
  133.               repo,可以從Maven庫下載    
  134.               manual, 使用者必須手動下載和安裝依賴-->    
  135.             <distribution>repo</distribution>     
  136.             <!--關於license的補充資訊-->    
  137.             <comments>A business-friendly OSS license</comments>     
  138.         </license>     
  139.     </licenses>     
  140.     <!--SCM(Source Control Management)標籤允許你配置你的程式碼庫,供Maven web站點和其它外掛使用。-->     
  141.     <scm>     
  142.         <!--SCM的URL,該URL描述了版本庫和如何連線到版本庫。欲知詳情,請看SCMs提供的URL格式和列表。該連線只讀。-->     
  143.         <connection>     
  144.             scm:svn:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk)      
  145.         </connection>     
  146.         <!--給開發者使用的,類似connection元素。即該連線不僅僅只讀-->    
  147.         <developerConnection>     
  148.             scm:svn:http://svn.baidu.com/banseon/maven/banseon/dao-trunk      
  149.         </developerConnection>    
  150.         <!--當前程式碼的標籤,在開發階段預設為HEAD-->    
  151.         <tag/>           
  152.         <!--指向專案的可瀏覽SCM庫(例如ViewVC或者Fisheye)的URL。-->     
  153.         <url>http://svn.baidu.com/banseon</url>     
  154.     </scm>     
  155.     <!--描述專案所屬組織的各種屬性。Maven產生的文件用-->     
  156.     <organization>     
  157.      <!--組織的全名-->    
  158.         <name>demo</name>     
  159.         <!--組織主頁的URL-->    
  160.         <url>http://www.baidu.com/banseon</url>     
  161.     </organization>    
  162.     <!--構建專案需要的資訊-->    
  163.     <build>    
  164.      <!--該元素設定了專案原始碼目錄,當構建專案的時候,構建系統會編譯目錄裡的原始碼。該路徑是相對於pom.xml的相對路徑。-->    
  165.   <sourceDirectory/>    
  166.   <!--該元素設定了專案指令碼原始碼目錄,該目錄和原始碼目錄不同:絕大多數情況下,該目錄下的內容 會被拷貝到輸出目錄(因為指令碼是被解釋的,而不是被編譯的)。-->    
  167.   <scriptSourceDirectory/>    
  168.   <!--該元素設定了專案單元測試使用的原始碼目錄,當測試專案的時候,構建系統會編譯目錄裡的原始碼。該路徑是相對於pom.xml的相對路徑。-->    
  169.   <testSourceDirectory/>    
  170.   <!--被編譯過的應用程式class檔案存放的目錄。-->    
  171.   <outputDirectory/>    
  172.   <!--被編譯過的測試class檔案存放的目錄。-->    
  173.   <testOutputDirectory/>    
  174.   <!--使用來自該專案的一系列構建擴充套件-->    
  175.   <extensions>    
  176.    <!--描述使用到的構建擴充套件。-->    
  177.    <extension>    
  178.     <!--構建擴充套件的groupId-->    
  179.     <groupId/>    
  180.     <!--構建擴充套件的artifactId-->    
  181.     <artifactId/>    
  182.     <!--構建擴充套件的版本-->    
  183.     <version/>    
  184.    </extension>    
  185.   </extensions>    
  186.   <!--當專案沒有規定目標(Maven2 叫做階段)時的預設值-->    
  187.   <defaultGoal/>    
  188.   <!--這個元素描述了專案相關的所有資源路徑列表,例如和專案相關的屬性檔案,這些資源被包含在最終的打包檔案裡。-->    
  189.   <resources>    
  190.    <!--這個元素描述了專案相關或測試相關的所有資源路徑-->    
  191.    <resource>    
  192.     <!-- 描述了資源的目標路徑。該路徑相對target/classes目錄(例如${project.build.outputDirectory})。舉個例 子,如果你想資源在特定的包裡(org.apache.maven.messages),你就必須該元素設定為org/apache/maven /messages。然而,如果你只是想把資源放到原始碼目錄結構裡,就不需要該配置。-->    
  193.     <targetPath/>    
  194.     <!--是否使用引數值代替引數名。引數值取自properties元素或者檔案裡配置的屬性,檔案在filters元素裡列出。-->    
  195.     <filtering/>    
  196.     <!--描述存放資源的目錄,該路徑相對POM路徑-->    
  197.     <directory/>    
  198.     <!--包含的模式列表,例如**/*.xml.-->    
  199.     <includes/>    
  200.     <!--排除的模式列表,例如**/*.xml-->    
  201.     <excludes/>    
  202.    </resource>    
  203.   </resources>    
  204.   <!--這個元素描述了單元測試相關的所有資源路徑,例如和單元測試相關的屬性檔案。-->    
  205.   <testResources>    
  206.    <!--這個元素描述了測試相關的所有資源路徑,參見build/resources/resource元素的說明-->    
  207.    <testResource>    
  208.     <targetPath/><filtering/><directory/><includes/><excludes/>    
  209.    </testResource>    
  210.   </testResources>    
  211.   <!--構建產生的所有檔案存放的目錄-->    
  212.   <directory/>    
  213.   <!--產生的構件的檔名,預設值是${artifactId}-${version}。-->    
  214.   <finalName/>    
  215.   <!--當filtering開關開啟時,使用到的過濾器屬性檔案列表-->    
  216.   <filters/>    
  217.   <!--子專案可以引用的預設外掛資訊。該外掛配置項直到被引用時才會被解析或繫結到生命週期。給定外掛的任何本地配置都會覆蓋這裡的配置-->    
  218.   <pluginManagement>    
  219.    <!--使用的外掛列表 。-->    
  220.    <plugins>    
  221.     <!--plugin元素包含描述外掛所需要的資訊。-->    
  222.     <plugin>    
  223.      <!--外掛在倉庫裡的group ID-->    
  224.      <groupId/>    
  225.      <!--外掛在倉庫裡的artifact ID-->    
  226.      <artifactId/>    
  227.      <!--被使用的外掛的版本(或版本範圍)-->    
  228.      <version/>    
  229.      <!--是否從該外掛下載Maven擴充套件(例如打包和型別處理器),由於效能原因,只有在真需要下載時,該元素才被設定成enabled。-->    
  230.      <extensions/>    
  231.      <!--在構建生命週期中執行一組目標的配置。每個目標可能有不同的配置。-->    
  232.      <executions>    
  233.       <!--execution元素包含了外掛執行需要的資訊-->    
  234.       <execution>    
  235.        <!--執行目標的識別符號,用於標識構建過程中的目標,或者匹配繼承過程中需要合併的執行目標-->    
  236.        <id/>    
  237.        <!--綁定了目標的構建生命週期階段,如果省略,目標會被繫結到源資料裡配置的預設階段-->    
  238.        <phase/>    
  239.        <!--配置的執行目標-->    
  240.        <goals/>    
  241.        <!--配置是否被傳播到子POM-->    
  242.        <inherited/>    
  243.        <!--作為DOM物件的配置-->    
  244.        <configuration/>    
  245.       </execution>    
  246.      </executions>    
  247.      <!--專案引入外掛所需要的額外依賴-->    
  248.      <dependencies>    
  249.       <!--參見dependencies/dependency元素-->    
  250.       <dependency>    
  251.        ......    
  252.       </dependency>    
  253.      </dependencies>         
  254.      <!--任何配置是否被傳播到子專案-->    
  255.      <inherited/>    
  256.      <!--作為DOM物件的配置-->    
  257.      <configuration/>    
  258.     </plugin>    
  259.    </plugins>    
  260.   </pluginManagement>    
  261.   <!--使用的外掛列表-->    
  262.   <plugins>    
  263.    <!--參見build/pluginManagement/plugins/plugin元素-->    
  264.    <plugin>    
  265.     <groupId/><artifactId/><version/><extensions/>    
  266.     <executions>    
  267.      <execution>    
  268.       <id/><phase/><goals/><inherited/><configuration/>    
  269.      </execution>    
  270.     </executions>    
  271.     <dependencies>    
  272.      <!--參見dependencies/dependency元素-->    
  273.      <dependency>    
  274.       ......    
  275.      </dependency>    
  276.     </dependencies>    
  277.     <goals/><inherited/><configuration/>    
  278.    </plugin>    
  279.   </plugins>    
  280.  </build>    
  281.  <!--在列的專案構建profile,如果被啟用,會修改構建處理-->    
  282.  <profiles>    
  283.   <!--根據環境引數或命令列引數啟用某個構建處理-->    
  284.   <profile>    
  285.    <!--構建配置的唯一識別符號。即用於命令列啟用,也用於在繼承時合併具有相同識別符號的profile。-->    
  286.    <id/>    
  287.    <!--自動觸發profile的條件邏輯。Activation是profile的開啟鑰匙。profile的力量來自於它    
  288.    能夠在某些特定的環境中自動使用某些特定的值;這些環境通過activation元素指定。activation元素並不是啟用profile的唯一方式。-->    
  289.    <activation>    
  290.     <!--profile預設是否啟用的標誌-->    
  291.     <activeByDefault/>    
  292.     <!--當匹配的jdk被檢測到,profile被啟用。例如,1.4啟用JDK1.4,1.4.0_2,而!1.4啟用所有版本不是以1.4開頭的JDK。-->    
  293.     <jdk/>    
  294.     <!--當匹配的作業系統屬性被檢測到,profile被啟用。os元素可以定義一些作業系統相關的屬性。-->    
  295.     <os>    
  296.      <!--啟用profile的作業系統的名字-->    
  297.      <name>Windows XP</name>    
  298.      <!--啟用profile的作業系統所屬家族(如 'windows')-->    
  299.      <family>Windows</family>    
  300.      <!--啟用profile的作業系統體系結構 -->    
  301.      <arch>x86</arch>    
  302.      <!--啟用profile的作業系統版本-->    
  303.      <version>5.1.2600</version>    
  304.     </os>    
  305.     <!--如果Maven檢測到某一個屬性(其值可以在POM中通過${名稱}引用),其擁有對應的名稱和值,Profile就會被啟用。如果值    
  306.     欄位是空的,那麼存在屬性名稱欄位就會啟用profile,否則按區分大小寫方式匹配屬性值欄位-->    
  307.     <property>    
  308.      <!--啟用profile的屬性的名稱-->    
  309.      <name>mavenVersion</name>    
  310.      <!--啟用profile的屬性的值-->    
  311.      <value>2.0.3</value>    
  312.     </property>    
  313.     <!--提供一個檔名,通過檢測該檔案的存在或不存在來啟用profile。missing檢查檔案是否存在,如果不存在則啟用    
  314.     profile。另一方面,exists則會檢查檔案是否存在,如果存在則啟用profile。-->    
  315.     <file>    
  316.      <!--如果指定的檔案存在,則啟用profile。-->    
  317.      <exists>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</exists>    
  318.      <!--如果指定的檔案不存在,則啟用profile。-->    
  319.      <missing>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</missing>    
  320.     </file>    
  321.    </activation>    
  322.    <!--構建專案所需要的資訊。參見build元素-->    
  323.    <build>    
  324.     <defaultGoal/>    
  325.     <resources>    
  326.      <resource>    
  327.       <targetPath/><filtering/><directory/><includes/><excludes/>    
  328.      </resource>    
  329.     </resources>    
  330.     <testResources>    
  331.      <testResource>    
  332.       <targetPath/><filtering/><directory/><includes/><excludes/>    
  333.      </testResource>    
  334.     </testResources>    
  335.     <directory/><finalName/><filters/>    
  336.     <pluginManagement>    
  337.      <plugins>    
  338.       <!--參見build/pluginManagement/plugins/plugin元素-->    
  339.       <plugin>    
  340.        <groupId/><artifactId/><version/><extensions/>    
  341.        <executions>    
  342.         <execution>    
  343.          <id/><phase/><goals/><inherited/><configuration/>    
  344.         </execution>    
  345.        </executions>    
  346.        <dependencies>    
  347.         <!--參見dependencies/dependency元素-->    
  348.         <dependency>    
  349.          ......    
  350.         </dependency>    
  351.        </dependencies>    
  352.        <goals/><inherited/><configuration/>    
  353.       </plugin>    
  354.      </plugins>    
  355.     </pluginManagement>    
  356.     <plugins>    
  357.      <!--參見build/pluginManagement/plugins/plugin元素-->    
  358.      <plugin>    
  359.       <groupId/><artifactId/><version/><extensions/>    
  360.       <executions>    
  361.        <execution>    
  362.         <id/><phase/><goals/><inherited/><configuration/>    
  363.        </execution>    
  364.       </executions>    
  365.       <dependencies>    
  366.        <!--參見dependencies/dependency元素-->    
  367.        <dependency>    
  368.         ......    
  369.        </dependency>    
  370.       </dependencies>    
  371.       <goals/><inherited/><configuration/>    
  372.      </plugin>    
  373.     </plugins>    
  374.    </build>    
  375.    <!--模組(有時稱作子專案) 被構建成專案的一部分。列出的每個模組元素是指向該模組的目錄的相對路徑-->    
  376.    <modules/>    
  377.    <!--發現依賴和擴充套件的遠端倉庫列表。-->    
  378.    <repositories>    
  379.     <!--參見repositories/repository元素-->    
  380.     <repository>    
  381.      <releases>    
  382.       <enabled/><updatePolicy/><checksumPolicy/>    
  383.      </releases>    
  384.      <snapshots>    
  385.       <enabled/><updatePolicy/><checksumPolicy/>    
  386.      </snapshots>    
  387.      <id/><name/><url/><layout/>    
  388.     </repository>    
  389.    </repositories>    
  390.    <!--發現外掛的遠端倉庫列表,這些外掛用於構建和報表-->    
  391.    <pluginRepositories>    
  392.     <!--包含需要連線到遠端外掛倉庫的資訊.參見repositories/repository元素-->        
  393.     <pluginRepository>    
  394.      <releases>    
  395.       <enabled/><updatePolicy/><checksumPolicy/>    
  396.      </releases>    
  397.      <snapshots>    
  398.       <enabled/><updatePolicy/><checksumPolicy/>    
  399.      </snapshots>    
  400.      <id/><name/><url/><layout/>    
  401.     </pluginRepository>    
  402.    </pluginRepositories>    
  403.    <!--該元素描述了專案相關的所有依賴。 這些依賴組成了專案構建過程中的一個個環節。它們自動從專案定義的倉庫中下載。要獲取更多資訊,請看專案依賴機制。-->    
  404.    <dependencies>    
  405.     <!--參見dependencies/dependency元素-->    
  406.     <dependency>    
  407.      ......    
  408.     </dependency>    
  409.    </dependencies>    
  410.    <!--不贊成使用. 現在Maven忽略該元素.-->    
  411.    <reports/>       
  412.    <!--該元素包括使用報表外掛產生報表的規範。當用戶執行“mvn site”,這些報表就會執行。 在頁面導航欄能看到所有報表的連結。參見reporting元素-->    
  413.    <reporting>    
  414.     ......    
  415.    </reporting>    
  416.    <!--參見dependencyManagement元素-->    
  417.    <dependencyManagement>    
  418.     <dependencies>    
  419.      <!--參見dependencies/dependency元素-->    
  420.      <dependency>    
  421.       ......    
  422.      </dependency>    
  423.     </dependencies>    
  424.    </dependencyManagement>    
  425.    <!--參見distributionManagement元素-->    
  426.    <distributionManagement>    
  427.     ......    
  428.    </distributionManagement>    
  429.    <!--參見properties元素-->    
  430.    <properties/>    
  431.   </profile>    
  432.  </profiles>    
  433.  <!--模組(有時稱作子專案) 被構建成專案的一部分。列出的每個模組元素是指向該模組的目錄的相對路徑-->    
  434.  <modules/>    
  435.     <!--發現依賴和擴充套件的遠端倉庫列表。-->     
  436.     <repositories>     
  437.      <!--包含需要連線到遠端倉庫的資訊-->    
  438.         <repository>    
  439.          <!--如何處理遠端倉庫裡釋出版本的下載-->    
  440.          <releases>    
  441.           <!--true或者false表示該倉庫是否為下載某種型別構件(釋出版,快照版)開啟。 -->    
  442.     <enabled/>    
  443.     <!--該元素指定更新發生的頻率。Maven會比較本地POM和遠端POM的時間戳。這裡的選項是:always(一直),daily(預設,每日),interval:X(這裡X是以分鐘為單位的時間間隔),或者never(從不)。-->    
  444.     <updatePolicy/>    
  445.     <!--當Maven驗證構件校驗檔案失敗時該怎麼做:ignore(忽略),fail(失敗),或者warn(警告)。-->    
  446.     <checksumPolicy/>    
  447.    </releases>    
  448.    <!-- 如何處理遠端倉庫裡快照版本的下載。有了releases和snapshots這兩組配置,POM就可以在每個單獨的倉庫中,為每種型別的構件採取不同的 策略。例如,可能有人會決定只為開發目的開啟對快照版本下載的支援。參見repositories/repository/releases元素 -->    
  449.    <snapshots>    
  450.     <enabled/><updatePolicy/><checksumPolicy/>    
  451.    </snapshots>    
  452.    <!--遠端倉庫唯一識別符號。可以用來匹配在settings.xml檔案裡配置的遠端倉庫-->    
  453.    <id>banseon-repository-proxy</id>     
  454.    <!--遠端倉庫名稱-->    
  455.             <name>banseon-repository-proxy</name>     
  456.             <!--遠端倉庫URL,按protocol://hostname/path形式-->    
  457.             <url>http://192.168.1.169:9999/repository/</url>     
  458.             <!-- 用於定位和排序構件的倉庫佈局型別-可以是default(預設)或者legacy(遺留)。Maven 2為其倉庫提供了一個預設的佈局;然 而,Maven 1.x有一種不同的佈局。我們可以使用該元素指定佈局是default(預設)還是legacy(遺留)。-->    
  459.             <layout>default</layout>               
  460.         </repository>     
  461.     </repositories>    
  462.     <!--發現外掛的遠端倉庫列表,這些外掛用於構建和報表-->    
  463.     <pluginRepositories>    
  464.      <!--包含需要連線到遠端外掛倉庫的資訊.參見repositories/repository元素-->    
  465.   <pluginRepository>    
  466.    ......    
  467.   </pluginRepository>    
  468.  </pluginRepositories>    
  469.        
  470.     <!--該元素描述了專案相關的所有依賴。 這些依賴組成了專案構建過程中的一個個環節。它們自動從專案定義的倉庫中下載。要獲取更多資訊,請看專案依賴機制。-->     
  471.     <dependencies>     
  472.         <dependency>    
  473.    <!--依賴的group ID-->    
  474.             <groupId>org.apache.maven</groupId>     
  475.             <!--依賴的artifact ID-->    
  476.             <artifactId>maven-artifact</artifactId>     
  477.             <!--依賴的版本號。 在Maven 2裡, 也可以配置成版本號的範圍。-->    
  478.             <version>3.8.1</version>     
  479.             <!-- 依賴型別,預設型別是jar。它通常表示依賴的檔案的副檔名,但也有例外。一個型別可以被對映成另外一個副檔名或分類器。型別經常和使用的打包方式對應, 儘管這也有例外。一些型別的例子:jar,war,ejb-client和test-jar。如果設定extensions為 true,就可以在 plugin裡定義新的型別。所以前面的型別的例子不完整。-->    
  480.             <type>jar</type>    
  481.             <!-- 依賴的分類器。分類器可以區分屬於同一個POM,但不同構建方式的構件。分類器名被附加到檔名的版本號後面。例如,如果你想要構建兩個單獨的構件成 JAR,一個使用Java 1.4編譯器,另一個使用Java 6編譯器,你就可以使用分類器來生成兩個單獨的JAR構件。-->    
  482.             <classifier></classifier>    
  483.             <!--依賴範圍。在專案釋出過程中,幫助決定哪些構件被包括進來。欲知詳情請參考依賴機制。    
  484.                 - compile :預設範圍,用於編譯      
  485.                 - provided:類似於編譯,但支援你期待jdk或者容器提供,類似於classpath      
  486.                 - runtime: 在執行時需要使用      
  487.   &nbs