Maven系列2--pom.xml 配置详解
<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">
????<!--父項目的坐標(biāo)。如果項目中沒有規(guī)定某個元素的值,那么父項目中的對應(yīng)值即為項目的默認(rèn)值。坐標(biāo)包括group ID,artifact ID和 version。-->
????<parent>
?????<!--被繼承的父項目的構(gòu)件標(biāo)識符-->
?????<artifactId/>
?????<!--被繼承的父項目的全球唯一標(biāo)識符-->
?????<groupId/>
?????<!--被繼承的父項目的版本-->
?????<version/>
?????<!--父項目的pom.xml文件的相對路徑。相對路徑允許你選擇一個不同的路徑。默認(rèn)值是../pom.xml。Maven首先在構(gòu)建當(dāng)前項目的地方尋找父項目的pom,其次在文件系統(tǒng)的這個位置(relativePath位置),然后在本地倉庫,最后在遠(yuǎn)程倉庫尋找父項目的pom。-->
?????<relativePath/>
?</parent>
?<!--聲明項目描述符遵循哪一個POM模型版本。模型本身的版本很少改變,雖然如此,但它仍然是必不可少的,這是為了當(dāng)Maven引入了新的特性或者其他模型變更的時候,確保穩(wěn)定性。-->
????<modelVersion>4.0.0</modelVersion>
????<!--項目的全球唯一標(biāo)識符,通常使用全限定的包名區(qū)分該項目和其他項目。并且構(gòu)建時生成的路徑也是由此生成,如com.mycompany.app生成的相對路徑為:/com/mycompany/app-->
????<groupId>asia.banseon</groupId>
????<!--構(gòu)件的標(biāo)識符,它和groupID一起唯一標(biāo)識一個構(gòu)件。換句話說,你不能有兩個不同的項目擁有同樣的artifact ID和groupID;在某個特定的group ID下,artifact ID也必須是唯一的。構(gòu)件是項目產(chǎn)生的或使用的一個東西,Maven為項目產(chǎn)生的構(gòu)件包括:JARs,源碼,二進(jìn)制發(fā)布和WARs等。-->
????<artifactId>banseon-maven2</artifactId>
????<!--項目產(chǎn)生的構(gòu)件類型,例如jar、war、ear、pom。插件可以創(chuàng)建他們自己的構(gòu)件類型,所以前面列的不是全部構(gòu)件類型-->
????<packaging>jar</packaging>
????<!--項目當(dāng)前版本,格式為:主版本.次版本.增量版本-限定版本號-->
????<version>1.0-SNAPSHOT</version>
????<!--項目的名稱, Maven產(chǎn)生的文檔用-->
????<name>banseon-maven</name>
????<!--項目主頁的URL,Maven產(chǎn)生的文檔用-->
????<url>http://www.baidu.com/banseon</url>
????<!--項目的詳細(xì)描述,Maven 產(chǎn)生的文檔用。? 當(dāng)這個元素能夠用HTML格式描述時(例如,CDATA中的文本會被解析器忽略,就可以包含HTML標(biāo)簽),不鼓勵使用純文本描述。如果你需要修改產(chǎn)生的web站點的索引頁面,你應(yīng)該修改你自己的索引頁文件,而不是調(diào)整這里的文檔。-->
????<description>Amaven project to study maven.</description>
????<!--描述了這個項目構(gòu)建環(huán)境中的前提條件。-->
?<prerequisites>
??<!--構(gòu)建該項目或使用該插件所需要的Maven的最低版本-->
????<maven/>
?</prerequisites>
?<!--項目的問題管理系統(tǒng)(Bugzilla,Jira, Scarab,或任何你喜歡的問題管理系統(tǒng))的名稱和URL,本例為 jira-->
????<issueManagement>
?????<!--問題管理系統(tǒng)(例如jira)的名字,-->
????????<system>jira</system>
????????<!--該項目使用的問題管理系統(tǒng)的URL-->
????????<url>http://jira.baidu.com/banseon</url>
????</issueManagement>
????<!--項目持續(xù)集成信息-->
?<ciManagement>
??<!--持續(xù)集成系統(tǒng)的名字,例如continuum-->
??<system/>
??<!--該項目使用的持續(xù)集成系統(tǒng)的URL(如果持續(xù)集成系統(tǒng)有web接口的話)。-->
??<url/>
??<!--構(gòu)建完成時,需要通知的開發(fā)者/用戶的配置項。包括被通知者信息和通知條件(錯誤,失敗,成功,警告)-->
??<notifiers>
???<!--配置一種方式,當(dāng)構(gòu)建中斷時,以該方式通知用戶/開發(fā)者-->
???<notifier>
????<!--傳送通知的途徑-->
????<type/>
????<!--發(fā)生錯誤時是否通知-->
????<sendOnError/>
????<!--構(gòu)建失敗時是否通知-->
????<sendOnFailure/>
????<!--構(gòu)建成功時是否通知-->
????<sendOnSuccess/>
????<!--發(fā)生警告時是否通知-->
????<sendOnWarning/>
????<!--不贊成使用。通知發(fā)送到哪里-->
????<address/>
????<!--擴(kuò)展配置項-->
????<configuration/>
???</notifier>
??</notifiers>
?</ciManagement>
?<!--項目創(chuàng)建年份,4位數(shù)字。當(dāng)產(chǎn)生版權(quán)信息時需要使用這個值。-->
????<inceptionYear/>
????<!--項目相關(guān)郵件列表信息-->
????<mailingLists>
?????<!--該元素描述了項目相關(guān)的所有郵件列表。自動產(chǎn)生的網(wǎng)站引用這些信息。-->
????????<mailingList>
?????????<!--郵件的名稱-->
????????????<name>Demo</name>
????????????<!--發(fā)送郵件的地址或鏈接,如果是郵件地址,創(chuàng)建文檔時,mailto: 鏈接會被自動創(chuàng)建-->
????????????<post>banseon@126.com</post>
????????????<!--訂閱郵件的地址或鏈接,如果是郵件地址,創(chuàng)建文檔時,mailto: 鏈接會被自動創(chuàng)建-->
????????????<subscribe>banseon@126.com</subscribe>
????????????<!--取消訂閱郵件的地址或鏈接,如果是郵件地址,創(chuàng)建文檔時,mailto: 鏈接會被自動創(chuàng)建-->
????????????<unsubscribe>banseon@126.com</unsubscribe>
????????????<!--你可以瀏覽郵件信息的URL-->
????????????<archive>http:/hi.baidu.com/banseon/demo/dev/</archive>
????????</mailingList>
????</mailingLists>
????<!--項目開發(fā)者列表-->
????<developers>
?????<!--某個項目開發(fā)者的信息-->
????????<developer>
?????????<!--SCM里項目開發(fā)者的唯一標(biāo)識符-->
????????????<id>HELLOWORLD</id>
????????????<!--項目開發(fā)者的全名-->
????????????<name>banseon</name>
????????????<!--項目開發(fā)者的email-->
????????????<email>banseon@126.com</email>
????????????<!--項目開發(fā)者的主頁的URL-->
????????????<url/>
????????????<!--項目開發(fā)者在項目中扮演的角色,角色元素描述了各種角色-->
????????????<roles>
????????????????<role>ProjectManager</role>
????????????????<role>Architect</role>
????????????</roles>
????????????<!--項目開發(fā)者所屬組織-->
????????????<organization>demo</organization>
????????????<!--項目開發(fā)者所屬組織的URL-->
????????????<organizationUrl>http://hi.baidu.com/banseon</organizationUrl>
????????????<!--項目開發(fā)者屬性,如即時消息如何處理等-->
????????????<properties>
????????????????<dept>No</dept>
????????????</properties>
????????????<!--項目開發(fā)者所在時區(qū),-11到12范圍內(nèi)的整數(shù)。-->
????????????<timezone>-5</timezone>
????????</developer>
????</developers>
????<!--項目的其他貢獻(xiàn)者列表-->
????<contributors>
?????<!--項目的其他貢獻(xiàn)者。參見developers/developer元素-->
?????<contributor>
???<name/><email/><url/><organization/><organizationUrl/><roles/><timezone/><properties/>
?????</contributor>
????</contributors>
????<!--該元素描述了項目所有License列表。 應(yīng)該只列出該項目的license列表,不要列出依賴項目的license列表。如果列出多個license,用戶可以選擇它們中的一個而不是接受所有l(wèi)icense。-->
????<licenses>
?????<!--描述了項目的license,用于生成項目的web站點的license頁面,其他一些報表和validation也會用到該元素。-->
????????<license>
?????????<!--license用于法律上的名稱-->
????????????<name>Apache2</name>
????????????<!--官方的license正文頁面的URL-->
????????????<url>http://www.baidu.com/banseon/LICENSE-2.0.txt</url>
????????????<!--項目分發(fā)的主要方式:
??????????????repo,可以從Maven庫下載
??????????????manual, 用戶必須手動下載和安裝依賴-->
????????????<distribution>repo</distribution>
????????????<!--關(guān)于license的補(bǔ)充信息-->
????????????<comments>Abusiness-friendly OSS license</comments>
????????</license>
????</licenses>
????<!--SCM(SourceControl Management)標(biāo)簽允許你配置你的代碼庫,供Maven web站點和其它插件使用。-->
????<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/>
????????<!--指向項目的可瀏覽SCM庫(例如ViewVC或者Fisheye)的URL。-->
????????<url>http://svn.baidu.com/banseon</url>
????</scm>
????<!--描述項目所屬組織的各種屬性。Maven產(chǎn)生的文檔用-->
????<organization>
?????<!--組織的全名-->
????????<name>demo</name>
????????<!--組織主頁的URL-->
????????<url>http://www.baidu.com/banseon</url>
????</organization>
????<!--構(gòu)建項目需要的信息-->
????<build>
?????<!--該元素設(shè)置了項目源碼目錄,當(dāng)構(gòu)建項目的時候,構(gòu)建系統(tǒng)會編譯目錄里的源碼。該路徑是相對于pom.xml的相對路徑。-->
??<sourceDirectory/>
??<!--該元素設(shè)置了項目腳本源碼目錄,該目錄和源碼目錄不同:絕大多數(shù)情況下,該目錄下的內(nèi)容會被拷貝到輸出目錄(因為腳本是被解釋的,而不是被編譯的)。-->
??<scriptSourceDirectory/>
??<!--該元素設(shè)置了項目單元測試使用的源碼目錄,當(dāng)測試項目的時候,構(gòu)建系統(tǒng)會編譯目錄里的源碼。該路徑是相對于pom.xml的相對路徑。-->
??<testSourceDirectory/>
??<!--被編譯過的應(yīng)用程序class文件存放的目錄。-->
??<outputDirectory/>
??<!--被編譯過的測試class文件存放的目錄。-->
??<testOutputDirectory/>
??<!--使用來自該項目的一系列構(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)項目沒有規(guī)定目標(biāo)(Maven2叫做階段)時的默認(rèn)值-->
??<defaultGoal/>
??<!--這個元素描述了項目相關(guān)的所有資源路徑列表,例如和項目相關(guān)的屬性文件,這些資源被包含在最終的打包文件里。-->
??<resources>
???<!--這個元素描述了項目相關(guān)或測試相關(guān)的所有資源路徑-->
???<resource>
????<!--描述了資源的目標(biāo)路徑。該路徑相對target/classes目錄(例如${project.build.outputDirectory})。舉個例子,如果你想資源在特定的包里(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>
??<!--這個元素描述了單元測試相關(guān)的所有資源路徑,例如和單元測試相關(guān)的屬性文件。-->
??<testResources>
???<!--這個元素描述了測試相關(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)打開時,使用到的過濾器屬性文件列表-->
??<filters/>
??<!--子項目可以引用的默認(rèn)插件信息。該插件配置項直到被引用時才會被解析或綁定到生命周期。給定插件的任何本地配置都會覆蓋這里的配置-->
??<pluginManagement>
???<!--使用的插件列表 。-->
???<plugins>
????<!--plugin元素包含描述插件所需要的信息。-->
????<plugin>
?????<!--插件在倉庫里的groupID-->
?????<groupId/>
?????<!--插件在倉庫里的artifactID-->
?????<artifactId/>
?????<!--被使用的插件的版本(或版本范圍)-->
?????<version/>
?????<!--是否從該插件下載Maven擴(kuò)展(例如打包和類型處理器),由于性能原因,只有在真需要下載時,該元素才被設(shè)置成enabled。-->
?????<extensions/>
?????<!--在構(gòu)建生命周期中執(zhí)行一組目標(biāo)的配置。每個目標(biāo)可能有不同的配置。-->
?????<executions>
??????<!--execution元素包含了插件執(zhí)行需要的信息-->
??????<execution>
???????<!--執(zhí)行目標(biāo)的標(biāo)識符,用于標(biāo)識構(gòu)建過程中的目標(biāo),或者匹配繼承過程中需要合并的執(zhí)行目標(biāo)-->
???????<id/>
???????<!--綁定了目標(biāo)的構(gòu)建生命周期階段,如果省略,目標(biāo)會被綁定到源數(shù)據(jù)里配置的默認(rèn)階段-->
???????<phase/>
???????<!--配置的執(zhí)行目標(biāo)-->
???????<goals/>
???????<!--配置是否被傳播到子POM-->
???????<inherited/>
???????<!--作為DOM對象的配置-->
???????<configuration/>
??????</execution>
?????</executions>
?????<!--項目引入插件所需要的額外依賴-->
?????<dependencies>
??????<!--參見dependencies/dependency元素-->
??????<dependency>
???????......
??????</dependency>
?????</dependencies>
?????<!--任何配置是否被傳播到子項目-->
?????<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>
?<!--在列的項目構(gòu)建profile,如果被激活,會修改構(gòu)建處理-->
?<profiles>
??<!--根據(jù)環(huán)境參數(shù)或命令行參數(shù)激活某個構(gòu)建處理-->
??<profile>
???<!--構(gòu)建配置的唯一標(biāo)識符。即用于命令行激活,也用于在繼承時合并具有相同標(biāo)識符的profile。-->
???<id/>
???<!--自動觸發(fā)profile的條件邏輯。Activation是profile的開啟鑰匙。profile的力量來自于它
???能夠在某些特定的環(huán)境中自動使用某些特定的值;這些環(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>WindowsXP</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檢測到某一個屬性(其值可以在POM中通過${名稱}引用),其擁有對應(yīng)的名稱和值,Profile就會被激活。如果值
????字段是空的,那么存在屬性名稱字段就會激活profile,否則按區(qū)分大小寫方式匹配屬性值字段-->
????<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>
???<!--構(gòu)建項目所需要的信息。參見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>
???<!--模塊(有時稱作子項目) 被構(gòu)建成項目的一部分。列出的每個模塊元素是指向該模塊的目錄的相對路徑-->
???<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)建和報表-->
???<pluginRepositories>
????<!--包含需要連接到遠(yuǎn)程插件倉庫的信息.參見repositories/repository元素-->
????<pluginRepository>
?????<releases>
??????<enabled/><updatePolicy/><checksumPolicy/>
?????</releases>
?????<snapshots>
??????<enabled/><updatePolicy/><checksumPolicy/>
?????</snapshots>
?????<id/><name/><url/><layout/>
????</pluginRepository>
???</pluginRepositories>
???<!--該元素描述了項目相關(guān)的所有依賴。 這些依賴組成了項目構(gòu)建過程中的一個個環(huán)節(jié)。它們自動從項目定義的倉庫中下載。要獲取更多信息,請看項目依賴機(jī)制。-->
???<dependencies>
????<!--參見dependencies/dependency元素-->
????<dependency>
?????......
????</dependency>
???</dependencies>
???<!--不贊成使用. 現(xiàn)在Maven忽略該元素.-->
???<reports/>
???<!--該元素包括使用報表插件產(chǎn)生報表的規(guī)范。當(dāng)用戶執(zhí)行“mvn site”,這些報表就會運行。在頁面導(dǎo)航欄能看到所有報表的鏈接。參見reporting元素-->
???<reporting>
????......
???</reporting>
???<!--參見dependencyManagement元素-->
???<dependencyManagement>
????<dependencies>
?????<!--參見dependencies/dependency元素-->
?????<dependency>
??????......
?????</dependency>
????</dependencies>
???</dependencyManagement>
???<!--參見distributionManagement元素-->
???<distributionManagement>
????......
???</distributionManagement>
???<!--參見properties元素-->
???<properties/>
??</profile>
?</profiles>
?<!--模塊(有時稱作子項目) 被構(gòu)建成項目的一部分。列出的每個模塊元素是指向該模塊的目錄的相對路徑-->
?<modules/>
????<!--發(fā)現(xiàn)依賴和擴(kuò)展的遠(yuǎn)程倉庫列表。-->
????<repositories>
?????<!--包含需要連接到遠(yuǎn)程倉庫的信息-->
????????<repository>
?????????<!--如何處理遠(yuǎn)程倉庫里發(fā)布版本的下載-->
?????????<releases>
??????????<!--true或者false表示該倉庫是否為下載某種類型構(gòu)件(發(fā)布版,快照版)開啟。 -->
????<enabled/>
????<!--該元素指定更新發(fā)生的頻率。Maven會比較本地POM和遠(yuǎn)程POM的時間戳。這里的選項是:always(一直),daily(默認(rèn),每日),interval:X(這里X是以分鐘為單位的時間間隔),或者never(從不)。-->
????<updatePolicy/>
????<!--當(dāng)Maven驗證構(gòu)件校驗文件失敗時該怎么做:ignore(忽略),fail(失敗),或者warn(警告)。-->
????<checksumPolicy/>
???</releases>
???<!--如何處理遠(yuǎn)程倉庫里快照版本的下載。有了releases和snapshots這兩組配置,POM就可以在每個單獨的倉庫中,為每種類型的構(gòu)件采取不同的策略。例如,可能有人會決定只為開發(fā)目的開啟對快照版本下載的支持。參見repositories/repository/releases元素-->
???<snapshots>
????<enabled/><updatePolicy/><checksumPolicy/>
???</snapshots>
???<!--遠(yuǎn)程倉庫唯一標(biāo)識符。可以用來匹配在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為其倉庫提供了一個默認(rèn)的布局;然而,Maven 1.x有一種不同的布局。我們可以使用該元素指定布局是default(默認(rèn))還是legacy(遺留)。-->
????????????<layout>default</layout>
????????</repository>
????</repositories>
????<!--發(fā)現(xiàn)插件的遠(yuǎn)程倉庫列表,這些插件用于構(gòu)建和報表-->
????<pluginRepositories>
?????<!--包含需要連接到遠(yuǎn)程插件倉庫的信息.參見repositories/repository元素-->
??<pluginRepository>
???......
??</pluginRepository>
?</pluginRepositories>
?
????<!--該元素描述了項目相關(guān)的所有依賴。 這些依賴組成了項目構(gòu)建過程中的一個個環(huán)節(jié)。它們自動從項目定義的倉庫中下載。要獲取更多信息,請看項目依賴機(jī)制。-->
????<dependencies>
????????<dependency>
???<!--依賴的groupID-->
????????????<groupId>org.apache.maven</groupId>
????????????<!--依賴的artifactID-->
????????????<artifactId>maven-artifact</artifactId>
????????????<!--依賴的版本號。 在Maven 2里, 也可以配置成版本號的范圍。-->
????????????<version>3.8.1</version>
????????????<!--依賴類型,默認(rèn)類型是jar。它通常表示依賴的文件的擴(kuò)展名,但也有例外。一個類型可以被映射成另外一個擴(kuò)展名或分類器。類型經(jīng)常和使用的打包方式對應(yīng),盡管這也有例外。一些類型的例子:jar,war,ejb-client和test-jar。如果設(shè)置extensions為 true,就可以在plugin里定義新的類型。所以前面的類型的例子不完整。-->
????????????<type>jar</type>
????????????<!--依賴的分類器。分類器可以區(qū)分屬于同一個POM,但不同構(gòu)建方式的構(gòu)件。分類器名被附加到文件名的版本號后面。例如,如果你想要構(gòu)建兩個單獨的構(gòu)件成JAR,一個使用Java 1.4編譯器,另一個使用Java 6編譯器,你就可以使用分類器來生成兩個單獨的JAR構(gòu)件。-->
????????????<classifier></classifier>
????????????<!--依賴范圍。在項目發(fā)布過程中,幫助決定哪些構(gòu)件被包括進(jìn)來。欲知詳情請參考依賴機(jī)制。
????????????????-compile :默認(rèn)范圍,用于編譯
????????????????-provided:類似于編譯,但支持你期待jdk或者容器提供,類似于classpath
????????????????-runtime: 在執(zhí)行時需要使用
????????????????-test:??? 用于test任務(wù)時使用
????????????????-system: 需要外在提供相應(yīng)的元素。通過systemPath來取得
????????????????-systemPath: 僅用于范圍為system。提供相應(yīng)的路徑
????????????????-optional:?? 當(dāng)項目自身被依賴時,標(biāo)注依賴是否傳遞。用于連續(xù)依賴時使用-->
????????????<scope>test</scope>
????????????<!--僅供system范圍使用。注意,不鼓勵使用這個元素,并且在新的版本中該元素可能被覆蓋掉。該元素為依賴規(guī)定了文件系統(tǒng)上的路徑。需要絕對路徑而不是相對路徑。推薦使用屬性匹配絕對路徑,例如${java.home}。-->
????????????<systemPath></systemPath>
????????????<!--當(dāng)計算傳遞依賴時, 從依賴構(gòu)件列表里,列出被排除的依賴構(gòu)件集。即告訴maven你只依賴指定的項目,不依賴項目的依賴。此元素主要用于解決版本沖突問題-->
????????????<exclusions>
?????????????<exclusion>
????????????????????<artifactId>spring-core</artifactId>
????????????????????<groupId>org.springframework</groupId>
????????????????</exclusion>
????????????</exclusions>
????????????<!--可選依賴,如果你在項目B中把C依賴聲明為可選,你就需要在依賴于B的項目(例如項目A)中顯式的引用對C的依賴。可選依賴阻斷依賴的傳遞性。-->
????????????<optional>true</optional>
????????</dependency>
????</dependencies>
????<!--不贊成使用. 現(xiàn)在Maven忽略該元素.-->
????<reports></reports>
????<!--該元素描述使用報表插件產(chǎn)生報表的規(guī)范。當(dāng)用戶執(zhí)行“mvn site”,這些報表就會運行。在頁面導(dǎo)航欄能看到所有報表的鏈接。-->
?<reporting>
??<!--true,則,網(wǎng)站不包括默認(rèn)的報表。這包括“項目信息”菜單中的報表。-->
??<excludeDefaults/>
??<!--所有產(chǎn)生的報表存放到哪里。默認(rèn)值是${project.build.directory}/site。-->
??<outputDirectory/>
??<!--使用的報表插件和他們的配置。-->
??<plugins>
???<!--plugin元素包含描述報表插件需要的信息-->
???<plugin>
????<!--報表插件在倉庫里的groupID-->
????<groupId/>
????<!--報表插件在倉庫里的artifactID-->
????<artifactId/>
????<!--被使用的報表插件的版本(或版本范圍)-->
????<version/>
????<!--任何配置是否被傳播到子項目-->
????<inherited/>
????<!--報表插件的配置-->
????<configuration/>
????<!--一組報表的多重規(guī)范,每個規(guī)范可能有不同的配置。一個規(guī)范(報表集)對應(yīng)一個執(zhí)行目標(biāo)。例如,有1,2,3,4,5,6,7,8,9個報表。1,2,5構(gòu)成A報表集,對應(yīng)一個執(zhí)行目標(biāo)。2,5,8構(gòu)成B報表集,對應(yīng)另一個執(zhí)行目標(biāo)-->
????<reportSets>
?????<!--表示報表的一個集合,以及產(chǎn)生該集合的配置-->
?????<reportSet>
??????<!--報表集合的唯一標(biāo)識符,POM繼承時用到-->
??????<id/>
??????<!--產(chǎn)生報表集合時,被使用的報表的配置-->
??????<configuration/>
??????<!--配置是否被繼承到子POMs-->
??????<inherited/>
??????<!--這個集合里使用到哪些報表-->
??????<reports/>
?????</reportSet>
????</reportSets>
???</plugin>
??</plugins>
?</reporting>
?<!--繼承自該項目的所有子項目的默認(rèn)依賴信息。這部分的依賴信息不會被立即解析,而是當(dāng)子項目聲明一個依賴(必須描述group ID和artifact ID信息),如果group ID和artifact ID以外的一些信息沒有描述,則通過group ID和artifact ID匹配到這里的依賴,并使用這里的依賴信息。-->
?<dependencyManagement>
??<dependencies>
???<!--參見dependencies/dependency元素-->
???<dependency>
????......
???</dependency>
??</dependencies>
?</dependencyManagement>
????<!--項目分發(fā)信息,在執(zhí)行mvndeploy后表示要發(fā)布的位置。有了這些信息就可以把網(wǎng)站部署到遠(yuǎn)程服務(wù)器或者把構(gòu)件部署到遠(yuǎn)程倉庫。-->
????<distributionManagement>
????????<!--部署項目產(chǎn)生的構(gòu)件到遠(yuǎn)程倉庫需要的信息-->
????????<repository>
?????????<!--是分配給快照一個唯一的版本號(由時間戳和構(gòu)建流水號)?還是每次都使用相同的版本號?參見repositories/repository元素-->
???<uniqueVersion/>
???<id>banseon-maven2</id>
???<name>banseonmaven2</name>
????????????<url>file://${basedir}/target/deploy</url>
????????????<layout/>
??</repository>
??<!--構(gòu)件的快照部署到哪里?如果沒有配置該元素,默認(rèn)部署到repository元素配置的倉庫,參見distributionManagement/repository元素-->
??<snapshotRepository>
???<uniqueVersion/>
???<id>banseon-maven2</id>
????????????<name>Banseon-maven2Snapshot Repository</name>
????????????<url>scp://svn.baidu.com/banseon:/usr/local/maven-snapshot</url>
???<layout/>
??</snapshotRepository>
??<!--部署項目的網(wǎng)站需要的信息-->
????????<site>
?????????<!--部署位置的唯一標(biāo)識符,用來匹配站點和settings.xml文件里的配置-->
????????????<id>banseon-site</id>
????????????<!--部署位置的名稱-->
????????????<name>businessapi website</name>
????????????<!--部署位置的URL,按protocol://hostname/path形式-->
????????????<url>
????????????????scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web
????????????</url>
????????</site>
??<!--項目下載頁面的URL。如果沒有該元素,用戶應(yīng)該參考主頁。使用該元素的原因是:幫助定位那些不在倉庫里的構(gòu)件(由于license限制)。-->
??<downloadUrl/>
??<!--如果構(gòu)件有了新的groupID和artifact ID(構(gòu)件移到了新的位置),這里列出構(gòu)件的重定位信息。-->
??<relocation>
???<!--構(gòu)件新的groupID-->
???<groupId/>
???<!--構(gòu)件新的artifactID-->
???<artifactId/>
???<!--構(gòu)件新的版本號-->
???<version/>
???<!--顯示給用戶的,關(guān)于移動的額外信息,例如原因。-->
???<message/>
??</relocation>
??<!--給出該構(gòu)件在遠(yuǎn)程倉庫的狀態(tài)。不得在本地項目中設(shè)置該元素,因為這是工具自動更新的。有效的值有:none(默認(rèn)),converted(倉庫管理員從Maven 1 POM轉(zhuǎn)換過來),partner(直接從伙伴Maven 2倉庫同步過來),deployed(從Maven 2實例部署),verified(被核實時正確的和最終的)。-->
??<status/>
????</distributionManagement>
????<!--以值替代名稱,Properties可以在整個POM中使用,也可以作為觸發(fā)條件(見settings.xml配置文件里activation元素的說明)。格式是<name>value</name>。-->
????<properties/>
</project>
?
總結(jié)
以上是生活随笔為你收集整理的Maven系列2--pom.xml 配置详解的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Linux下base64命令工具的使用
- 下一篇: JEECG v3视频陆续更新