POM檔案總體配置說明
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/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>
</build>
<!-- 模塊(有時稱作子專案) 被構建成專案的一部分,列出的每個模塊元素是指向該模塊的目錄的
相對路徑 -->
<modules>
<!--子專案相對路徑-->
<module></module>
</modules>
<!-- 發現依賴和擴展的遠程倉庫串列, -->
<repositories>
<!-- 參見repositories/repository元素 -->
<repository>
<releases>
<enabled><enabled>
<updatePolicy></updatePolicy>
<checksumPolicy></checksumPolicy>
</releases>
<snapshots>
<enabled><enabled>
<updatePolicy></updatePolicy>
<checksumPolicy></checksumPolicy>
</snapshots>
<id></id>
<name></name>
<url></url>
<layout></layout>
</repository>
</repositories>
<!-- 發現插件的遠程倉庫串列,這些插件用于構建和報表 -->
<pluginRepositories>
<!-- 包含需要連接到遠程插件倉庫的資訊.參見repositories/repository元素 -->
<pluginRepository>
<releases>
<enabled><enabled>
<updatePolicy></updatePolicy>
<checksumPolicy></checksumPolicy>
</releases>
<snapshots>
<enabled><enabled>
<updatePolicy></updatePolicy>
<checksumPolicy></checksumPolicy>
</snapshots>
<id></id>
<name></name>
<url></url>
<layout></layout>
</pluginRepository>
</pluginRepositories>
<!-- 該元素描述了專案相關的所有依賴, 這些依賴組成了專案構建程序中的一個個環節,它們自動從專案定義的
倉庫中下載,要獲取更多資訊,請看專案依賴機制, -->
<dependencies>
<!-- 參見dependencies/dependency元素 -->
<dependency>
</dependency>
</dependencies>
<!-- 不贊成使用. 現在Maven忽略該元素. -->
<reports></reports>
<!-- 該元素包括使用報表插件產生報表的規范,當用戶執行“mvn site”,這些報表就會運行, 在頁面導航欄能看
到所有報表的鏈接,參見reporting元素 -->
<reporting></reporting>
<!-- 參見dependencyManagement元素 -->
<dependencyManagement>
<dependencies>
<!-- 參見dependencies/dependency元素 -->
<dependency>
</dependency>
</dependencies>
</dependencyManagement>
<!-- 參見distributionManagement元素 -->
<distributionManagement>
</distributionManagement>
<!-- 參見properties元素 -->
<properties />
</profile>
</profiles>
<!-- 模塊(有時稱作子專案) 被構建成專案的一部分,列出的每個模塊元素是指向該模塊的目錄的相對路徑 -->
<modules>
<!--子專案相對路徑-->
<module></module>
</modules>
<!-- 發現依賴和擴展的遠程倉庫串列, -->
<repositories>
<!-- 包含需要連接到遠程倉庫的資訊 -->
<repository>
<!-- 如何處理遠程倉庫里發布版本的下載 -->
<releases>
<!-- true或者false表示該倉庫是否為下載某種型別構件(發布版,快照版)開啟, -->
<enabled><enabled>
<!-- 該元素指定更新發生的頻率,Maven會比較本地POM和遠程POM的時間戳,這里的選項是:always(一直),
daily(默認,每日),interval:X(這里X是以分鐘為單位的時間間隔),或者never(從不), -->
<updatePolicy></updatePolicy>
<!-- 當Maven驗證構件校驗檔案失敗時該怎么做:ignore(忽略),fail(失敗),或者warn(警告), -->
<checksumPolicy></checksumPolicy>
</releases>
<!-- 如何處理遠程倉庫里快照版本的下載,有了releases和snapshots這兩組配置,POM就可以在每個單獨的倉庫中,
為每種型別的構件采取不同的策略,例如,可能有人會決定只為開發目的開啟對快照版本下載的支持,參見repositories/repository/releases元素 -->
<snapshots>
<enabled><enabled>
<updatePolicy></updatePolicy>
<checksumPolicy></checksumPolicy>
</snapshots>
<!-- 遠程倉庫唯一識別符號,可以用來匹配在settings.xml檔案里配置的遠程倉庫 -->
<id> banseon-repository-proxy </id>
<!-- 遠程倉庫名稱 -->
<name> banseon-repository-proxy </name>
<!-- 遠程倉庫URL,按protocol://hostname/path形式 -->
<url> http://192.168.1.169:9999/repository/ </url>
<!-- 用于定位和排序構件的倉庫布局型別-可以是default(默認)或者legacy(遺留),Maven 2為其倉庫提供了一個默認
的布局;然而,Maven 1.x有一種不同的布局,我們可以使用該元素指定布局是default(默認)還是legacy(遺留), -->
<layout> default </layout>
</repository>
</repositories>
<!-- 發現插件的遠程倉庫串列,這些插件用于構建和報表 -->
<pluginRepositories>
<!-- 包含需要連接到遠程插件倉庫的資訊.參見repositories/repository元素 -->
<pluginRepository>
</pluginRepository>
</pluginRepositories>
<!-- 該元素描述了專案相關的所有依賴, 這些依賴組成了專案構建程序中的一個個環節,它們自動從專案定義的倉庫中下載,
要獲取更多資訊,請看專案依賴機制, -->
<dependencies>
<dependency>
<!-- 依賴的group ID -->
<groupId> org.apache.maven </groupId>
<!-- 依賴的artifact ID -->
<artifactId> maven-artifact </artifactId>
<!-- 依賴的版本號, 在Maven 2里, 也可以配置成版本號的范圍, -->
<version> 3.8.1 </version>
<!-- 依賴型別,默認型別是jar,它通常表示依賴的檔案的擴展名,但也有例外,一個型別可以被映射成另外一個擴展
名或分類器,型別經常和使用的打包方式對應,盡管這也有例外,一些型別的例子:jar,war,ejb-client和test-jar,
如果設定extensions為 true,就可以在plugin里定義新的型別,所以前面的型別的例子不完整, -->
<type> jar </type>
<!-- 依賴的分類器,分類器可以區分屬于同一個POM,但不同構建方式的構件,分類器名被附加到檔案名的版本號后面,例如,
如果你想要構建兩個單獨的構件成JAR,一個使用Java 1.4編譯器,另一個使用Java 6編譯器,你就可以使用分類器來生
成兩個單獨的JAR構件, -->
<classifier></classifier>
<!-- 依賴范圍,在專案發布程序中,幫助決定哪些構件被包括進來,欲知詳情請參考依賴機制,
- compile :默認范圍,用于編譯
- provided:類似于編譯,但支持你期待jdk或者容器提供,類似于classpath
- runtime: 在執行時需要使用
- test: 用于test任務時使用
- system: 需要外在提供相應的元素,通過systemPath來取得
- systemPath: 僅用于范圍為system,提供相應的路徑
- optional: 當專案自身被依賴時,標注依賴是否傳遞,用于連續依賴時使用 -->
<scope> test </scope>
<!-- 僅供system范圍使用,注意,不鼓勵使用這個元素,并且在新的版本中該元素可能被覆寫掉,該元素為依賴規定了檔案
系統上的路徑,需要絕對路徑而不是相對路徑,推薦使用屬性匹配絕對路徑,例如${java.home}, -->
<systemPath></systemPath>
<!-- 當計算傳遞依賴時, 從依賴構件串列里,列出被排除的依賴構件集,即告訴maven你只依賴指定的專案,不依賴專案的
依賴,此元素主要用于解決版本沖突問題 -->
<exclusions>
<exclusion>
<artifactId> spring-core </artifactId>
<groupId> org.springframework </groupId>
</exclusion>
</exclusions>
<!-- 可選依賴,如果你在專案B中把C依賴宣告為可選,你就需要在依賴于B的專案(例如專案A)中顯式的參考對C的依賴,
可選依賴阻斷依賴的傳遞性, -->
<optional> true </optional>
</dependency>
</dependencies>
<!-- 不贊成使用. 現在Maven忽略該元素. -->
<reports></reports>
<!-- 該元素描述使用報表插件產生報表的規范,當用戶執行“mvn site”,這些報表就會運行, 在頁面導航欄能看到所有報表的鏈接, -->
<reporting>
<!-- true,則,網站不包括默認的報表,這包括“專案資訊”選單中的報表, -->
<excludeDefaults />
<!-- 所有產生的報表存放到哪里,默認值是${project.build.directory}/site, -->
<outputDirectory />
<!-- 使用的報表插件和他們的配置, -->
<plugins>
<!-- plugin元素包含描述報表插件需要的資訊 -->
<plugin>
<!-- 報表插件在倉庫里的group ID -->
<groupId></groupId>
<!-- 報表插件在倉庫里的artifact ID -->
<artifactId></artifactId>
<!-- 被使用的報表插件的版本(或版本范圍) -->
<version></version>
<!-- 任何配置是否被傳播到子專案 -->
<inherited>true/false</inherited>
<!-- 報表插件的配置 -->
<configuration></configuration>
<!-- 一組報表的多重規范,每個規范可能有不同的配置,一個規范(報表集)對應一個執行目標 ,例如,
有1,2,3,4,5,6,7,8,9個報表,1,2,5構成A報表集,對應一個執行目標,2,5,8構成B報
表集,對應另一個執行目標 -->
<reportSets>
<!-- 表示報表的一個集合,以及產生該集合的配置 -->
<reportSet>
<!-- 報表集合的唯一識別符號,POM繼承時用到 -->
<id></id>
<!-- 產生報表集合時,被使用的報表的配置 -->
<configuration></configuration>
<!-- 配置是否被繼承到子POMs -->
<inherited>true/false</inherited>
<!-- 這個集合里使用到哪些報表 -->
<reports></reports>
</reportSet>
</reportSets>
</plugin>
</plugins>
</reporting>
<!-- 繼承自該專案的所有子專案的默認依賴資訊,這部分的依賴資訊不會被立即決議,而是當子專案宣告一個依賴
(必須描述group ID和artifact ID資訊),如果group ID和artifact ID以外的一些資訊沒有描述,則通過
group ID和artifact ID匹配到這里的依賴,并使用這里的依賴資訊, -->
<dependencyManagement>
<dependencies>
<!-- 參見dependencies/dependency元素 -->
<dependency>
</dependency>
</dependencies>
</dependencyManagement>
<!-- 專案分發資訊,在執行mvn deploy后表示要發布的位置,有了這些資訊就可以把網站部署到遠程服務器或者
把構件部署到遠程倉庫, -->
<distributionManagement>
<!-- 部署專案產生的構件到遠程倉庫需要的資訊 -->
<repository>
<!-- 是分配給快照一個唯一的版本號(由時間戳和構建流水號)?還是每次都使用相同的版本號?參見
repositories/repository元素 -->
<uniqueVersion />
<id> banseon-maven2 </id>
<name> banseon maven2 </name>
<url> file://${basedir}/target/deploy </url>
<layout></layout>
</repository>
<!-- 構件的快照部署到哪里?如果沒有配置該元素,默認部署到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></layout>
</snapshotRepository>
<!-- 部署專案的網站需要的資訊 -->
<site>
<!-- 部署位置的唯一識別符號,用來匹配站點和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>
<!-- 專案下載頁面的URL,如果沒有該元素,用戶應該參考主頁,使用該元素的原因是:幫助定位
那些不在倉庫里的構件(由于license限制), -->
<downloadUrl />
<!-- 如果構件有了新的group ID和artifact ID(構件移到了新的位置),這里列出構件的重定位資訊, -->
<relocation>
<!-- 構件新的group ID -->
<groupId></groupId>
<!-- 構件新的artifact ID -->
<artifactId></artifactId>
<!-- 構件新的版本號 -->
<version></version>
<!-- 顯示給用戶的,關于移動的額外資訊,例如原因, -->
<message></message>
</relocation>
<!-- 給出該構件在遠程倉庫的狀態,不得在本地專案中設定該元素,因為這是工具自動更新的,有效的值
有:none(默認),converted(倉庫管理員從Maven 1 POM轉換過來),partner(直接從伙伴Maven
2倉庫同步過來),deployed(從Maven 2實體部署),verified(被核實時正確的和最終的), -->
<status></status>
</distributionManagement>
<!-- 以值替代名稱,Properties可以在整個POM中使用,也可以作為觸發條件(見settings.xml組態檔里
activation元素的說明),格式是<name>value</name>, -->
<properties>
<name>value</name>
</properties>
</project>
POM檔案單項配置說明
localRepository
<!-- 本地倉庫的路徑,默認值為${user.home}/.m2/repository, -->
<localRepository>usr/local/maven</localRepository>
interactiveMode
<!--Maven是否需要和用戶互動以獲得輸入,如果Maven需要和用戶互動以獲得輸入,則設定成true,反之則應為false,默認為true,-->
<interactiveMode>true</interactiveMode>
usePluginRegistry
<!--Maven是否需要使用plugin-registry.xml檔案來管理插件版本,如果需要讓Maven使用檔案${user.home}/.m2/plugin-registry.xml來管理插件版本,則設為true,默認為false,-->
<usePluginRegistry>false</usePluginRegistry>
offline
<!--表示Maven是否需要在離線模式下運行,如果構建系統需要在離線模式下運行,則為true,默認為false,當由于網路設定原因或者安全因素,構建服務器不能連接遠程倉庫的時候,該配置就十分有用, -->
<offline>false</offline>
pluginGroups
<!--當插件的組織Id(groupId)沒有顯式提供時,供搜尋插件組織Id(groupId)的串列,該元素包含一個pluginGroup元素串列,每個子元素包含了一個組織Id(groupId),當我們使用某個插件,并且沒有在命令列為其提供組織Id(groupId)的時候,Maven就會使用該串列,默認情況下該串列包含了org.apache.maven.plugins和org.codehaus.mojo -->
<pluginGroups>
<!--plugin的組織Id(groupId) -->
<pluginGroup>org.codehaus.mojo</pluginGroup>
</pluginGroups>
proxies
<!--用來配置不同的代理,多代理profiles 可以應對筆記本或移動設備的作業環境:通過簡單的設定profile id就可以很容易的更換整個代理配置, -->
<proxies>
<!--代理元素包含配置代理時需要的資訊-->
<proxy>
<!--代理的唯一定義符,用來區分不同的代理元素,-->
<id>myproxy</id>
<!--該代理是否是激活的那個,true則激活代理,當我們宣告了一組代理,而某個時候只需要激活一個代理的時候,該元素就可以派上用處, -->
<active>true</active>
<!--代理的協議, 協議://主機名:埠,分隔成離散的元素以方便配置,-->
<protocol>http</protocol>
<!--代理的主機名,協議://主機名:埠,分隔成離散的元素以方便配置, -->
<host>proxy.somewhere.com</host>
<!--代理的埠,協議://主機名:埠,分隔成離散的元素以方便配置, -->
<port>8080</port>
<!--代理的用戶名,用戶名和密碼表示代理服務器認證的登錄名和密碼, -->
<username>proxyuser</username>
<!--代理的密碼,用戶名和密碼表示代理服務器認證的登錄名和密碼, -->
<password>somepassword</password>
<!--不該被代理的主機名串列,該串列的分隔符由代理服務器指定;例子中使用了豎線分隔符,使用逗號分隔也很常見,-->
<nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts>
</proxy>
</proxies>
servers
<!--配置服務端的一些設定,一些設定如安全證書不應該和pom.xml一起分發,這種型別的資訊應該存在于構建服務器上的settings.xml檔案中,-->
<servers>
<!--服務器元素包含配置服務器時需要的資訊 -->
<server>
<!--這是server的id(注意不是用戶登陸的id),該id與distributionManagement中repository元素的id相匹配,-->
<id>server001</id>
<!--鑒權用戶名,鑒權用戶名和鑒權密碼表示服務器認證所需要的登錄名和密碼, -->
<username>my_login</username>
<!--鑒權密碼 ,鑒權用戶名和鑒權密碼表示服務器認證所需要的登錄名和密碼,密碼加密功能已被添加到2.1.0 +,詳情請訪問密碼加密頁面-->
<password>my_password</password>
<!--鑒權時使用的私鑰位置,和前兩個元素類似,私鑰位置和私鑰密碼指定了一個私鑰的路徑(默認是${user.home}/.ssh/id_dsa)以及如果需要的話,一個密語,將來passphrase和password元素可能會被提取到外部,但目前它們必須在settings.xml檔案以純文本的形式宣告, -->
<privateKey>${usr.home}/.ssh/id_dsa</privateKey>
<!--鑒權時使用的私鑰密碼,-->
<passphrase>some_passphrase</passphrase>
<!--檔案被創建時的權限,如果在部署的時候會創建一個倉庫檔案或者目錄,這時候就可以使用權限(permission),這兩個元素合法的值是一個三位數字,其對應了unix檔案系統的權限,如664,或者775, -->
<filePermissions>664</filePermissions>
<!--目錄被創建時的權限, -->
<directoryPermissions>775</directoryPermissions>
</server>
</servers>
mirrors
<!--為倉庫串列配置的下載鏡像串列,高級設定請參閱鏡像設定頁面 -->
<mirrors>
<!--給定倉庫的下載鏡像, -->
<mirror>
<!--該鏡像的唯一識別符號,id用來區分不同的mirror元素, -->
<id>planetmirror.com</id>
<!--鏡像名稱 -->
<name>PlanetMirror Australia</name>
<!--該鏡像的URL,構建系統會優先考慮使用該URL,而非使用默認的服務器URL, -->
<url>http://downloads.planetmirror.com/pub/maven2</url>
<!--被鏡像的服務器的id,例如,如果我們要設定了一個Maven中央倉庫(http://repo.maven.apache.org/maven2/)的鏡像,就需要將該元素設定成central,這必須和中央倉庫的id central完全一致,-->
<mirrorOf>central</mirrorOf>
</mirror>
</mirrors>
profiles
<!--根據環境引數來調整構建配置的串列,settings.xml中的profile元素是pom.xml中profile元素的裁剪版本,它包含了id,activation, repositories, pluginRepositories和 properties元素,這里的profile元素只包含這五個子元素是因為這里只關心構建系統這個整體(這正是settings.xml檔案的角色定位),而非單獨的專案物件模型設定,如果一個settings中的profile被激活,它的值會覆寫任何其它定義在POM中或者profile.xml中的帶有相同id的profile, -->
<profiles>
<!--根據環境引數來調整的構件的配置-->
<profile>
<!--該配置的唯一識別符號, -->
<id>test</id>
Activation
<!--自動觸發profile的條件邏輯,Activation是profile的開啟鑰匙,如POM中的profile一樣,profile的力量來自于它能夠在某些特定的環境中自動使用某些特定的值;這些環境通過activation元素指定,activation元素并不是激活profile的唯一方式,settings.xml檔案中的activeProfile元素可以包含profile的id,profile也可以通過在命令列,使用-P標記和逗號分隔的串列來顯式的激活(如,-P test),-->
<activation>
<!--profile默認是否激活的標識-->
<activeByDefault>false</activeByDefault>
<!--當匹配的jdk被檢測到,profile被激活,例如,1.4激活JDK1.4,1.4.0_2,而!1.4激活所有版本不是以1.4開頭的JDK,-->
<jdk>1.5</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中通過${name}參考),其擁有對應的name = 值,Profile就會被激活,如果值欄位是空的,那么存在屬性名稱欄位就會激活profile,否則按區分大小寫方式匹配屬性值欄位-->
<property>
<!--激活profile的屬性的名稱-->
<name>mavenVersion</name>
<!--激活profile的屬性的值 -->
<value>2.0.3</value>
</property>
<!--提供一個檔案名,通過檢測該檔案的存在或不存在來激活profile,missing檢查檔案是否存在,如果不存在則激活profile,另一方面,exists則會檢查檔案是否存在,如果存在則激活profile,-->
<file>
<!--如果指定的檔案存在,則激活profile, -->
<exists>${basedir}/file2.properties</exists>
<!--如果指定的檔案不存在,則激活profile,-->
<missing>${basedir}/file1.properties</missing>
</file>
</activation>
Repositories
<!--遠程倉庫串列,它是Maven用來填充構建系統本地倉庫所使用的一組遠程專案, -->
<repositories>
<!--包含需要連接到遠程倉庫的資訊 -->
<repository>
<!--遠程倉庫唯一標識-->
<id>codehausSnapshots</id>
<!--遠程倉庫名稱 -->
<name>Codehaus Snapshots</name>
<!--如何處理遠程倉庫里發布版本的下載-->
<releases>
<!--true或者false表示該倉庫是否為下載某種型別構件(發布版,快照版)開啟, -->
<enabled>false</enabled>
<!--該元素指定更新發生的頻率,Maven會比較本地POM和遠程POM的時間戳,這里的選項是:always(一直),daily(默認,每日),interval:X(這里X是以分鐘為單位的時間間隔),或者never(從不), -->
<updatePolicy>always</updatePolicy>
<!--當Maven驗證構件校驗檔案失敗時該怎么做-ignore(忽略),fail(失敗),或者warn(警告),-->
<checksumPolicy>warn</checksumPolicy>
</releases>
<!--如何處理遠程倉庫里快照版本的下載,有了releases和snapshots這兩組配置,POM就可以在每個單獨的倉庫中,為每種型別的構件采取不同的策略,例如,可能有人會決定只為開發目的開啟對快照版本下載的支持,參見repositories/repository/releases元素-->
<snapshots>
<enabled/><updatePolicy/><checksumPolicy/>
</snapshots>
<!--遠程倉庫URL,按protocol://hostname/path形式 -->
<url>http://snapshots.maven.codehaus.org/maven2</url>
<!--用于定位和排序構件的倉庫布局型別-可以是default(默認)或者legacy(遺留),Maven 2為其倉庫提供了一個默認的布局;然而,Maven 1.x有一種不同的布局,我們可以使用該元素指定布局是default(默認)還是legacy(遺留), -->
<layout>default</layout>
</repository>
</repositories>
<!--發現插件的遠程倉庫串列,倉庫是兩種主要構件的家,第一種構件被用作其它構件的依賴,這是中央倉庫中存盤的大部分構件型別,另外一種構件型別是插件,Maven插件是一種特殊型別的構件,由于這個原因,插件倉庫獨立于其它倉庫,pluginRepositories元素的結構和repositories元素的結構類似,每個pluginRepository元素指定一個Maven可以用來尋找新插件的遠程地址,-->
<pluginRepositories>
<!--包含需要連接到遠程插件倉庫的資訊.參見profiles/profile/repositories/repository元素的說明-->
<pluginRepository>
<releases>
<enabled/><updatePolicy/><checksumPolicy/>
</releases>
<snapshots>
<enabled/><updatePolicy/><checksumPolicy/>
</snapshots>
<id/><name/><url/><layout/>
</pluginRepository>
</pluginRepositories>
</profile>
</profiles>
activeProfiles
<!--手動激活profiles的串列,按照profile被應用的順序定義activeProfile, 該元素包含了一組activeProfile元素,每個activeProfile都含有一個profile id,任何在activeProfile中定義的profile id,不論環境設定如何,其對應的
profile都會被激活,如果沒有匹配的profile,則什么都不會發生,例如,env-test是一個activeProfile,則在pom.xml(或者profile.xml)中對應id的profile會被激活,如果運行程序中找不到這樣一個profile,Maven則會像往常一樣運行, -->
<activeProfiles>
<activeProfile>env-test</activeProfile>
</activeProfiles>
</settings>
轉載請註明出處,本文鏈接:https://www.uj5u.com/qita/509811.html
標籤:其他
