閱讀615 返回首頁    go 阿裏雲 go 技術社區[雲棲]

maven配置詳解

什麼是pom?
    pom作為項目對象模型。通過xml表示maven項目，使用pom.xml來實現。主要描述了項目：包括配置文件；開發者需要遵循的規則，缺陷管理係統，組織和licenses，項目的url，項目的依賴性，以及其他所有的項目相關因素。


pom.xml 配置文件

  1. <project>  
  2.     <parent>  
  3.         ...  
  4.     </parent>  
  5.       
  6.     <modelVersion>4.0.0</modelVersion>  
  7.   
  8.     <!-- The Basics -->  
  9.     <groupId>...</groupId>  
  10.     <artifactId>...</artifactId>  
  11.     <version>...</version>  
  12.     <packaging>...</packaging>  
  13.       
  14.     <scm>  
  15.         ...  
  16.     </scm>  
  17.       
  18.     <dependencies>  
  19.         ...  
  20.     </dependencies>  
  21.       
  22.     <dependencyManagement>  
  23.         ...  
  24.     </dependencyManagement>  
  25.       
  26.     <modules>  
  27.         ...  
  28.     </modules>  
  29.       
  30.     <properties>  
  31.         ...  
  32.     </properties>  
  33.   
  34.     <!-- Build Settings -->  
  35.     <build>  
  36.         ...  
  37.     </build>  
  38.     <reporting>  
  39.         ...  
  40.     </reporting>  
  41.   
  42.     <!-- More Project Information -->  
  43.     <name>...</name>  
  44.     <description>...</description>  
  45.     <url>...</url>  
  46.     <inceptionYear>...</inceptionYear>  
  47.       
  48.     <licenses>  
  49.     </licenses>  
  50.       
  51.     <organization>  
  52.     </organization>  
  53.       
  54.     <developers>  
  55.     </developers>  
  56.       
  57.     <contributors>  
  58.     </contributors>  
  59.   
  60.     <!-- Environment Settings -->  
  61.     <issueManagement>  
  62.     </issueManagement>  
  63.       
  64.     <ciManagement>  
  65.     </ciManagement>  
  66.       
  67.     <mailingLists>  
  68.     </mailingLists>  
  69.       
  70.     <prerequisites>  
  71.     </prerequisites>  
  72.       
  73.     <repositories>  
  74.     </repositories>  
  75.       
  76.     <pluginRepositories>  
  77.     </pluginRepositories>  
  78.       
  79.     <distributionManagement>  
  80.     </distributionManagement>  
  81.       
  82.     <profiles>  
  83.     </profiles>  
  84. </project>  

maven POM.xml詳解

  1. <project xmlns="https://maven.apache.org/POM/4.0.0"     
  2.     xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"     
  3. xsi:schemaLocation="https://maven.apache.org/POM/4.0.0https://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>https://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>https://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>banseon@126.com</post>     
  80.             <!--訂閱郵件的地址或鏈接，如果是郵件地址，創建文檔時，mailto: 鏈接會被自動創建-->     
  81.             <subscribe>banseon@126.com</subscribe>     
  82.             <!--取消訂閱郵件的地址或鏈接，如果是郵件地址，創建文檔時，mailto: 鏈接會被自動創建-->     
  83.             <unsubscribe>banseon@126.com</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>banseon@126.com</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>https://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>https://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:https://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk)      
  145.         </connection>     
  146.         <!--給開發者使用的，類似connection元素。即該連接不僅僅隻讀-->    
  147.         <developerConnection>     
  148.             scm:svn:https://svn.baidu.com/banseon/maven/banseon/dao-trunk      
  149.         </developerConnection>    
  150.         <!--當前代碼的標簽，在開發階段默認為HEAD-->    
  151.         <tag/>           
  152.         <!--指向項目的可瀏覽SCM庫（例如ViewVC或者Fisheye）的URL。-->     
  153.         <url>https://svn.baidu.com/banseon</url>     
  154.     </scm>     
  155.     <!--描述項目所屬組織的各種屬性。Maven產生的文檔用-->     
  156.     <organization>     
  157.      <!--組織的全名-->    
  158.         <name>demo</name>     
  159.         <!--組織主頁的URL-->    
  160.         <url>https://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

    最後更新：2017-04-04 07:32:00

      上一篇：go 過濾器和攔截器異同
      下一篇：go 機房收費係統之結賬與報表