POM文件詳解
對(duì)于POM文件的結(jié)構(gòu)一直都是本人的一個(gè)困惑點(diǎn)爷肝,一個(gè)個(gè)冒出來(lái)的配置每每有不明了的時(shí)候,都要在互聯(lián)網(wǎng)上翻閱很久动猬,這里直接將所有的標(biāo)簽列舉如下捎稚,方面查閱桶癣。
1. 總的架構(gòu)
<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 ">
<!-- 父項(xiàng)目的坐標(biāo)拥褂。如果項(xiàng)目中沒(méi)有規(guī)定某個(gè)元素的值,那么父項(xiàng)目中的對(duì)應(yīng)值即為項(xiàng)目的默認(rèn)值牙寞。
坐標(biāo)包括group ID饺鹃,artifact ID和 version莫秆。 -->
<parent>
<!-- 被繼承的父項(xiàng)目的構(gòu)件標(biāo)識(shí)符 -->
<artifactId>xxx</artifactId>
<!-- 被繼承的父項(xiàng)目的全球唯一標(biāo)識(shí)符 -->
<groupId>xxx</groupId>
<!-- 被繼承的父項(xiàng)目的版本 -->
<version>xxx</version>
<!-- 父項(xiàng)目的pom.xml文件的相對(duì)路徑。相對(duì)路徑允許你選擇一個(gè)不同的路徑悔详。默認(rèn)值是../pom.xml镊屎。
Maven首先在構(gòu)建當(dāng)前項(xiàng)目的地方尋找父項(xiàng)目的pom,其次在文件系統(tǒng)的這個(gè)位置(relativePath位置)茄螃,
然后在本地倉(cāng)庫(kù)缝驳,最后在遠(yuǎn)程倉(cāng)庫(kù)尋找父項(xiàng)目的pom。 -->
<relativePath>xxx</relativePath>
</parent>
<!-- 聲明項(xiàng)目描述符遵循哪一個(gè)POM模型版本归苍。模型本身的版本很少改變用狱,雖然如此,但它仍然是必不可少的拼弃,
這是為了當(dāng)Maven引入了新的特性或者其他模型變更的時(shí)候夏伊,確保穩(wěn)定性。 -->
<modelVersion> 4.0.0 </modelVersion>
<!-- 項(xiàng)目的全球唯一標(biāo)識(shí)符肴敛,通常使用全限定的包名區(qū)分該項(xiàng)目和其他項(xiàng)目署海。并且構(gòu)建時(shí)生成的路徑也是由此生成,
如com.mycompany.app生成的相對(duì)路徑為:/com/mycompany/app -->
<groupId>xxx</groupId>
<!-- 構(gòu)件的標(biāo)識(shí)符医男,它和group ID一起唯一標(biāo)識(shí)一個(gè)構(gòu)件。換句話說(shuō)捻勉,你不能有兩個(gè)不同的項(xiàng)目擁有同樣的artifact ID
和groupID镀梭;在某個(gè)特定的group ID下,artifact ID也必須是唯一的踱启。構(gòu)件是項(xiàng)目產(chǎn)生的或使用的一個(gè)東西报账,Maven
為項(xiàng)目產(chǎn)生的構(gòu)件包括:JARs,源碼埠偿,二進(jìn)制發(fā)布和WARs等透罢。 -->
<artifactId>xxx</artifactId>
<!-- 項(xiàng)目產(chǎn)生的構(gòu)件類型,例如jar冠蒋、war羽圃、ear、pom抖剿。插件可以創(chuàng)建他們自己的構(gòu)件類型朽寞,所以前面列的不是全部構(gòu)件類型 -->
<packaging> jar </packaging>
<!-- 項(xiàng)目當(dāng)前版本,格式為:主版本.次版本.增量版本-限定版本號(hào) -->
<version> 1.0-SNAPSHOT </version>
<!-- 項(xiàng)目的名稱, Maven產(chǎn)生的文檔用 -->
<name> xxx-maven </name>
<!-- 項(xiàng)目主頁(yè)的URL, Maven產(chǎn)生的文檔用 -->
<url> http://maven.apache.org </url>
<!-- 項(xiàng)目的詳細(xì)描述, Maven 產(chǎn)生的文檔用斩郎。 當(dāng)這個(gè)元素能夠用HTML格式描述時(shí)(例如脑融,CDATA中的文本會(huì)被解析器忽略,
就可以包含HTML標(biāo)簽)缩宜, 不鼓勵(lì)使用純文本描述肘迎。如果你需要修改產(chǎn)生的web站點(diǎn)的索引頁(yè)面,你應(yīng)該修改你自己的
索引頁(yè)文件,而不是調(diào)整這里的文檔妓布。 -->
<description> A maven project to study maven. </description>
<!-- 描述了這個(gè)項(xiàng)目構(gòu)建環(huán)境中的前提條件窿侈。 -->
<prerequisites>
<!-- 構(gòu)建該項(xiàng)目或使用該插件所需要的Maven的最低版本 -->
<maven></maven>
</prerequisites>
<!-- 項(xiàng)目的問(wèn)題管理系統(tǒng)(Bugzilla, Jira, Scarab,或任何你喜歡的問(wèn)題管理系統(tǒng))的名稱和URL,本例為 jira -->
<issueManagement>
<!-- 問(wèn)題管理系統(tǒng)(例如jira)的名字秋茫, -->
<system> jira </system>
<!-- 該項(xiàng)目使用的問(wèn)題管理系統(tǒng)的URL -->
<url> http://jira.baidu.com/banseon </url>
</issueManagement>
<!-- 項(xiàng)目持續(xù)集成信息 -->
<ciManagement>
<!-- 持續(xù)集成系統(tǒng)的名字史简,例如continuum -->
<system></system>
<!-- 該項(xiàng)目使用的持續(xù)集成系統(tǒng)的URL(如果持續(xù)集成系統(tǒng)有web接口的話)。 -->
<url></url>
<!-- 構(gòu)建完成時(shí)肛著,需要通知的開(kāi)發(fā)者/用戶的配置項(xiàng)圆兵。包括被通知者信息和通知條件(錯(cuò)誤,失敗枢贿,成功殉农,警告) -->
<notifiers>
<!-- 配置一種方式,當(dāng)構(gòu)建中斷時(shí)局荚,以該方式通知用戶/開(kāi)發(fā)者 -->
<notifier>
<!-- 傳送通知的途徑 -->
<type></type>
<!-- 發(fā)生錯(cuò)誤時(shí)是否通知 -->
<sendOnError></sendOnError>
<!-- 構(gòu)建失敗時(shí)是否通知 -->
<sendOnFailure></sendOnFailure>
<!-- 構(gòu)建成功時(shí)是否通知 -->
<sendOnSuccess></sendOnSuccess>
<!-- 發(fā)生警告時(shí)是否通知 -->
<sendOnWarning></sendOnWarning>
<!-- 不贊成使用超凳。通知發(fā)送到哪里 --><address></address>
<!-- 擴(kuò)展配置項(xiàng) -->
<configuration></configuration>
</notifier>
</notifiers>
</ciManagement>
<!-- 項(xiàng)目創(chuàng)建年份,4位數(shù)字耀态。當(dāng)產(chǎn)生版權(quán)信息時(shí)需要使用這個(gè)值轮傍。 -->
<inceptionYear />
<!-- 項(xiàng)目相關(guān)郵件列表信息 -->
<mailingLists>
<!-- 該元素描述了項(xiàng)目相關(guān)的所有郵件列表。自動(dòng)產(chǎn)生的網(wǎng)站引用這些信息首装。 -->
<mailingList>
<!-- 郵件的名稱 -->
<name> Demo </name>
<!-- 發(fā)送郵件的地址或鏈接创夜,如果是郵件地址,創(chuàng)建文檔時(shí)仙逻,mailto: 鏈接會(huì)被自動(dòng)創(chuàng)建 -->
<post> banseon@126.com </post>
<!-- 訂閱郵件的地址或鏈接驰吓,如果是郵件地址,創(chuàng)建文檔時(shí)系奉,mailto: 鏈接會(huì)被自動(dòng)創(chuàng)建 -->
<subscribe> banseon@126.com </subscribe>
<!-- 取消訂閱郵件的地址或鏈接檬贰,如果是郵件地址,創(chuàng)建文檔時(shí)缺亮,mailto: 鏈接會(huì)被自動(dòng)創(chuàng)建 -->
<unsubscribe> banseon@126.com </unsubscribe>
<!-- 你可以瀏覽郵件信息的URL -->
<archive> http:/hi.baidu.com/banseon/demo/dev/
</archive>
</mailingList>
</mailingLists>
<!-- 項(xiàng)目開(kāi)發(fā)者列表 -->
<developers>
<!-- 某個(gè)項(xiàng)目開(kāi)發(fā)者的信息 -->
<developer>
<!-- SCM里項(xiàng)目開(kāi)發(fā)者的唯一標(biāo)識(shí)符 -->
<id> HELLO WORLD </id>
<!-- 項(xiàng)目開(kāi)發(fā)者的全名 -->
<name> banseon </name>
<!-- 項(xiàng)目開(kāi)發(fā)者的email -->
<email> banseon@126.com </email>
<!-- 項(xiàng)目開(kāi)發(fā)者的主頁(yè)的URL -->
<url></url>
<!-- 項(xiàng)目開(kāi)發(fā)者在項(xiàng)目中扮演的角色翁涤,角色元素描述了各種角色 -->
<roles>
<role> Project Manager </role>
<role> Architect </role>
</roles>
<!-- 項(xiàng)目開(kāi)發(fā)者所屬組織 -->
<organization> demo </organization>
<!-- 項(xiàng)目開(kāi)發(fā)者所屬組織的URL -->
<organizationUrl> http://hi.baidu.com/xxx </organizationUrl>
<!-- 項(xiàng)目開(kāi)發(fā)者屬性,如即時(shí)消息如何處理等 -->
<properties>
<dept> No </dept>
</properties>
<!-- 項(xiàng)目開(kāi)發(fā)者所在時(shí)區(qū)瞬内, -11到12范圍內(nèi)的整數(shù)迷雪。 -->
<timezone> -5 </timezone>
</developer>
</developers>
<!-- 項(xiàng)目的其他貢獻(xiàn)者列表 -->
<contributors>
<!-- 項(xiàng)目的其他貢獻(xiàn)者。參見(jiàn)developers/developer元素 -->
<contributor>
<!-- 項(xiàng)目貢獻(xiàn)者的全名 -->
<name></name>
<!-- 項(xiàng)目貢獻(xiàn)者的email -->
<email></email>
<!-- 項(xiàng)目貢獻(xiàn)者的主頁(yè)的URL -->
<url></url>
<!-- 項(xiàng)目貢獻(xiàn)者所屬組織 -->
<organization></organization>
<!-- 項(xiàng)目貢獻(xiàn)者所屬組織的URL -->
<organizationUrl></organizationUrl>
<!-- 項(xiàng)目貢獻(xiàn)者在項(xiàng)目中扮演的角色虫蝶,角色元素描述了各種角色 -->
<roles>
<role> Project Manager </role>
<role> Architect </role>
</roles>
<!-- 項(xiàng)目貢獻(xiàn)者所在時(shí)區(qū)章咧, -11到12范圍內(nèi)的整數(shù)。 -->
<timezone></timezone>
<!-- 項(xiàng)目貢獻(xiàn)者屬性能真,如即時(shí)消息如何處理等 -->
<properties>
<dept> No </dept>
</properties>
</contributor>
</contributors>
<!-- 該元素描述了項(xiàng)目所有License列表赁严。 應(yīng)該只列出該項(xiàng)目的license列表扰柠,不要列出依賴項(xiàng)目的 license列表。
如果列出多個(gè)license疼约,用戶可以選擇它們中的一個(gè)而不是接受所有l(wèi)icense卤档。 -->
<licenses>
<!-- 描述了項(xiàng)目的license,用于生成項(xiàng)目的web站點(diǎn)的license頁(yè)面程剥,其他一些報(bào)表和validation也會(huì)用到該元素劝枣。 -->
<license>
<!-- license用于法律上的名稱 -->
<name> Apache 2 </name>
<!-- 官方的license正文頁(yè)面的URL -->
<url> http://www.baidu.com/banseon/LICENSE-2.0.txt
</url>
<!-- 項(xiàng)目分發(fā)的主要方式:
repo,可以從Maven庫(kù)下載
manual织鲸, 用戶必須手動(dòng)下載和安裝依賴 -->
<distribution> repo </distribution>
<!-- 關(guān)于license的補(bǔ)充信息 -->
<comments> A business-friendly OSS license
</comments>
</license>
</licenses>
<!-- SCM(Source Control Management)標(biāo)簽允許你配置你的代碼庫(kù)舔腾,供Maven web站點(diǎn)和其它插件使用。 -->
<scm>
<!-- SCM的URL,該URL描述了版本庫(kù)和如何連接到版本庫(kù)搂擦。欲知詳情稳诚,請(qǐng)看SCMs提供的URL格式和列表。該連接只讀瀑踢。 -->
<connection> scm:svn:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk)
</connection>
<!-- 給開(kāi)發(fā)者使用的扳还,類似connection元素。即該連接不僅僅只讀 -->
<developerConnection> scm:svn:http://svn.baidu.com/banseon/maven/banseon/dao-trunk
</developerConnection>
<!-- 當(dāng)前代碼的標(biāo)簽橱夭,在開(kāi)發(fā)階段默認(rèn)為HEAD -->
<tag></tag>
<!-- 指向項(xiàng)目的可瀏覽SCM庫(kù)(例如ViewVC或者Fisheye)的URL氨距。 -->
<url> http://svn.baidu.com/banseon </url>
</scm>
<!-- 描述項(xiàng)目所屬組織的各種屬性。Maven產(chǎn)生的文檔用 -->
<organization>
<!-- 組織的全名 -->
<name> demo </name>
<!-- 組織主頁(yè)的URL -->
<url> http://www.baidu.com/banseon </url>
</organization>
<!-- 構(gòu)建項(xiàng)目需要的信息 -->
<build>
<!-- 該元素設(shè)置了項(xiàng)目源碼目錄徘钥,當(dāng)構(gòu)建項(xiàng)目的時(shí)候衔蹲,構(gòu)建系統(tǒng)會(huì)編譯目錄里的源碼。該路徑是相對(duì)
于pom.xml的相對(duì)路徑呈础。 -->
<sourceDirectory></sourceDirectory>
<!-- 該元素設(shè)置了項(xiàng)目腳本源碼目錄,該目錄和源碼目錄不同:絕大多數(shù)情況下橱健,該目錄下的內(nèi)容會(huì)
被拷貝到輸出目錄(因?yàn)槟_本是被解釋的而钞,而不是被編譯的)。 -->
<scriptSourceDirectory></scriptSourceDirectory>
<!-- 該元素設(shè)置了項(xiàng)目單元測(cè)試使用的源碼目錄拘荡,當(dāng)測(cè)試項(xiàng)目的時(shí)候臼节,構(gòu)建系統(tǒng)會(huì)編譯目錄里的源碼。
該路徑是相對(duì)于pom.xml的相對(duì)路徑珊皿。 -->
<testSourceDirectory></testSourceDirectory>
<!-- 被編譯過(guò)的應(yīng)用程序class文件存放的目錄网缝。 -->
<outputDirectory></outputDirectory>
<!-- 被編譯過(guò)的測(cè)試class文件存放的目錄。 -->
<testOutputDirectory></testOutputDirectory>
<!-- 使用來(lái)自該項(xiàng)目的一系列構(gòu)建擴(kuò)展 -->
<extensions>
<!-- 描述使用到的構(gòu)建擴(kuò)展蟋定。 -->
<extension>
<!-- 構(gòu)建擴(kuò)展的groupId -->
<groupId></groupId>
<!-- 構(gòu)建擴(kuò)展的artifactId -->
<artifactId></artifactId>
<!-- 構(gòu)建擴(kuò)展的版本 -->
<version></version>
</extension>
</extensions>
<!-- 當(dāng)項(xiàng)目沒(méi)有規(guī)定目標(biāo)(Maven2 叫做階段)時(shí)的默認(rèn)值 -->
<defaultGoal></defaultGoal>
<!-- 這個(gè)元素描述了項(xiàng)目相關(guān)的所有資源路徑列表粉臊,例如和項(xiàng)目相關(guān)的屬性文件,這些資源被包含在
最終的打包文件里驶兜。 -->
<resources>
<!-- 這個(gè)元素描述了項(xiàng)目相關(guān)或測(cè)試相關(guān)的所有資源路徑 -->
<resource>
<!-- 描述了資源的目標(biāo)路徑扼仲。該路徑相對(duì)target/classes目錄(例如${project.build.outputDirectory})远寸。
舉個(gè)例子,如果你想資源在特定的包里(org.apache.maven.messages)屠凶,你就必須該元素設(shè)置為
org/apache/maven/messages驰后。然而,如果你只是想把資源放到源碼目錄結(jié)構(gòu)里矗愧,就不需要該配置灶芝。 -->
<targetPath></targetPath>
<!-- 是否使用參數(shù)值代替參數(shù)名。參數(shù)值取自properties元素或者文件里配置的屬性唉韭,文件在filters元素
里列出夜涕。 -->
<filtering></filtering>
<!-- 描述存放資源的目錄,該路徑相對(duì)POM路徑 -->
<directory></directory>
<!-- 包含的模式列表纽哥,例如**/*.xml. -->
<includes>
<include></include>
</includes>
<!-- 排除的模式列表钠乏,例如**/*.xml -->
<excludes>
<exclude></exclude>
</excludes>
</resource>
</resources>
<!-- 這個(gè)元素描述了單元測(cè)試相關(guān)的所有資源路徑,例如和單元測(cè)試相關(guān)的屬性文件春塌。 -->
<testResources>
<!-- 這個(gè)元素描述了測(cè)試相關(guān)的所有資源路徑晓避,參見(jiàn)build/resources/resource元素的說(shuō)明 -->
<testResource>
<!-- 描述了測(cè)試相關(guān)的資源的目標(biāo)路徑。該路徑相對(duì)target/classes目錄(例如${project.build.outputDirectory})只壳。
舉個(gè)例子俏拱,如果你想資源在特定的包里(org.apache.maven.messages),你就必須該元素設(shè)置為
org/apache/maven/messages吼句。然而锅必,如果你只是想把資源放到源碼目錄結(jié)構(gòu)里,就不需要該配置惕艳。 -->
<targetPath></targetPath>
<!-- 是否使用參數(shù)值代替參數(shù)名搞隐。參數(shù)值取自properties元素或者文件里配置的屬性,文件在filters元素
里列出远搪。 -->
<filtering></filtering>
<!-- 描述存放測(cè)試相關(guān)的資源的目錄劣纲,該路徑相對(duì)POM路徑 -->
<directory></directory>
<!-- 包含的模式列表,例如**/*.xml. -->
<includes>
<include></include>
</includes>
<!-- 排除的模式列表谁鳍,例如**/*.xml -->
<excludes>
<exclude></exclude>
</excludes>
</testResource>
</testResources>
<!-- 構(gòu)建產(chǎn)生的所有文件存放的目錄 -->
<directory></directory>
<!-- 產(chǎn)生的構(gòu)件的文件名癞季,默認(rèn)值是${artifactId}-${version}。 -->
<finalName></finalName>
<!-- 當(dāng)filtering開(kāi)關(guān)打開(kāi)時(shí)倘潜,使用到的過(guò)濾器屬性文件列表 -->
<filters></filters>
<!-- 子項(xiàng)目可以引用的默認(rèn)插件信息绷柒。該插件配置項(xiàng)直到被引用時(shí)才會(huì)被解析或綁定到生命周期。給定插件的任何本
地配置都會(huì)覆蓋這里的配置 -->
<pluginManagement>
<!-- 使用的插件列表 涮因。 -->
<plugins>
<!-- plugin元素包含描述插件所需要的信息废睦。 -->
<plugin>
<!-- 插件在倉(cāng)庫(kù)里的group ID -->
<groupId></groupId>
<!-- 插件在倉(cāng)庫(kù)里的artifact ID -->
<artifactId></artifactId>
<!-- 被使用的插件的版本(或版本范圍) -->
<version></version>
<!-- 是否從該插件下載Maven擴(kuò)展(例如打包和類型處理器),由于性能原因蕊退,只有在真需要下載時(shí)郊楣,該
元素才被設(shè)置成enabled憔恳。 -->
<extensions>true/false</extensions>
<!-- 在構(gòu)建生命周期中執(zhí)行一組目標(biāo)的配置。每個(gè)目標(biāo)可能有不同的配置净蚤。 -->
<executions>
<!-- execution元素包含了插件執(zhí)行需要的信息 -->
<execution>
<!-- 執(zhí)行目標(biāo)的標(biāo)識(shí)符钥组,用于標(biāo)識(shí)構(gòu)建過(guò)程中的目標(biāo),或者匹配繼承過(guò)程中需要合并的執(zhí)行目標(biāo) -->
<id></id>
<!-- 綁定了目標(biāo)的構(gòu)建生命周期階段今瀑,如果省略程梦,目標(biāo)會(huì)被綁定到源數(shù)據(jù)里配置的默認(rèn)階段 -->
<phase></phase>
<!-- 配置的執(zhí)行目標(biāo) -->
<goals></goals>
<!-- 配置是否被傳播到子POM -->
<inherited>true/false</inherited>
<!-- 作為DOM對(duì)象的配置 -->
<configuration></configuration>
</execution>
</executions>
<!-- 項(xiàng)目引入插件所需要的額外依賴 -->
<dependencies>
<!-- 參見(jiàn)dependencies/dependency元素 -->
<dependency></dependency>
</dependencies>
<!-- 任何配置是否被傳播到子項(xiàng)目 -->
<inherited>true/false</inherited>
<!-- 作為DOM對(duì)象的配置 -->
<configuration></configuration>
</plugin>
</plugins>
</pluginManagement>
<!-- 該項(xiàng)目使用的插件列表 。 -->
<plugins>
<!-- plugin元素包含描述插件所需要的信息橘荠。 -->
<plugin>
<!-- 插件在倉(cāng)庫(kù)里的group ID -->
<groupId></groupId>
<!-- 插件在倉(cāng)庫(kù)里的artifact ID -->
<artifactId></artifactId>
<!-- 被使用的插件的版本(或版本范圍) -->
<version></version>
<!-- 是否從該插件下載Maven擴(kuò)展(例如打包和類型處理器)屿附,由于性能原因,只有在真需要下載時(shí)哥童,該
元素才被設(shè)置成enabled挺份。 -->
<extensions>true/false</extensions>
<!-- 在構(gòu)建生命周期中執(zhí)行一組目標(biāo)的配置。每個(gè)目標(biāo)可能有不同的配置贮懈。 -->
<executions>
<!-- execution元素包含了插件執(zhí)行需要的信息 -->
<execution>
<!-- 執(zhí)行目標(biāo)的標(biāo)識(shí)符匀泊,用于標(biāo)識(shí)構(gòu)建過(guò)程中的目標(biāo),或者匹配繼承過(guò)程中需要合并的執(zhí)行目標(biāo) -->
<id></id>
<!-- 綁定了目標(biāo)的構(gòu)建生命周期階段朵你,如果省略各聘,目標(biāo)會(huì)被綁定到源數(shù)據(jù)里配置的默認(rèn)階段 -->
<phase></phase>
<!-- 配置的執(zhí)行目標(biāo) -->
<goals></goals>
<!-- 配置是否被傳播到子POM -->
<inherited>true/false</inherited>
<!-- 作為DOM對(duì)象的配置 -->
<configuration></configuration>
</execution>
</executions>
<!-- 項(xiàng)目引入插件所需要的額外依賴 -->
<dependencies>
<!-- 參見(jiàn)dependencies/dependency元素 -->
<dependency></dependency>
</dependencies>
<!-- 任何配置是否被傳播到子項(xiàng)目 -->
<inherited>true/false</inherited>
<!-- 作為DOM對(duì)象的配置 -->
<configuration></configuration>
</plugin>
</plugins>
</build>
<!-- 在列的項(xiàng)目構(gòu)建profile,如果被激活抡医,會(huì)修改構(gòu)建處理 -->
<profiles>
<!-- 根據(jù)環(huán)境參數(shù)或命令行參數(shù)激活某個(gè)構(gòu)建處理 -->
<profile>
<!-- 構(gòu)建配置的唯一標(biāo)識(shí)符躲因。即用于命令行激活,也用于在繼承時(shí)合并具有相同標(biāo)識(shí)符的profile忌傻。 -->
<id></id>
<!-- 自動(dòng)觸發(fā)profile的條件邏輯大脉。Activation是profile的開(kāi)啟鑰匙。profile的力量來(lái)自于它能夠
在某些特定的環(huán)境中自動(dòng)使用某些特定的值水孩;這些環(huán)境通過(guò)activation元素指定箱靴。activation元
素并不是激活profile的唯一方式。 -->
<activation>
<!-- profile默認(rèn)是否激活的標(biāo)志 -->
<activeByDefault>true/false</activeByDefault>
<!-- 當(dāng)匹配的jdk被檢測(cè)到荷愕,profile被激活。例如棍矛,1.4激活JDK1.4安疗,1.4.0_2,而!1.4激活所有版本
不是以1.4開(kāi)頭的JDK够委。 -->
<jdk>jdk版本荐类,如:1.7</jdk>
<!-- 當(dāng)匹配的操作系統(tǒng)屬性被檢測(cè)到,profile被激活茁帽。os元素可以定義一些操作系統(tǒng)相關(guān)的屬性玉罐。 -->
<os>
<!-- 激活profile的操作系統(tǒng)的名字 -->
<name> Windows XP </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檢測(cè)到某一個(gè)屬性(其值可以在POM中通過(guò)${名稱}引用)屈嗤,其擁有對(duì)應(yīng)的名稱和值,Profile
就會(huì)被激活吊输。如果值字段是空的饶号,那么存在屬性名稱字段就會(huì)激活profile,否則按區(qū)分大小寫(xiě)方式匹
配屬性值字段 -->
<property>
<!-- 激活profile的屬性的名稱 -->
<name> mavenVersion </name>
<!-- 激活profile的屬性的值 -->
<value> 2.0.3 </value>
</property>
<!-- 提供一個(gè)文件名季蚂,通過(guò)檢測(cè)該文件的存在或不存在來(lái)激活profile茫船。missing檢查文件是否存在,如果不存在則激活
profile扭屁。另一方面算谈,exists則會(huì)檢查文件是否存在,如果存在則激活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)建項(xiàng)目所需要的信息。參見(jiàn)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>
<!-- 參見(jiàn)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>
<!-- 參見(jiàn)dependencies/dependency元素 -->
<dependency></dependency>
</dependencies>
<goals></goals>
<inherited>true/false</inherited>
<configuration></configuration>
</plugin>
</plugins>
</pluginManagement>
<plugins>
<!-- 參見(jiàn)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>
<!-- 參見(jiàn)dependencies/dependency元素 -->
<dependency></dependency>
</dependencies>
<goals></goals>
<inherited>true/false</inherited>
<configuration></configuration>
</plugin>
</plugins>
</build>
<!-- 模塊(有時(shí)稱作子項(xiàng)目) 被構(gòu)建成項(xiàng)目的一部分礁蔗。列出的每個(gè)模塊元素是指向該模塊的目錄的
相對(duì)路徑 -->
<modules>
<!--子項(xiàng)目相對(duì)路徑-->
<module></module>
</modules>
<!-- 發(fā)現(xiàn)依賴和擴(kuò)展的遠(yuǎn)程倉(cāng)庫(kù)列表觉义。 -->
<repositories>
<!-- 參見(jiàn)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>
<!-- 發(fā)現(xiàn)插件的遠(yuǎn)程倉(cāng)庫(kù)列表,這些插件用于構(gòu)建和報(bào)表 -->
<pluginRepositories>
<!-- 包含需要連接到遠(yuǎn)程插件倉(cāng)庫(kù)的信息.參見(jiàn)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>
<!-- 該元素描述了項(xiàng)目相關(guān)的所有依賴浴井。 這些依賴組成了項(xiàng)目構(gòu)建過(guò)程中的一個(gè)個(gè)環(huán)節(jié)晒骇。它們自動(dòng)從項(xiàng)目定義的
倉(cāng)庫(kù)中下載。要獲取更多信息磺浙,請(qǐng)看項(xiàng)目依賴機(jī)制洪囤。 -->
<dependencies>
<!-- 參見(jiàn)dependencies/dependency元素 -->
<dependency></dependency>
</dependencies>
<!-- 不贊成使用. 現(xiàn)在Maven忽略該元素. -->
<reports></reports>
<!-- 該元素包括使用報(bào)表插件產(chǎn)生報(bào)表的規(guī)范。當(dāng)用戶執(zhí)行“mvn site”撕氧,這些報(bào)表就會(huì)運(yùn)行瘤缩。 在頁(yè)面導(dǎo)航欄能看
到所有報(bào)表的鏈接。參見(jiàn)reporting元素 -->
<reporting></reporting>
<!-- 參見(jiàn)dependencyManagement元素 -->
<dependencyManagement>
<dependencies>
<!-- 參見(jiàn)dependencies/dependency元素 -->
<dependency></dependency>
</dependencies>
</dependencyManagement>
<!-- 參見(jiàn)distributionManagement元素 -->
<distributionManagement></distributionManagement>
<!-- 參見(jiàn)properties元素 -->
<properties /> </profile>
</profiles>
<!-- 模塊(有時(shí)稱作子項(xiàng)目) 被構(gòu)建成項(xiàng)目的一部分伦泥。列出的每個(gè)模塊元素是指向該模塊的目錄的相對(duì)路徑 -->
<modules>
<!--子項(xiàng)目相對(duì)路徑-->
<module></module>
</modules>
<!-- 發(fā)現(xiàn)依賴和擴(kuò)展的遠(yuǎn)程倉(cāng)庫(kù)列表剥啤。 -->
<repositories>
<!-- 包含需要連接到遠(yuǎn)程倉(cāng)庫(kù)的信息 -->
<repository>
<!-- 如何處理遠(yuǎn)程倉(cāng)庫(kù)里發(fā)布版本的下載 -->
<releases>
<!-- true或者false表示該倉(cāng)庫(kù)是否為下載某種類型構(gòu)件(發(fā)布版,快照版)開(kāi)啟不脯。 -->
<enabled></enabled>
<!-- 該元素指定更新發(fā)生的頻率府怯。Maven會(huì)比較本地POM和遠(yuǎn)程POM的時(shí)間戳。這里的選項(xiàng)是:always(一直)防楷,
daily(默認(rèn)牺丙,每日),interval:X(這里X是以分鐘為單位的時(shí)間間隔)复局,或者never(從不)冲簿。 -->
<updatePolicy></updatePolicy>
<!-- 當(dāng)Maven驗(yàn)證構(gòu)件校驗(yàn)文件失敗時(shí)該怎么做:ignore(忽略)粟判,fail(失敗)峦剔,或者warn(警告)档礁。 -->
<checksumPolicy></checksumPolicy>
</releases>
<!-- 如何處理遠(yuǎn)程倉(cāng)庫(kù)里快照版本的下載。有了releases和snapshots這兩組配置羊异,POM就可以在每個(gè)單獨(dú)的倉(cāng)庫(kù)中事秀,
為每種類型的構(gòu)件采取不同的策略。例如野舶,可能有人會(huì)決定只為開(kāi)發(fā)目的開(kāi)啟對(duì)快照版本下載的支持易迹。參見(jiàn)repositories/repository/releases元素 -->
<snapshots>
<enabled></enabled>
<updatePolicy></updatePolicy>
<checksumPolicy></checksumPolicy>
</snapshots>
<!-- 遠(yuǎn)程倉(cāng)庫(kù)唯一標(biāo)識(shí)符∑降溃可以用來(lái)匹配在settings.xml文件里配置的遠(yuǎn)程倉(cāng)庫(kù) -->
<id> banseon-repository-proxy </id>
<!-- 遠(yuǎn)程倉(cāng)庫(kù)名稱 -->
<name> banseon-repository-proxy </name>
<!-- 遠(yuǎn)程倉(cāng)庫(kù)URL睹欲,按protocol://hostname/path形式 -->
<url> http://192.168.1.169:9999/repository/
</url>
<!-- 用于定位和排序構(gòu)件的倉(cāng)庫(kù)布局類型-可以是default(默認(rèn))或者legacy(遺留)。Maven 2為其倉(cāng)庫(kù)提供了一個(gè)默認(rèn)
的布局一屋;然而墩虹,Maven 1.x有一種不同的布局薛窥。我們可以使用該元素指定布局是default(默認(rèn))還是legacy(遺留)。 -->
<layout> default </layout>
</repository>
</repositories>
<!-- 發(fā)現(xiàn)插件的遠(yuǎn)程倉(cāng)庫(kù)列表,這些插件用于構(gòu)建和報(bào)表 -->
<pluginRepositories>
<!-- 包含需要連接到遠(yuǎn)程插件倉(cāng)庫(kù)的信息.參見(jiàn)repositories/repository元素 -->
<pluginRepository></pluginRepository>
</pluginRepositories>
<!-- 該元素描述了項(xiàng)目相關(guān)的所有依賴骤坐。 這些依賴組成了項(xiàng)目構(gòu)建過(guò)程中的一個(gè)個(gè)環(huán)節(jié)妨马。它們自動(dòng)從項(xiàng)目定義的倉(cāng)庫(kù)中下載进每。
要獲取更多信息创橄,請(qǐng)看項(xiàng)目依賴機(jī)制。 -->
<dependencies>
<dependency>
<!-- 依賴的group ID -->
<groupId> org.apache.maven </groupId>
<!-- 依賴的artifact ID -->
<artifactId> maven-artifact </artifactId>
<!-- 依賴的版本號(hào)虫腋。 在Maven 2里, 也可以配置成版本號(hào)的范圍骄酗。 -->
<version> 3.8.1 </version>
<!-- 依賴類型,默認(rèn)類型是jar悦冀。它通常表示依賴的文件的擴(kuò)展名趋翻,但也有例外。一個(gè)類型可以被映射成另外一個(gè)擴(kuò)展
名或分類器盒蟆。類型經(jīng)常和使用的打包方式對(duì)應(yīng)踏烙,盡管這也有例外。一些類型的例子:jar历等,war宙帝,ejb-client和test-jar。
如果設(shè)置extensions為 true募闲,就可以在plugin里定義新的類型。所以前面的類型的例子不完整愿待。 -->
<type> jar </type>
<!-- 依賴的分類器浩螺。分類器可以區(qū)分屬于同一個(gè)POM靴患,但不同構(gòu)建方式的構(gòu)件。分類器名被附加到文件名的版本號(hào)后面要出。例如鸳君,
如果你想要構(gòu)建兩個(gè)單獨(dú)的構(gòu)件成JAR,一個(gè)使用Java 1.4編譯器患蹂,另一個(gè)使用Java 6編譯器或颊,你就可以使用分類器來(lái)生
成兩個(gè)單獨(dú)的JAR構(gòu)件。 -->
<classifier></classifier>
<!-- 依賴范圍传于。在項(xiàng)目發(fā)布過(guò)程中囱挑,幫助決定哪些構(gòu)件被包括進(jìn)來(lái)。欲知詳情請(qǐng)參考依賴機(jī)制沼溜。
- compile :默認(rèn)范圍平挑,用于編譯
- provided:類似于編譯,但支持你期待jdk或者容器提供系草,類似于classpath
- runtime: 在執(zhí)行時(shí)需要使用
- test: 用于test任務(wù)時(shí)使用
- system: 需要外在提供相應(yīng)的元素通熄。通過(guò)systemPath來(lái)取得
- systemPath: 僅用于范圍為system。提供相應(yīng)的路徑
- optional: 當(dāng)項(xiàng)目自身被依賴時(shí)找都,標(biāo)注依賴是否傳遞唇辨。用于連續(xù)依賴時(shí)使用 -->
<scope> test </scope>
<!-- 僅供system范圍使用。注意能耻,不鼓勵(lì)使用這個(gè)元素赏枚,并且在新的版本中該元素可能被覆蓋掉。該元素為依賴規(guī)定了文件
系統(tǒng)上的路徑嚎京。需要絕對(duì)路徑而不是相對(duì)路徑嗡贺。推薦使用屬性匹配絕對(duì)路徑,例如${java.home}鞍帝。 -->
<systemPath></systemPath>
<!-- 當(dāng)計(jì)算傳遞依賴時(shí)诫睬, 從依賴構(gòu)件列表里,列出被排除的依賴構(gòu)件集帕涌。即告訴maven你只依賴指定的項(xiàng)目摄凡,不依賴項(xiàng)目的
依賴。此元素主要用于解決版本沖突問(wèn)題 -->
<exclusions>
<exclusion>
<artifactId> spring-core </artifactId>
<groupId> org.springframework </groupId>
</exclusion>
</exclusions>
<!-- 可選依賴蚓曼,如果你在項(xiàng)目B中把C依賴聲明為可選亲澡,你就需要在依賴于B的項(xiàng)目(例如項(xiàng)目A)中顯式的引用對(duì)C的依賴。
可選依賴阻斷依賴的傳遞性纫版。 -->
<optional> true </optional>
</dependency>
</dependencies>
<!-- 不贊成使用. 現(xiàn)在Maven忽略該元素. -->
<reports></reports>
<!-- 該元素描述使用報(bào)表插件產(chǎn)生報(bào)表的規(guī)范床绪。當(dāng)用戶執(zhí)行“mvn site”,這些報(bào)表就會(huì)運(yùn)行。 在頁(yè)面導(dǎo)航欄能看到所有報(bào)表的鏈接癞己。 -->
<reporting>
<!-- true膀斋,則,網(wǎng)站不包括默認(rèn)的報(bào)表痹雅。這包括“項(xiàng)目信息”菜單中的報(bào)表仰担。 -->
<excludeDefaults />
<!-- 所有產(chǎn)生的報(bào)表存放到哪里。默認(rèn)值是${project.build.directory}/site绩社。 -->
<outputDirectory />
<!-- 使用的報(bào)表插件和他們的配置摔蓝。 -->
<plugins>
<!-- plugin元素包含描述報(bào)表插件需要的信息 -->
<plugin>
<!-- 報(bào)表插件在倉(cāng)庫(kù)里的group ID -->
<groupId></groupId>
<!-- 報(bào)表插件在倉(cāng)庫(kù)里的artifact ID -->
<artifactId></artifactId>
<!-- 被使用的報(bào)表插件的版本(或版本范圍) -->
<version></version>
<!-- 任何配置是否被傳播到子項(xiàng)目 -->
<inherited>true/false</inherited>
<!-- 報(bào)表插件的配置 -->
<configuration></configuration>
<!-- 一組報(bào)表的多重規(guī)范,每個(gè)規(guī)范可能有不同的配置愉耙。一個(gè)規(guī)范(報(bào)表集)對(duì)應(yīng)一個(gè)執(zhí)行目標(biāo) 贮尉。例如,
有1劲阎,2绘盟,3,4悯仙,5龄毡,6,7锡垄,8沦零,9個(gè)報(bào)表。1货岭,2路操,5構(gòu)成A報(bào)表集,對(duì)應(yīng)一個(gè)執(zhí)行目標(biāo)千贯。2屯仗,5,8構(gòu)成B報(bào)
表集搔谴,對(duì)應(yīng)另一個(gè)執(zhí)行目標(biāo) -->
<reportSets>
<!-- 表示報(bào)表的一個(gè)集合魁袜,以及產(chǎn)生該集合的配置 -->
<reportSet>
<!-- 報(bào)表集合的唯一標(biāo)識(shí)符,POM繼承時(shí)用到 -->
<id></id>
<!-- 產(chǎn)生報(bào)表集合時(shí)敦第,被使用的報(bào)表的配置 -->
<configuration></configuration>
<!-- 配置是否被繼承到子POMs -->
<inherited>true/false</inherited>
<!-- 這個(gè)集合里使用到哪些報(bào)表 -->
<reports></reports>
</reportSet>
</reportSets>
</plugin>
</plugins>
</reporting>
<!-- 繼承自該項(xiàng)目的所有子項(xiàng)目的默認(rèn)依賴信息峰弹。這部分的依賴信息不會(huì)被立即解析,而是當(dāng)子項(xiàng)目聲明一個(gè)依賴
(必須描述group ID和artifact ID信息),如果group ID和artifact ID以外的一些信息沒(méi)有描述芜果,則通過(guò)
group ID和artifact ID匹配到這里的依賴鞠呈,并使用這里的依賴信息。 -->
<dependencyManagement>
<dependencies>
<!-- 參見(jiàn)dependencies/dependency元素 -->
<dependency></dependency>
</dependencies>
</dependencyManagement>
<!-- 項(xiàng)目分發(fā)信息右钾,在執(zhí)行mvn deploy后表示要發(fā)布的位置蚁吝。有了這些信息就可以把網(wǎng)站部署到遠(yuǎn)程服務(wù)器或者
把構(gòu)件部署到遠(yuǎn)程倉(cāng)庫(kù)旱爆。 -->
<distributionManagement>
<!-- 部署項(xiàng)目產(chǎn)生的構(gòu)件到遠(yuǎn)程倉(cāng)庫(kù)需要的信息 -->
<repository>
<!-- 是分配給快照一個(gè)唯一的版本號(hào)(由時(shí)間戳和構(gòu)建流水號(hào))?還是每次都使用相同的版本號(hào)灭将?參見(jiàn)
repositories/repository元素 -->
<uniqueVersion />
<id> banseon-maven2 </id>
<name> banseon maven2 </name>
<url> file://${basedir}/target/deploy
</url>
<layout></layout>
</repository>
<!-- 構(gòu)件的快照部署到哪里疼鸟?如果沒(méi)有配置該元素,默認(rèn)部署到repository元素配置的倉(cāng)庫(kù)庙曙,參見(jiàn)
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>
<!-- 部署項(xiàng)目的網(wǎng)站需要的信息 -->
<site>
<!-- 部署位置的唯一標(biāo)識(shí)符,用來(lái)匹配站點(diǎn)和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>
<!-- 項(xiàng)目下載頁(yè)面的URL捌朴。如果沒(méi)有該元素,用戶應(yīng)該參考主頁(yè)张抄。使用該元素的原因是:幫助定位
那些不在倉(cāng)庫(kù)里的構(gòu)件(由于license限制)砂蔽。 -->
<downloadUrl />
<!-- 如果構(gòu)件有了新的group ID和artifact ID(構(gòu)件移到了新的位置),這里列出構(gòu)件的重定位信息署惯。 -->
<relocation>
<!-- 構(gòu)件新的group ID -->
<groupId></groupId>
<!-- 構(gòu)件新的artifact ID -->
<artifactId></artifactId>
<!-- 構(gòu)件新的版本號(hào) -->
<version></version>
<!-- 顯示給用戶的左驾,關(guān)于移動(dòng)的額外信息,例如原因极谊。 -->
<message></message>
</relocation>
<!-- 給出該構(gòu)件在遠(yuǎn)程倉(cāng)庫(kù)的狀態(tài)诡右。不得在本地項(xiàng)目中設(shè)置該元素,因?yàn)檫@是工具自動(dòng)更新的轻猖。有效的值
有:none(默認(rèn))帆吻,converted(倉(cāng)庫(kù)管理員從Maven 1 POM轉(zhuǎn)換過(guò)來(lái)),partner(直接從伙伴Maven
2倉(cāng)庫(kù)同步過(guò)來(lái))咙边,deployed(從Maven 2實(shí)例部署)猜煮,verified(被核實(shí)時(shí)正確的和最終的)。 -->
<status></status>
</distributionManagement>
<!-- 以值替代名稱败许,Properties可以在整個(gè)POM中使用王带,也可以作為觸發(fā)條件(見(jiàn)settings.xml配置文件里
activation元素的說(shuō)明)。格式是<name>value</name>市殷。 -->
<properties>
<name>value</name>
</properties>
</project>
2. 其中的節(jié)點(diǎn)詳情
(1)一般信息節(jié)點(diǎn)
1.1. issueManagement項(xiàng)目問(wèn)題管理系統(tǒng)
<!-- 項(xiàng)目的問(wèn)題管理系統(tǒng)(Bugzilla, Jira, Scarab,或任何你喜歡的問(wèn)題管理系統(tǒng))的名稱和URL愕撰,本例為 jira -->
<issueManagement>
<!-- 問(wèn)題管理系統(tǒng)(例如jira)的名字, -->
<system> jira </system>
<!-- 該項(xiàng)目使用的問(wèn)題管理系統(tǒng)的URL -->
<url> http://jira.baidu.com/banseon </url>
</issueManagement>
1.2 項(xiàng)目持續(xù)集成信息
<!-- 項(xiàng)目持續(xù)集成信息 -->
<ciManagement>
<!-- 持續(xù)集成系統(tǒng)的名字被丧,例如continuum -->
<system></system>
<!-- 該項(xiàng)目使用的持續(xù)集成系統(tǒng)的URL(如果持續(xù)集成系統(tǒng)有web接口的話)盟戏。 -->
<url></url>
<!-- 構(gòu)建完成時(shí),需要通知的開(kāi)發(fā)者/用戶的配置項(xiàng)甥桂。包括被通知者信息和通知條件(錯(cuò)誤柿究,失敗,成功黄选,警告) -->
<notifiers>
<!-- 配置一種方式蝇摸,當(dāng)構(gòu)建中斷時(shí)婶肩,以該方式通知用戶/開(kāi)發(fā)者 -->
<notifier>
<!-- 傳送通知的途徑 -->
<type></type>
<!-- 發(fā)生錯(cuò)誤時(shí)是否通知 -->
<sendOnError></sendOnError>
<!-- 構(gòu)建失敗時(shí)是否通知 -->
<sendOnFailure></sendOnFailure>
<!-- 構(gòu)建成功時(shí)是否通知 -->
<sendOnSuccess></sendOnSuccess>
<!-- 發(fā)生警告時(shí)是否通知 -->
<sendOnWarning></sendOnWarning>
<!-- 不贊成使用。通知發(fā)送到哪里 --><address></address>
<!-- 擴(kuò)展配置項(xiàng) -->
<configuration></configuration>
</notifier>
</notifiers>
</ciManagement>
1.3 mailingLists項(xiàng)目相關(guān)郵件列表信息
<!-- 項(xiàng)目相關(guān)郵件列表信息 -->
<mailingLists>
<!-- 該元素描述了項(xiàng)目相關(guān)的所有郵件列表貌夕。自動(dòng)產(chǎn)生的網(wǎng)站引用這些信息律歼。 -->
<mailingList>
<!-- 郵件的名稱 -->
<name> Demo </name>
<!-- 發(fā)送郵件的地址或鏈接,如果是郵件地址啡专,創(chuàng)建文檔時(shí)险毁,mailto: 鏈接會(huì)被自動(dòng)創(chuàng)建 -->
<post> banseon@126.com </post>
<!-- 訂閱郵件的地址或鏈接,如果是郵件地址们童,創(chuàng)建文檔時(shí)畔况,mailto: 鏈接會(huì)被自動(dòng)創(chuàng)建 -->
<subscribe> banseon@126.com </subscribe>
<!-- 取消訂閱郵件的地址或鏈接,如果是郵件地址慧库,創(chuàng)建文檔時(shí)跷跪,mailto: 鏈接會(huì)被自動(dòng)創(chuàng)建 -->
<unsubscribe> banseon@126.com </unsubscribe>
<!-- 你可以瀏覽郵件信息的URL -->
<archive> http:/hi.baidu.com/banseon/demo/dev/
</archive>
</mailingList>
</mailingLists>
1.4 developers項(xiàng)目開(kāi)發(fā)者列表
<!-- 項(xiàng)目開(kāi)發(fā)者列表 -->
<developers>
<!-- 某個(gè)項(xiàng)目開(kāi)發(fā)者的信息 -->
<developer>
<!-- SCM里項(xiàng)目開(kāi)發(fā)者的唯一標(biāo)識(shí)符 -->
<id> HELLO WORLD </id>
<!-- 項(xiàng)目開(kāi)發(fā)者的全名 -->
<name> banseon </name>
<!-- 項(xiàng)目開(kāi)發(fā)者的email -->
<email> banseon@126.com </email>
<!-- 項(xiàng)目開(kāi)發(fā)者的主頁(yè)的URL -->
<url></url>
<!-- 項(xiàng)目開(kāi)發(fā)者在項(xiàng)目中扮演的角色,角色元素描述了各種角色 -->
<roles>
<role> Project Manager </role>
<role> Architect </role>
</roles>
<!-- 項(xiàng)目開(kāi)發(fā)者所屬組織 -->
<organization> demo </organization>
<!-- 項(xiàng)目開(kāi)發(fā)者所屬組織的URL -->
<organizationUrl> http://hi.baidu.com/xxx </organizationUrl>
<!-- 項(xiàng)目開(kāi)發(fā)者屬性齐板,如即時(shí)消息如何處理等 -->
<properties>
<dept> No </dept>
</properties>
<!-- 項(xiàng)目開(kāi)發(fā)者所在時(shí)區(qū)吵瞻, -11到12范圍內(nèi)的整數(shù)。 -->
<timezone> -5 </timezone>
</developer>
</developers>
1.5 contributors項(xiàng)目的其他貢獻(xiàn)者列表
<!-- 項(xiàng)目的其他貢獻(xiàn)者列表 -->
<contributors>
<!-- 項(xiàng)目的其他貢獻(xiàn)者甘磨。參見(jiàn)developers/developer元素 -->
<contributor>
<!-- 項(xiàng)目貢獻(xiàn)者的全名 -->
<name></name>
<!-- 項(xiàng)目貢獻(xiàn)者的email -->
<email></email>
<!-- 項(xiàng)目貢獻(xiàn)者的主頁(yè)的URL -->
<url></url>
<!-- 項(xiàng)目貢獻(xiàn)者所屬組織 -->
<organization></organization>
<!-- 項(xiàng)目貢獻(xiàn)者所屬組織的URL -->
<organizationUrl></organizationUrl>
<!-- 項(xiàng)目貢獻(xiàn)者在項(xiàng)目中扮演的角色橡羞,角色元素描述了各種角色 -->
<roles>
<role> Project Manager </role>
<role> Architect </role>
</roles>
<!-- 項(xiàng)目貢獻(xiàn)者所在時(shí)區(qū), -11到12范圍內(nèi)的整數(shù)宽档。 -->
<timezone></timezone>
<!-- 項(xiàng)目貢獻(xiàn)者屬性尉姨,如即時(shí)消息如何處理等 -->
<properties>
<dept> No </dept>
</properties>
</contributor>
</contributors>
1.6 licenses許可證列表
<!-- 該元素描述了項(xiàng)目所有License列表。 應(yīng)該只列出該項(xiàng)目的license列表吗冤,不要列出依賴項(xiàng)目的 license列表又厉。
如果列出多個(gè)license,用戶可以選擇它們中的一個(gè)而不是接受所有l(wèi)icense椎瘟。 -->
<licenses>
<!-- 描述了項(xiàng)目的license覆致,用于生成項(xiàng)目的web站點(diǎn)的license頁(yè)面,其他一些報(bào)表和validation也會(huì)用到該元素肺蔚。 -->
<license>
<!-- license用于法律上的名稱 -->
<name> Apache 2 </name>
<!-- 官方的license正文頁(yè)面的URL -->
<url> http://www.baidu.com/banseon/LICENSE-2.0.txt
</url>
<!-- 項(xiàng)目分發(fā)的主要方式:
repo煌妈,可以從Maven庫(kù)下載
manual, 用戶必須手動(dòng)下載和安裝依賴 -->
<distribution> repo </distribution>
<!-- 關(guān)于license的補(bǔ)充信息 -->
<comments> A business-friendly OSS license
</comments>
</license>
</licenses>
1.7 scm和organization
<!-- SCM(Source Control Management)標(biāo)簽允許你配置你的代碼庫(kù)宣羊,供Maven web站點(diǎn)和其它插件使用璧诵。 -->
<scm>
<!-- SCM的URL,該URL描述了版本庫(kù)和如何連接到版本庫(kù)。欲知詳情仇冯,請(qǐng)看SCMs提供的URL格式和列表之宿。該連接只讀。 -->
<connection> scm:svn:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk)
</connection>
<!-- 給開(kāi)發(fā)者使用的苛坚,類似connection元素比被。即該連接不僅僅只讀 -->
<developerConnection> scm:svn:http://svn.baidu.com/banseon/maven/banseon/dao-trunk
</developerConnection>
<!-- 當(dāng)前代碼的標(biāo)簽色难,在開(kāi)發(fā)階段默認(rèn)為HEAD -->
<tag></tag>
<!-- 指向項(xiàng)目的可瀏覽SCM庫(kù)(例如ViewVC或者Fisheye)的URL。 -->
<url> http://svn.baidu.com/banseon </url>
</scm>
<!-- 描述項(xiàng)目所屬組織的各種屬性等缀。Maven產(chǎn)生的文檔用 -->
<organization>
<!-- 組織的全名 -->
<name> demo </name>
<!-- 組織主頁(yè)的URL -->
<url> http://www.baidu.com/banseon </url>
</organization>
(2) 重要的信息
2.1 build 構(gòu)建項(xiàng)目需要的信息
<!-- 構(gòu)建項(xiàng)目需要的信息 -->
<build>
<!-- 該元素設(shè)置了項(xiàng)目源碼目錄枷莉,當(dāng)構(gòu)建項(xiàng)目的時(shí)候,構(gòu)建系統(tǒng)會(huì)編譯目錄里的源碼尺迂。該路徑是相對(duì)
于pom.xml的相對(duì)路徑笤妙。 -->
<sourceDirectory></sourceDirectory>
<!-- 該元素設(shè)置了項(xiàng)目腳本源碼目錄,該目錄和源碼目錄不同:絕大多數(shù)情況下噪裕,該目錄下的內(nèi)容會(huì)
被拷貝到輸出目錄(因?yàn)槟_本是被解釋的危喉,而不是被編譯的)。 -->
<scriptSourceDirectory></scriptSourceDirectory>
<!-- 該元素設(shè)置了項(xiàng)目單元測(cè)試使用的源碼目錄州疾,當(dāng)測(cè)試項(xiàng)目的時(shí)候,構(gòu)建系統(tǒng)會(huì)編譯目錄里的源碼皇拣。
該路徑是相對(duì)于pom.xml的相對(duì)路徑严蓖。 -->
<testSourceDirectory></testSourceDirectory>
<!-- 被編譯過(guò)的應(yīng)用程序class文件存放的目錄。 -->
<outputDirectory></outputDirectory>
<!-- 被編譯過(guò)的測(cè)試class文件存放的目錄氧急。 -->
<testOutputDirectory></testOutputDirectory>
<!-- 使用來(lái)自該項(xiàng)目的一系列構(gòu)建擴(kuò)展 -->
<extensions>
<!-- 描述使用到的構(gòu)建擴(kuò)展颗胡。 -->
<extension>
<!-- 構(gòu)建擴(kuò)展的groupId -->
<groupId></groupId>
<!-- 構(gòu)建擴(kuò)展的artifactId -->
<artifactId></artifactId>
<!-- 構(gòu)建擴(kuò)展的版本 -->
<version></version>
</extension>
</extensions>
<!-- 當(dāng)項(xiàng)目沒(méi)有規(guī)定目標(biāo)(Maven2 叫做階段)時(shí)的默認(rèn)值 -->
<defaultGoal></defaultGoal>
<!-- 這個(gè)元素描述了項(xiàng)目相關(guān)的所有資源路徑列表,例如和項(xiàng)目相關(guān)的屬性文件吩坝,這些資源被包含在
最終的打包文件里毒姨。 -->
<resources>
<!-- 這個(gè)元素描述了項(xiàng)目相關(guān)或測(cè)試相關(guān)的所有資源路徑 -->
<resource>
<!-- 描述了資源的目標(biāo)路徑。該路徑相對(duì)target/classes目錄(例如${project.build.outputDirectory})钉寝。
舉個(gè)例子弧呐,如果你想資源在特定的包里(org.apache.maven.messages),你就必須該元素設(shè)置為
org/apache/maven/messages嵌纲。然而俘枫,如果你只是想把資源放到源碼目錄結(jié)構(gòu)里,就不需要該配置逮走。 -->
<targetPath></targetPath>
<!-- 是否使用參數(shù)值代替參數(shù)名鸠蚪。參數(shù)值取自properties元素或者文件里配置的屬性,文件在filters元素
里列出师溅。 -->
<filtering></filtering>
<!-- 描述存放資源的目錄茅信,該路徑相對(duì)POM路徑 -->
<directory></directory>
<!-- 包含的模式列表,例如**/*.xml. -->
<includes>
<include></include>
</includes>
<!-- 排除的模式列表墓臭,例如**/*.xml -->
<excludes>
<exclude></exclude>
</excludes>
</resource>
</resources>
<!-- 這個(gè)元素描述了單元測(cè)試相關(guān)的所有資源路徑蘸鲸,例如和單元測(cè)試相關(guān)的屬性文件。 -->
<testResources>
<!-- 這個(gè)元素描述了測(cè)試相關(guān)的所有資源路徑起便,參見(jiàn)build/resources/resource元素的說(shuō)明 -->
<testResource>
<!-- 描述了測(cè)試相關(guān)的資源的目標(biāo)路徑棚贾。該路徑相對(duì)target/classes目錄(例如${project.build.outputDirectory})窖维。
舉個(gè)例子,如果你想資源在特定的包里(org.apache.maven.messages)妙痹,你就必須該元素設(shè)置為
org/apache/maven/messages铸史。然而,如果你只是想把資源放到源碼目錄結(jié)構(gòu)里怯伊,就不需要該配置琳轿。 -->
<targetPath></targetPath>
<!-- 是否使用參數(shù)值代替參數(shù)名。參數(shù)值取自properties元素或者文件里配置的屬性耿芹,文件在filters元素
里列出崭篡。 -->
<filtering></filtering>
<!-- 描述存放測(cè)試相關(guān)的資源的目錄,該路徑相對(duì)POM路徑 -->
<directory></directory>
<!-- 包含的模式列表吧秕,例如**/*.xml. -->
<includes>
<include></include>
</includes>
<!-- 排除的模式列表琉闪,例如**/*.xml -->
<excludes>
<exclude></exclude>
</excludes>
</testResource>
</testResources>
<!-- 構(gòu)建產(chǎn)生的所有文件存放的目錄 -->
<directory></directory>
<!-- 產(chǎn)生的構(gòu)件的文件名,默認(rèn)值是${artifactId}-${version}砸彬。 -->
<finalName></finalName>
<!-- 當(dāng)filtering開(kāi)關(guān)打開(kāi)時(shí)颠毙,使用到的過(guò)濾器屬性文件列表 -->
<filters></filters>
<!-- 子項(xiàng)目可以引用的默認(rèn)插件信息。該插件配置項(xiàng)直到被引用時(shí)才會(huì)被解析或綁定到生命周期砂碉。給定插件的任何本
地配置都會(huì)覆蓋這里的配置 -->
<pluginManagement>
<!-- 使用的插件列表 蛀蜜。 -->
<plugins>
<!-- plugin元素包含描述插件所需要的信息。 -->
<plugin>
<!-- 插件在倉(cāng)庫(kù)里的group ID -->
<groupId></groupId>
<!-- 插件在倉(cāng)庫(kù)里的artifact ID -->
<artifactId></artifactId>
<!-- 被使用的插件的版本(或版本范圍) -->
<version></version>
<!-- 是否從該插件下載Maven擴(kuò)展(例如打包和類型處理器)增蹭,由于性能原因滴某,只有在真需要下載時(shí),該
元素才被設(shè)置成enabled滋迈。 -->
<extensions>true/false</extensions>
<!-- 在構(gòu)建生命周期中執(zhí)行一組目標(biāo)的配置霎奢。每個(gè)目標(biāo)可能有不同的配置。 -->
<executions>
<!-- execution元素包含了插件執(zhí)行需要的信息 -->
<execution>
<!-- 執(zhí)行目標(biāo)的標(biāo)識(shí)符杀怠,用于標(biāo)識(shí)構(gòu)建過(guò)程中的目標(biāo)椰憋,或者匹配繼承過(guò)程中需要合并的執(zhí)行目標(biāo) -->
<id></id>
<!-- 綁定了目標(biāo)的構(gòu)建生命周期階段,如果省略赔退,目標(biāo)會(huì)被綁定到源數(shù)據(jù)里配置的默認(rèn)階段 -->
<phase></phase>
<!-- 配置的執(zhí)行目標(biāo) -->
<goals></goals>
<!-- 配置是否被傳播到子POM -->
<inherited>true/false</inherited>
<!-- 作為DOM對(duì)象的配置 -->
<configuration></configuration>
</execution>
</executions>
<!-- 項(xiàng)目引入插件所需要的額外依賴 -->
<dependencies>
<!-- 參見(jiàn)dependencies/dependency元素 -->
<dependency></dependency>
</dependencies>
<!-- 任何配置是否被傳播到子項(xiàng)目 -->
<inherited>true/false</inherited>
<!-- 作為DOM對(duì)象的配置 -->
<configuration></configuration>
</plugin>
</plugins>
</pluginManagement>
<!-- 該項(xiàng)目使用的插件列表 橙依。 -->
<plugins>
<!-- plugin元素包含描述插件所需要的信息。 -->
<plugin>
<!-- 插件在倉(cāng)庫(kù)里的group ID -->
<groupId></groupId>
<!-- 插件在倉(cāng)庫(kù)里的artifact ID -->
<artifactId></artifactId>
<!-- 被使用的插件的版本(或版本范圍) -->
<version></version>
<!-- 是否從該插件下載Maven擴(kuò)展(例如打包和類型處理器)硕旗,由于性能原因窗骑,只有在真需要下載時(shí),該
元素才被設(shè)置成enabled漆枚。 -->
<extensions>true/false</extensions>
<!-- 在構(gòu)建生命周期中執(zhí)行一組目標(biāo)的配置创译。每個(gè)目標(biāo)可能有不同的配置。 -->
<executions>
<!-- execution元素包含了插件執(zhí)行需要的信息 -->
<execution>
<!-- 執(zhí)行目標(biāo)的標(biāo)識(shí)符墙基,用于標(biāo)識(shí)構(gòu)建過(guò)程中的目標(biāo)软族,或者匹配繼承過(guò)程中需要合并的執(zhí)行目標(biāo) -->
<id></id>
<!-- 綁定了目標(biāo)的構(gòu)建生命周期階段刷喜,如果省略,目標(biāo)會(huì)被綁定到源數(shù)據(jù)里配置的默認(rèn)階段 -->
<phase></phase>
<!-- 配置的執(zhí)行目標(biāo) -->
<goals></goals>
<!-- 配置是否被傳播到子POM -->
<inherited>true/false</inherited>
<!-- 作為DOM對(duì)象的配置 -->
<configuration></configuration>
</execution>
</executions>
<!-- 項(xiàng)目引入插件所需要的額外依賴 -->
<dependencies>
<!-- 參見(jiàn)dependencies/dependency元素 -->
<dependency></dependency>
</dependencies>
<!-- 任何配置是否被傳播到子項(xiàng)目 -->
<inherited>true/false</inherited>
<!-- 作為DOM對(duì)象的配置 -->
<configuration></configuration>
</plugin>
</plugins>
</build>
2.2 profiles 構(gòu)建規(guī)則
個(gè)人認(rèn)為可以看作一個(gè)pom中規(guī)則的集合立砸,符合設(shè)定條件則激活掖疮,或者手動(dòng)激活
<!-- 在列的項(xiàng)目構(gòu)建profile,如果被激活颗祝,會(huì)修改構(gòu)建處理 -->
<profiles>
<!-- 根據(jù)環(huán)境參數(shù)或命令行參數(shù)激活某個(gè)構(gòu)建處理 -->
<profile>
<!-- 構(gòu)建配置的唯一標(biāo)識(shí)符浊闪。即用于命令行激活,也用于在繼承時(shí)合并具有相同標(biāo)識(shí)符的profile螺戳。 -->
<id></id>
<!-- 自動(dòng)觸發(fā)profile的條件邏輯搁宾。Activation是profile的開(kāi)啟鑰匙。profile的力量來(lái)自于它能夠
在某些特定的環(huán)境中自動(dòng)使用某些特定的值倔幼;這些環(huán)境通過(guò)activation元素指定盖腿。activation元
素并不是激活profile的唯一方式。 -->
<activation>
<!-- profile默認(rèn)是否激活的標(biāo)志 -->
<activeByDefault>true/false</activeByDefault>
<!-- 當(dāng)匹配的jdk被檢測(cè)到损同,profile被激活奸忽。例如,1.4激活JDK1.4揖庄,1.4.0_2,而!1.4激活所有版本
不是以1.4開(kāi)頭的JDK欠雌。 -->
<jdk>jdk版本蹄梢,如:1.7</jdk>
<!-- 當(dāng)匹配的操作系統(tǒng)屬性被檢測(cè)到,profile被激活富俄。os元素可以定義一些操作系統(tǒng)相關(guān)的屬性禁炒。 -->
<os>
<!-- 激活profile的操作系統(tǒng)的名字 -->
<name> Windows XP </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檢測(cè)到某一個(gè)屬性(其值可以在POM中通過(guò)${名稱}引用),其擁有對(duì)應(yīng)的名稱和值霍比,Profile
就會(huì)被激活幕袱。如果值字段是空的,那么存在屬性名稱字段就會(huì)激活profile悠瞬,否則按區(qū)分大小寫(xiě)方式匹
配屬性值字段 -->
<property>
<!-- 激活profile的屬性的名稱 -->
<name> mavenVersion </name>
<!-- 激活profile的屬性的值 -->
<value> 2.0.3 </value>
</property>
<!-- 提供一個(gè)文件名们豌,通過(guò)檢測(cè)該文件的存在或不存在來(lái)激活profile。missing檢查文件是否存在浅妆,如果不存在則激活
profile望迎。另一方面,exists則會(huì)檢查文件是否存在凌外,如果存在則激活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)建項(xiàng)目所需要的信息。參見(jiàn)build元素 -->
<build>
...
</build>
<!-- 模塊(有時(shí)稱作子項(xiàng)目) 被構(gòu)建成項(xiàng)目的一部分胸墙。列出的每個(gè)模塊元素是指向該模塊的目錄的
相對(duì)路徑 -->
<modules>
<!--子項(xiàng)目相對(duì)路徑-->
<module></module>
</modules>
<!-- 發(fā)現(xiàn)依賴和擴(kuò)展的遠(yuǎn)程倉(cāng)庫(kù)列表我注。 -->
<repositories>
<!-- 參見(jiàn)repositories/repository元素 -->
</repositories>
<!-- 發(fā)現(xiàn)插件的遠(yuǎn)程倉(cāng)庫(kù)列表,這些插件用于構(gòu)建和報(bào)表 -->
<pluginRepositories>
<!-- 包含需要連接到遠(yuǎn)程插件倉(cāng)庫(kù)的信息.參見(jiàn)repositories/repository元素 -->
</pluginRepositories>
<!-- 該元素描述了項(xiàng)目相關(guān)的所有依賴劳秋。 這些依賴組成了項(xiàng)目構(gòu)建過(guò)程中的一個(gè)個(gè)環(huán)節(jié)仓手。它們自動(dòng)從項(xiàng)目定義的倉(cāng)庫(kù)中下載。要獲取更多信息玻淑,請(qǐng)看項(xiàng)目依賴機(jī)制嗽冒。 -->
<dependencies>
<!-- 參見(jiàn)dependencies/dependency元素 -->
<dependency></dependency>
</dependencies>
<!-- 不贊成使用. 現(xiàn)在Maven忽略該元素. -->
<reports></reports>
<!-- 該元素包括使用報(bào)表插件產(chǎn)生報(bào)表的規(guī)范。當(dāng)用戶執(zhí)行“mvn site”补履,這些報(bào)表就會(huì)運(yùn)行添坊。 在頁(yè)面導(dǎo)航欄能看
到所有報(bào)表的鏈接。參見(jiàn)reporting元素 -->
<reporting></reporting>
<!-- 參見(jiàn)dependencyManagement元素 -->
<dependencyManagement>
<dependencies>
<!-- 參見(jiàn)dependencies/dependency元素 -->
<dependency></dependency>
</dependencies>
</dependencyManagement>
<!-- 參見(jiàn)distributionManagement元素 -->
<distributionManagement></distributionManagement>
<!-- 參見(jiàn)properties元素 -->
<properties /> </profile>
</profiles>
2.3 modules模塊:略
2.4 repositories 遠(yuǎn)程倉(cāng)庫(kù)設(shè)置
<!-- 發(fā)現(xiàn)依賴和擴(kuò)展的遠(yuǎn)程倉(cāng)庫(kù)列表箫锤。 -->
<repositories>
<!-- 包含需要連接到遠(yuǎn)程倉(cāng)庫(kù)的信息 -->
<repository>
<!-- 如何處理遠(yuǎn)程倉(cāng)庫(kù)里發(fā)布版本的下載 -->
<releases>
<!-- true或者false表示該倉(cāng)庫(kù)是否為下載某種類型構(gòu)件(發(fā)布版贬蛙,快照版)開(kāi)啟。 -->
<enabled></enabled>
<!-- 該元素指定更新發(fā)生的頻率谚攒。Maven會(huì)比較本地POM和遠(yuǎn)程POM的時(shí)間戳阳准。這里的選項(xiàng)是:always(一直),
daily(默認(rèn)馏臭,每日)野蝇,interval:X(這里X是以分鐘為單位的時(shí)間間隔),或者never(從不)括儒。 -->
<updatePolicy></updatePolicy>
<!-- 當(dāng)Maven驗(yàn)證構(gòu)件校驗(yàn)文件失敗時(shí)該怎么做:ignore(忽略)绕沈,fail(失敗)帮寻,或者warn(警告)乍狐。 -->
<checksumPolicy></checksumPolicy>
</releases>
<!-- 如何處理遠(yuǎn)程倉(cāng)庫(kù)里快照版本的下載。有了releases和snapshots這兩組配置固逗,POM就可以在每個(gè)單獨(dú)的倉(cāng)庫(kù)中浅蚪,
為每種類型的構(gòu)件采取不同的策略。例如烫罩,可能有人會(huì)決定只為開(kāi)發(fā)目的開(kāi)啟對(duì)快照版本下載的支持掘鄙。參見(jiàn)repositories/repository/releases元素 -->
<snapshots>
<enabled></enabled>
<updatePolicy></updatePolicy>
<checksumPolicy></checksumPolicy>
</snapshots>
<!-- 遠(yuǎn)程倉(cāng)庫(kù)唯一標(biāo)識(shí)符∥怂瑁可以用來(lái)匹配在settings.xml文件里配置的遠(yuǎn)程倉(cāng)庫(kù) -->
<id> banseon-repository-proxy </id>
<!-- 遠(yuǎn)程倉(cāng)庫(kù)名稱 -->
<name> banseon-repository-proxy </name>
<!-- 遠(yuǎn)程倉(cāng)庫(kù)URL扶踊,按protocol://hostname/path形式 -->
<url> http://192.168.1.169:9999/repository/
</url>
<!-- 用于定位和排序構(gòu)件的倉(cāng)庫(kù)布局類型-可以是default(默認(rèn))或者legacy(遺留)赃份。Maven 2為其倉(cāng)庫(kù)提供了一個(gè)默認(rèn)
的布局澄耍;然而,Maven 1.x有一種不同的布局撞秋。我們可以使用該元素指定布局是default(默認(rèn))還是legacy(遺留)。 -->
<layout> default </layout>
</repository>
</repositories>
2.5 pluginRepositories插件倉(cāng)庫(kù)
<!-- 發(fā)現(xiàn)插件的遠(yuǎn)程倉(cāng)庫(kù)列表嚣鄙,這些插件用于構(gòu)建和報(bào)表 -->
<pluginRepositories>
<!-- 包含需要連接到遠(yuǎn)程插件倉(cāng)庫(kù)的信息.參見(jiàn)repositories/repository元素 -->
<pluginRepository></pluginRepository>
</pluginRepositories>
2.6 dependencies依賴
<!-- 該元素描述了項(xiàng)目相關(guān)的所有依賴吻贿。 這些依賴組成了項(xiàng)目構(gòu)建過(guò)程中的一個(gè)個(gè)環(huán)節(jié)。它們自動(dòng)從項(xiàng)目定義的倉(cāng)庫(kù)中下載哑子。要獲取更多信息舅列,請(qǐng)看項(xiàng)目依賴機(jī)制。 -->
<dependencies>
<dependency>
<!-- 依賴的group ID -->
<groupId> org.apache.maven </groupId>
<!-- 依賴的artifact ID -->
<artifactId> maven-artifact </artifactId>
<!-- 依賴的版本號(hào)卧蜓。 在Maven 2里, 也可以配置成版本號(hào)的范圍帐要。 -->
<version> 3.8.1 </version>
<!-- 依賴類型,默認(rèn)類型是jar弥奸。它通常表示依賴的文件的擴(kuò)展名榨惠,但也有例外。一個(gè)類型可以被映射成另外一個(gè)擴(kuò)展名或分類器盛霎。類型經(jīng)常和使用的打包方式對(duì)應(yīng)赠橙,盡管這也有例外。一些類型的例子:jar愤炸,war期揪,ejb-client和test-jar。如果設(shè)置extensions為 true规个,就可以在plugin里定義新的類型横侦。所以前面的類型的例子不完整。 -->
<type> jar </type>
<!-- 依賴的分類器绰姻。分類器可以區(qū)分屬于同一個(gè)POM,但不同構(gòu)建方式的構(gòu)件引瀑。分類器名被附加到文件名的版本號(hào)后面狂芋。例如,如果你想要構(gòu)建兩個(gè)單獨(dú)的構(gòu)件成JAR憨栽,一個(gè)使用Java 1.4編譯器帜矾,另一個(gè)使用Java 6編譯器,你就可以使用分類器來(lái)生成兩個(gè)單獨(dú)的JAR構(gòu)件屑柔。 -->
<classifier></classifier>
<!-- 依賴范圍屡萤。在項(xiàng)目發(fā)布過(guò)程中,幫助決定哪些構(gòu)件被包括進(jìn)來(lái)掸宛。欲知詳情請(qǐng)參考依賴機(jī)制死陆。
- compile :默認(rèn)范圍,用于編譯
- provided:類似于編譯,但支持你期待jdk或者容器提供措译,類似于classpath
- runtime: 在執(zhí)行時(shí)需要使用
- test: 用于test任務(wù)時(shí)使用
- system: 需要外在提供相應(yīng)的元素别凤。通過(guò)systemPath來(lái)取得
- systemPath: 僅用于范圍為system。提供相應(yīng)的路徑
- optional: 當(dāng)項(xiàng)目自身被依賴時(shí)领虹,標(biāo)注依賴是否傳遞规哪。用于連續(xù)依賴時(shí)使用 -->
<scope> test </scope>
<!-- 僅供system范圍使用。注意塌衰,不鼓勵(lì)使用這個(gè)元素诉稍,并且在新的版本中該元素可能被覆蓋掉。該元素為依賴規(guī)定了文件系統(tǒng)上的路徑最疆。需要絕對(duì)路徑而不是相對(duì)路徑杯巨。推薦使用屬性匹配絕對(duì)路徑,例如${java.home}肚菠。 -->
<systemPath></systemPath>
<!-- 當(dāng)計(jì)算傳遞依賴時(shí)舔箭, 從依賴構(gòu)件列表里,列出被排除的依賴構(gòu)件集蚊逢。即告訴maven你只依賴指定的項(xiàng)目层扶,不依賴項(xiàng)目的依賴。此元素主要用于解決版本沖突問(wèn)題 -->
<exclusions>
<exclusion>
<artifactId> spring-core </artifactId>
<groupId> org.springframework </groupId>
</exclusion>
</exclusions>
<!-- 可選依賴烙荷,如果你在項(xiàng)目B中把C依賴聲明為可選镜会,你就需要在依賴于B的項(xiàng)目(例如項(xiàng)目A)中顯式的引用對(duì)C的依賴。 可選依賴阻斷依賴的傳遞性终抽。 -->
<optional> true </optional>
</dependency>
</dependencies>
2.7 reporting 報(bào)表產(chǎn)生的規(guī)范
<!-- 該元素描述使用報(bào)表插件產(chǎn)生報(bào)表的規(guī)范戳表。當(dāng)用戶執(zhí)行“mvn site”,這些報(bào)表就會(huì)運(yùn)行昼伴。 在頁(yè)面導(dǎo)航欄能看到所有報(bào)表的鏈接匾旭。 -->
<reporting>
<!-- true,則圃郊,網(wǎng)站不包括默認(rèn)的報(bào)表价涝。這包括“項(xiàng)目信息”菜單中的報(bào)表。 -->
<excludeDefaults />
<!-- 所有產(chǎn)生的報(bào)表存放到哪里持舆。默認(rèn)值是${project.build.directory}/site色瘩。 -->
<outputDirectory />
<!-- 使用的報(bào)表插件和他們的配置。 -->
<plugins>
<!-- plugin元素包含描述報(bào)表插件需要的信息 -->
<plugin>
<!-- 報(bào)表插件在倉(cāng)庫(kù)里的group ID -->
<groupId></groupId>
<!-- 報(bào)表插件在倉(cāng)庫(kù)里的artifact ID -->
<artifactId></artifactId>
<!-- 被使用的報(bào)表插件的版本(或版本范圍) -->
<version></version>
<!-- 任何配置是否被傳播到子項(xiàng)目 -->
<inherited>true/false</inherited>
<!-- 報(bào)表插件的配置 -->
<configuration></configuration>
<!-- 一組報(bào)表的多重規(guī)范逸寓,每個(gè)規(guī)范可能有不同的配置居兆。一個(gè)規(guī)范(報(bào)表集)對(duì)應(yīng)一個(gè)執(zhí)行目標(biāo) 。例如竹伸,有1泥栖,2,3,4聊倔,5晦毙,6,7耙蔑,8见妒,9個(gè)報(bào)表。1甸陌,2须揣,5構(gòu)成A報(bào)表集,對(duì)應(yīng)一個(gè)執(zhí)行目標(biāo)钱豁。2耻卡,5,8構(gòu)成B報(bào)表集牲尺,對(duì)應(yīng)另一個(gè)執(zhí)行目標(biāo) -->
<reportSets>
<!-- 表示報(bào)表的一個(gè)集合卵酪,以及產(chǎn)生該集合的配置 -->
<reportSet>
<!-- 報(bào)表集合的唯一標(biāo)識(shí)符,POM繼承時(shí)用到 -->
<id></id>
<!-- 產(chǎn)生報(bào)表集合時(shí)谤碳,被使用的報(bào)表的配置 -->
<configuration></configuration>
<!-- 配置是否被繼承到子POMs -->
<inherited>true/false</inherited>
<!-- 這個(gè)集合里使用到哪些報(bào)表 -->
<reports></reports>
</reportSet>
</reportSets>
</plugin>
</plugins>
</reporting>
2.8 dependencyManagement依賴管理
<!-- 繼承自該項(xiàng)目的所有子項(xiàng)目的默認(rèn)依賴信息溃卡。這部分的依賴信息不會(huì)被立即解析,而是當(dāng)子項(xiàng)目聲明一個(gè)依賴(必須描述group ID和artifact ID信息),如果group ID和artifact ID以外的一些信息沒(méi)有描述蜒简,則通過(guò)group ID和artifact ID匹配到這里的依賴瘸羡,并使用這里的依賴信息。 -->
<dependencyManagement>
<dependencies>
<!-- 參見(jiàn)dependencies/dependency元素 -->
<dependency></dependency>
</dependencies>
</dependencyManagement>
2.9 distributionManagement項(xiàng)目分發(fā)信息
<!-- 項(xiàng)目分發(fā)信息搓茬,在執(zhí)行mvn deploy后表示要發(fā)布的位置犹赖。有了這些信息就可以把網(wǎng)站部署到遠(yuǎn)程服務(wù)器或者
把構(gòu)件部署到遠(yuǎn)程倉(cāng)庫(kù)。 -->
<distributionManagement>
<!-- 部署項(xiàng)目產(chǎn)生的構(gòu)件到遠(yuǎn)程倉(cāng)庫(kù)需要的信息 -->
<repository>
<!-- 是分配給快照一個(gè)唯一的版本號(hào)(由時(shí)間戳和構(gòu)建流水號(hào))卷仑?還是每次都使用相同的版本號(hào)峻村?參見(jiàn)
repositories/repository元素 -->
<uniqueVersion />
<id> banseon-maven2 </id>
<name> banseon maven2 </name>
<url> file://${basedir}/target/deploy
</url>
<layout></layout>
</repository>
<!-- 構(gòu)件的快照部署到哪里?如果沒(méi)有配置該元素锡凝,默認(rèn)部署到repository元素配置的倉(cāng)庫(kù)粘昨,參見(jiàn)
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>
<!-- 部署項(xiàng)目的網(wǎng)站需要的信息 -->
<site>
<!-- 部署位置的唯一標(biāo)識(shí)符,用來(lái)匹配站點(diǎn)和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>
<!-- 項(xiàng)目下載頁(yè)面的URL。如果沒(méi)有該元素膊夹,用戶應(yīng)該參考主頁(yè)衬浑。使用該元素的原因是:幫助定位
那些不在倉(cāng)庫(kù)里的構(gòu)件(由于license限制)。 -->
<downloadUrl />
<!-- 如果構(gòu)件有了新的group ID和artifact ID(構(gòu)件移到了新的位置)放刨,這里列出構(gòu)件的重定位信息工秩。 -->
<relocation>
<!-- 構(gòu)件新的group ID -->
<groupId></groupId>
<!-- 構(gòu)件新的artifact ID -->
<artifactId></artifactId>
<!-- 構(gòu)件新的版本號(hào) -->
<version></version>
<!-- 顯示給用戶的,關(guān)于移動(dòng)的額外信息,例如原因助币。 -->
<message></message>
</relocation>
<!-- 給出該構(gòu)件在遠(yuǎn)程倉(cāng)庫(kù)的狀態(tài)浪听。不得在本地項(xiàng)目中設(shè)置該元素,因?yàn)檫@是工具自動(dòng)更新的眉菱。有效的值
有:none(默認(rèn))迹栓,converted(倉(cāng)庫(kù)管理員從Maven 1 POM轉(zhuǎn)換過(guò)來(lái)),partner(直接從伙伴Maven
2倉(cāng)庫(kù)同步過(guò)來(lái))俭缓,deployed(從Maven 2實(shí)例部署)克伊,verified(被核實(shí)時(shí)正確的和最終的)。 -->
<status></status>
</distributionManagement>
2.10 properties配置參數(shù)
<!-- 以值替代名稱华坦,Properties可以在整個(gè)POM中使用愿吹,也可以作為觸發(fā)條件(見(jiàn)settings.xml配置文件里
activation元素的說(shuō)明)。格式是<name>value</name>惜姐。 -->
<properties>
<name>value</name>
</propies>