pom.xml檔案詳解
阿新 • • 發佈:2019-02-08
<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/maven-v4_0_0.xsd ">
<!-- 父專案的座標。如果專案中沒有規定某個元素的值,那麼父專案中的對應值即為專案的預設值。
座標包括group ID,artifact ID和 version。 -->
<parent >
<!-- 被繼承的父專案的構件識別符號 -->
<artifactId>xxx</artifactId>
<!-- 被繼承的父專案的全球唯一識別符號 -->
<groupId>xxx</groupId>
<!-- 被繼承的父專案的版本 -->
<version>xxx</version>
<!-- 父專案的pom.xml檔案的相對路徑。相對路徑允許你選擇一個不同的路徑。預設值是../pom.xml。
Maven首先在構建當前專案的地方尋找父專案的pom,其次在檔案系統的這個位置(relativePath位置),
然後在本地倉庫,最後在遠端倉庫尋找父專案的pom。 -->
<relativePath>xxx</relativePath>
</parent>
<!-- 宣告專案描述符遵循哪一個POM模型版本。模型本身的版本很少改變,雖然如此,但它仍然是必不可少的,
這是為了當Maven引入了新的特性或者其他模型變更的時候,確保穩定性。 -->
<modelVersion> 4.0.0 </modelVersion>
<!-- 專案的全球唯一識別符號,通常使用全限定的包名區分該專案和其他專案。並且構建時生成的路徑也是由此生成,
如com.mycompany.app生成的相對路徑為:/com/mycompany/app -->
<groupId>xxx</groupId>
<!-- 構件的識別符號,它和group ID一起唯一標識一個構件。換句話說,你不能有兩個不同的專案擁有同樣的artifact ID
和groupID;在某個特定的group ID下,artifact ID也必須是唯一的。構件是專案產生的或使用的一個東西,Maven
為專案產生的構件包括:JARs,原始碼,二進位制釋出和WARs等。 -->
<artifactId>xxx</artifactId>
<!-- 專案產生的構件型別,例如jar、war、ear、pom。外掛可以建立他們自己的構件型別,所以前面列的不是全部構件型別 -->
<packaging> jar </packaging>
<!-- 專案當前版本,格式為:主版本.次版本.增量版本-限定版本號 -->
<version> 1.0-SNAPSHOT </version>
<!-- 專案的名稱, Maven產生的文件用 -->
<name> xxx-maven </name>
<!-- 專案主頁的URL, Maven產生的文件用 -->
<url> http://maven.apache.org </url>
<!-- 專案的詳細描述, Maven 產生的文件用。 當這個元素能夠用HTML格式描述時(例如,CDATA中的文字會被解析器忽略,
就可以包含HTML標籤), 不鼓勵使用純文字描述。如果你需要修改產生的web站點的索引頁面,你應該修改你自己的
索引頁檔案,而不是調整這裡的文件。 -->
<description> A maven project to study maven. </description>
<!-- 描述了這個專案構建環境中的前提條件。 -->
<prerequisites>
<!-- 構建該專案或使用該外掛所需要的Maven的最低版本 -->
<maven></maven>
</prerequisites>
<!-- 專案的問題管理系統(Bugzilla, Jira, Scarab,或任何你喜歡的問題管理系統)的名稱和URL,本例為 jira -->
<issueManagement>
<!-- 問題管理系統(例如jira)的名字, -->
<system> jira </system>
<!-- 該專案使用的問題管理系統的URL -->
<url> http://jira.baidu.com/banseon </url>
</issueManagement>
<!-- 專案持續整合資訊 -->
<ciManagement>
<!-- 持續整合系統的名字,例如continuum -->
<system></system>
<!-- 該專案使用的持續整合系統的URL(如果持續整合系統有web介面的話)。 -->
<url></url>
<!-- 構建完成時,需要通知的開發者/使用者的配置項。包括被通知者資訊和通知條件(錯誤,失敗,成功,警告) -->
<notifiers>
<!-- 配置一種方式,當構建中斷時,以該方式通知使用者/開發者 -->
<notifier>
<!-- 傳送通知的途徑 -->
<type></type>
<!-- 發生錯誤時是否通知 -->
<sendOnError></sendOnError>
<!-- 構建失敗時是否通知 -->
<sendOnFailure></sendOnFailure>
<!-- 構建成功時是否通知 -->
<sendOnSuccess></sendOnSuccess>
<!-- 發生警告時是否通知 -->
<sendOnWarning></sendOnWarning>
<!-- 不贊成使用。通知傳送到哪裡 -->
<address></address>
<!-- 擴充套件配置項 -->
<configuration></configuration>
</notifier>
</notifiers>
</ciManagement>
<!-- 專案建立年份,4位數字。當產生版權資訊時需要使用這個值。 -->
<inceptionYear />
<!-- 專案相關郵件列表資訊 -->
<mailingLists>
<!-- 該元素描述了專案相關的所有郵件列表。自動產生的網站引用這些資訊。 -->
<mailingList>
<!-- 郵件的名稱 -->
<name> Demo </name>
<!-- 傳送郵件的地址或連結,如果是郵件地址,建立文件時,mailto: 連結會被自動建立 -->
<post> [email protected] </post>
<!-- 訂閱郵件的地址或連結,如果是郵件地址,建立文件時,mailto: 連結會被自動建立 -->
<subscribe> [email protected] </subscribe>
<!-- 取消訂閱郵件的地址或連結,如果是郵件地址,建立文件時,mailto: 連結會被自動建立 -->
<unsubscribe> [email protected] </unsubscribe>
<!-- 你可以瀏覽郵件資訊的URL -->
<archive> http:/hi.baidu.com/banseon/demo/dev/ </archive>
</mailingList>
</mailingLists>
<!-- 專案開發者列表 -->
<developers>
<!-- 某個專案開發者的資訊 -->
<developer>
<!-- SCM裡專案開發者的唯一識別符號 -->
<id> HELLO WORLD </id>
<!-- 專案開發者的全名 -->
<name> banseon </name>
<!-- 專案開發者的email -->
<email> [email protected] </email>
<!-- 專案開發者的主頁的URL -->
<url></url>
<!-- 專案開發者在專案中扮演的角色,角色元素描述了各種角色 -->
<roles>
<role> Project Manager </role>
<role> Architect </role>
</roles>
<!-- 專案開發者所屬組織 -->
<organization> demo </organization>
<!-- 專案開發者所屬組織的URL -->
<organizationUrl> http://hi.baidu.com/xxx </organizationUrl>
<!-- 專案開發者屬性,如即時訊息如何處理等 -->
<properties>
<dept> No </dept>
</properties>
<!-- 專案開發者所在時區, -11到12範圍內的整數。 -->
<timezone> -5 </timezone>
</developer>
</developers>
<!-- 專案的其他貢獻者列表 -->
<contributors>
<!-- 專案的其他貢獻者。參見developers/developer元素 -->
<contributor>
<!-- 專案貢獻者的全名 -->
<name></name>
<!-- 專案貢獻者的email -->
<email></email>
<!-- 專案貢獻者的主頁的URL -->
<url></url>
<!-- 專案貢獻者所屬組織 -->
<organization></organization>
<!-- 專案貢獻者所屬組織的URL -->
<organizationUrl></organizationUrl>
<!-- 專案貢獻者在專案中扮演的角色,角色元素描述了各種角色 -->
<roles>
<role> Project Manager </role>
<role> Architect </role>
</roles>
<!-- 專案貢獻者所在時區, -11到12範圍內的整數。 -->
<timezone></timezone>
<!-- 專案貢獻者屬性,如即時訊息如何處理等 -->
<properties>
<dept> No </dept>
</properties>
</contributor>
</contributors>
<!-- 該元素描述了專案所有License列表。 應該只列出該專案的license列表,不要列出依賴專案的 license列表。
如果列出多個license,使用者可以選擇它們中的一個而不是接受所有license。 -->
<licenses>
<!-- 描述了專案的license,用於生成專案的web站點的license頁面,其他一些報表和validation也會用到該元素。 -->
<license>
<!-- license用於法律上的名稱 -->
<name> Apache 2 </name>
<!-- 官方的license正文頁面的URL -->
<url> http://www.baidu.com/banseon/LICENSE-2.0.txt </url>
<!-- 專案分發的主要方式:
repo,可以從Maven庫下載
manual, 使用者必須手動下載和安裝依賴 -->
<distribution> repo </distribution>
<!-- 關於license的補充資訊 -->
<comments> A business-friendly OSS license </comments>
</license>
</licenses>
<!-- SCM(Source Control Management)標籤允許你配置你的程式碼庫,供Maven web站點和其它外掛使用。 -->
<scm>
<!-- SCM的URL,該URL描述了版本庫和如何連線到版本庫。欲知詳情,請看SCMs提供的URL格式和列表。該連線只讀。 -->
<connection>
scm:svn:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk)
</connection>
<!-- 給開發者使用的,類似connection元素。即該連線不僅僅只讀 -->
<developerConnection>
scm:svn:http://svn.baidu.com/banseon/maven/banseon/dao-trunk
</developerConnection>
<!-- 當前程式碼的標籤,在開發階段預設為HEAD -->
<tag></tag>
<!-- 指向專案的可瀏覽SCM庫(例如ViewVC或者Fisheye)的URL。 -->
<url> http://svn.baidu.com/banseon </url>
</scm>
<!-- 描述專案所屬組織的各種屬性。Maven產生的文件用 -->
<organization>
<!-- 組織的全名 -->
<name> demo </name>
<!-- 組織主頁的URL -->
<url> http://www.baidu.com/banseon </url>
</organization>
<!-- 構建專案需要的資訊 -->
<build>
<!-- 該元素設定了專案原始碼目錄,當構建專案的時候,構建系統會編譯目錄裡的原始碼。該路徑是相對
於pom.xml的相對路徑。 -->
<sourceDirectory></sourceDirectory>
<!-- 該元素設定了專案指令碼原始碼目錄,該目錄和原始碼目錄不同:絕大多數情況下,該目錄下的內容會
被拷貝到輸出目錄(因為指令碼是被解釋的,而不是被編譯的)。 -->
<scriptSourceDirectory></scriptSourceDirectory>
<!-- 該元素設定了專案單元測試使用的原始碼目錄,當測試專案的時候,構建系統會編譯目錄裡的原始碼。
該路徑是相對於pom.xml的相對路徑。 -->
<testSourceDirectory></testSourceDirectory>
<!-- 被編譯過的應用程式class檔案存放的目錄。 -->
<outputDirectory></outputDirectory>
<!-- 被編譯過的測試class檔案存放的目錄。 -->
<testOutputDirectory></testOutputDirectory>
<!-- 使用來自該專案的一系列構建擴充套件 -->
<extensions>
<!-- 描述使用到的構建擴充套件。 -->
<extension>
<!-- 構建擴充套件的groupId -->
<groupId></groupId>
<!-- 構建擴充套件的artifactId -->
<artifactId></artifactId>
<!-- 構建擴充套件的版本 -->
<version></version>
</extension>
</extensions>
<!-- 當專案沒有規定目標(Maven2 叫做階段)時的預設值 -->
<defaultGoal></defaultGoal>
<!-- 這個元素描述了專案相關的所有資源路徑列表,例如和專案相關的屬性檔案,這些資源被包含在
最終的打包檔案裡。 -->
<resources>
<!-- 這個元素描述了專案相關或測試相關的所有資源路徑 -->
<resource>
<!-- 描述了資源的目標路徑。該路徑相對target/classes目錄(例如${project.build.outputDirectory})。
舉個例子,如果你想資源在特定的包裡(org.apache.maven.messages),你就必須該元素設定為
org/apache/maven/messages。然而,如果你只是想把資源放到原始碼目錄結構裡,就不需要該配置。 -->
<targetPath></targetPath>
<!-- 是否使用引數值代替引數名。引數值取自properties元素或者檔案裡配置的屬性,檔案在filters元素
裡列出。 -->
<filtering></filtering>
<!-- 描述存放資源的目錄,該路徑相對POM路徑 -->
<directory></directory>
<!-- 包含的模式列表,例如**/*.xml. -->
<includes>
<include></include>
</includes>
<!-- 排除的模式列表,例如**/*.xml -->
<excludes>
<exclude></exclude>
</excludes>
</resource>
</resources>
<!-- 這個元素描述了單元測試相關的所有資源路徑,例如和單元測試相關的屬性檔案。 -->
<testResources>
<!-- 這個元素描述了測試相關的所有資源路徑,參見build/resources/resource元素的說明 -->
<testResource>
<!-- 描述了測試相關的資源的目標路徑。該路徑相對target/classes目錄(例如${project.build.outputDirectory})。
舉個例子,如果你想資源在特定的包裡(org.apache.maven.messages),你就必須該元素設定為
org/apache/maven/messages。然而,如果你只是想把資源放到原始碼目錄結構裡,就不需要該配置。 -->
<targetPath></targetPath>
<!-- 是否使用引數值代替引數名。引數值取自properties元素或者檔案裡配置的屬性,檔案在filters元素
裡列出。 -->
<filtering></filtering>
<!-- 描述存放測試相關的資源的目錄,該路徑相對POM路徑 -->
<directory></directory>
<!-- 包含的模式列表,例如**/*.xml. -->
<includes>
<include></include>
</includes>
<!-- 排除的模式列表,例如**/*.xml -->
<excludes>
<exclude></exclude>
</excludes>
</testResource>
</testResources>
<!-- 構建產生的所有檔案存放的目錄 -->
<directory></directory>
<!-- 產生的構件的檔名,預設值是${artifactId}-${version}。 -->
<finalName></finalName>
<!-- 當filtering開關開啟時,使用到的過濾器屬性檔案列表 -->
<filters></filters>
<!-- 子專案可以引用的預設外掛資訊。該外掛配置項直到被引用時才會被解析或繫結到生命週期。給定外掛的任何本
地配置都會覆蓋這裡的配置 -->
<pluginManagement>
<!-- 使用的外掛列表 。 -->
<plugins>
<!-- plugin元素包含描述外掛所需要的資訊。 -->
<plugin>
<!-- 外掛在倉庫裡的group ID -->
<groupId></groupId>
<!-- 外掛在倉庫裡的artifact ID -->
<artifactId></artifactId>
<!-- 被使用的外掛的版本(或版本範圍) -->
<version></version>
<!-- 是否從該外掛下載Maven擴充套件(例如打包和型別處理器),由於效能原因,只有在真需要下載時,該
元素才被設定成enabled。 -->
<extensions>true/false</extensions>
<!-- 在構建生命週期中執行一組目標的配置。每個目標可能有不同的配置。 -->
<executions>
<!-- execution元素包含了外掛執行需要的資訊 -->
<execution>
<!-- 執行目標的識別符號,用於標識構建過程中的目標,或者匹配繼承過程中需要合併的執行目標 -->
<id></id>
<!-- 綁定了目標的構建生命週期階段,如果省略,目標會被繫結到源資料裡配置的預設階段 -->
<phase></phase>
<!-- 配置的執行目標 -->
<goals></goals>
<!-- 配置是否被傳播到子POM -->
<inherited>true/false</inherited>
<!-- 作為DOM物件的配置 -->
<configuration></configuration>
</execution>
</executions>
<!-- 專案引入外掛所需要的額外依賴 -->
<dependencies>
<!-- 參見dependencies/dependency元素 -->
<dependency>
</dependency>
</dependencies>
<!-- 任何配置是否被傳播到子專案 -->
<inherited>true/false</inherited>
<!-- 作為DOM物件的配置 -->
<configuration></configuration>
</plugin>
</plugins>
</pluginManagement>
<!-- 該專案使用的外掛列表 。 -->
<plugins>
<!-- plugin元素包含描述外掛所需要的資訊。 -->
<plugin>
<!-- 外掛在倉庫裡的group ID -->
<groupId></groupId>
<!-- 外掛在倉庫裡的artifact ID -->
<artifactId></artifactId>
<!-- 被使用的外掛的版本(或版本範圍) -->
<version></version>
<!-- 是否從該外掛下載Maven擴充套件(例如打包和型別處理器),由於效能原因,只有在真需要下載時,該
元素才被設定成enabled。 -->
<extensions>true/false</extensions>
<!-- 在構建生命週期中執行一組目標的配置。每個目標可能有不同的配置。 -->
<executions>
<!-- execution元素包含了外掛執行需要的資訊 -->
<execution>
<!-- 執行目標的識別符號,用於標識構建過程中的目標,或者匹配繼承過程中需要合併的執行目標 -->
<id></id>
<!-- 綁定了目標的構建生命週期階段,如果省略,目標會被繫結到源資料裡配置的預設階段 -->
<phase></phase>
<!-- 配置的執行目標 -->
<goals></goals>
<!-- 配置是否被傳播到子POM -->
<inherited>true/false</inherited>
<!-- 作為DOM物件的配置 -->
<configuration></configuration>
</execution>
</executions>
<!-- 專案引入外掛所需要的額外依賴 -->
<dependencies>
<!-- 參見dependencies/dependency元素 -->
<dependency>
</dependency>
</dependencies>
<!-- 任何配置是否被傳播到子專案 -->
<inherited>true/false</inherited>
<!-- 作為DOM物件的配置 -->
<configuration></configuration>
</plugin>
</plugins>
</build>
<!-- 在列的專案構建profile,如果被啟用,會修改構建處理 -->
<profiles>
<!-- 根據環境引數或命令列引數啟用某個構建處理 -->
<profile>
<!-- 構建配置的唯一識別符號。即用於命令列啟用,也用於在繼承時合併具有相同識別符號的profile。 -->
<id></id>
<!-- 自動觸發profile的條件邏輯。Activation是profile的開啟鑰匙。profile的力量來自於它能夠
在某些特定的環境中自動使用某些特定的值;這些環境通過activation元素指定。activation元
素並不是啟用profile的唯一方式。 -->
<activation>
<!-- profile預設是否啟用的標誌 -->
<activeByDefault>true/false</activeByDefault>
<!-- 當匹配的jdk被檢測到,profile被啟用。例如,1.4啟用JDK1.4,1.4.0_2,而!1.4啟用所有版本
不是以1.4開頭的JDK。 -->
<jdk>jdk版本,如:1.7</jdk>
<!-- 當匹配的作業系統屬性被檢測到,profile被啟用。os元素可以定義一些作業系統相關的屬性。 -->
<os>
<!-- 啟用profile的作業系統的名字 -->
<name> Windows XP </name>
<!-- 啟用profile的作業系統所屬家族(如 'windows') -->
<family> Windows </family>
<!-- 啟用profile的作業系統體系結構 -->
<arch> x86 </arch>
<!-- 啟用profile的作業系統版本 -->
<version> 5.1.2600 </version>
</os>
<!-- 如果Maven檢測到某一個屬性(其值可以在POM中通過${名稱}引用),其擁有對應的名稱和值,Profile
就會被啟用。如果值欄位是空的,那麼存在屬性名稱欄位就會啟用profile,否則按區分大小寫方式匹
配屬性值欄位 -->
<property>
<!-- 啟用profile的屬性的名稱 -->
<name> mavenVersion </name>
<!-- 啟用profile的屬性的值 -->
<value> 2.0.3 </value>
</property>
<!-- 提供一個檔名,通過檢測該檔案的存在或不存在來啟用profile。missing檢查檔案是否存在,如果不存在則啟用
profile。另一方面,exists則會檢查檔案是否存在,如果存在則啟用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>
<!-- 構建專案所需要的資訊。參見build元素 -->
<build>
<defaultGoal />
<resources>
<resource>
<targetPath></targetPath>
<filtering></filtering>
<directory></directory>
<includes>
<include></include>
</includes>
<excludes>
<exclude></exclude>
</excludes>
</resource>
</resources>
<testResources>
<testResource>
<targetPath></targetPath>
<filtering></filtering>
<directory></directory>
<includes>
<include></include>
</includes>
<excludes>
<exclude></exclude>
</excludes>
</testResource>
</testResources>
<directory></directory>
<finalName></finalName>
<filters></filters>
<pluginManagement>
<plugins>
<!-- 參見build/pluginManagement/plugins/plugin元素 -->
<plugin>
<groupId></groupId>
<artifactId></artifactId>
<version></version>
<extensions>true/false</extensions>
<executions>
<execution>
<id></id>
<phase></phase>
<goals></goals>
<inherited>true/false</inherited>
<configuration></configuration>
</execution>
</executions>
<dependencies>
<!-- 參見dependencies/dependency元素 -->
<dependency>
</dependency>
</dependencies>
<goals></goals>
<inherited>true/false</inherited>
<configuration></configuration>
</plugin>
</plugins>
</pluginManagement>
<plugins>
<!-- 參見build/pluginManagement/plugins/plugin元素 -->
<plugin>
<groupId></groupId>
<artifactId></artifactId>
<version></version>
<extensions>true/false</extensions>
<executions>
<execution>
<id></id>
<phase></phase>
<goals></goals>
<inherited>true/false</inherited>
<configuration></configuration>
</execution>
</executions>
<dependencies>
<!-- 參見dependencies/dependency元素 -->
<dependency>
</dependency>
</dependencies>
<goals></goals>
<inherited>true/false</inherited>
<configuration></configuration>
</plugin>
</plugins>
</