POM( Project Object Model党觅,項(xiàng)目對(duì)象模型 ) 是 Maven 工程的基本工作單元棍弄,是一個(gè)XML文件伐弹,包含了項(xiàng)目的基本信息披摄,用于描述項(xiàng)目如何構(gòu)建馆铁,聲明項(xiàng)目依賴跑揉,等等。
執(zhí)行任務(wù)或目標(biāo)時(shí)埠巨,Maven 會(huì)在當(dāng)前目錄中查找 POM历谍。它讀取 POM,獲取所需的配置信息辣垒,然后執(zhí)行目標(biāo)望侈。
POM 中可以指定以下配置:
項(xiàng)目依賴
插件
執(zhí)行目標(biāo)
項(xiàng)目構(gòu)建 profile
項(xiàng)目版本
項(xiàng)目開發(fā)者列表
相關(guān)郵件列表信息
<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)目中沒有規(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 />
<!-- 被繼承的父項(xiàng)目的全球唯一標(biāo)識(shí)符 -->
<groupId />
<!-- 被繼承的父項(xiàng)目的版本 -->
<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位置),然后在本地倉庫仪召,最后在遠(yuǎn)程倉庫尋找父項(xiàng)目的pom寨蹋。 -->
<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> asia.banseon </groupId>
<!-- 構(gòu)件的標(biāo)識(shí)符檀咙,它和group ID一起唯一標(biāo)識(shí)一個(gè)構(gòu)件。換句話說璃诀,你不能有兩個(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> banseon-maven2 </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> banseon-maven </name>
<!-- 項(xiàng)目主頁的URL, Maven產(chǎn)生的文檔用 -->
<url> http://www.baidu.com/banseon </url>
<!-- 項(xiàng)目的詳細(xì)描述, Maven 產(chǎn)生的文檔用弛作。 當(dāng)這個(gè)元素能夠用HTML格式描述時(shí)(例如涕蜂,CDATA中的文本會(huì)被解析器忽略,就可以包含HTML標(biāo)簽)映琳, 不鼓勵(lì)使用純文本描述机隙。如果你需要修改產(chǎn)生的web站點(diǎn)的索引頁面,你應(yīng)該修改你自己的索引頁文件萨西,而不是調(diào)整這里的文檔有鹿。 -->
<description> A maven project to study maven. </description>
<!-- 描述了這個(gè)項(xiàng)目構(gòu)建環(huán)境中的前提條件。 -->
<prerequisites>
<!-- 構(gòu)建該項(xiàng)目或使用該插件所需要的Maven的最低版本 -->
<maven />
</prerequisites>
<!-- 項(xiàng)目的問題管理系統(tǒng)(Bugzilla, Jira, Scarab,或任何你喜歡的問題管理系統(tǒng))的名稱和URL谎脯,本例為 jira -->
<issueManagement>
<!-- 問題管理系統(tǒng)(例如jira)的名字葱跋, -->
<system> jira </system>
<!-- 該項(xiàng)目使用的問題管理系統(tǒng)的URL -->
<url> http://jira.baidu.com/banseon </url>
</issueManagement>
<!-- 項(xiàng)目持續(xù)集成信息 -->
<ciManagement>
<!-- 持續(xù)集成系統(tǒng)的名字,例如continuum -->
<system />
<!-- 該項(xiàng)目使用的持續(xù)集成系統(tǒng)的URL(如果持續(xù)集成系統(tǒng)有web接口的話)。 -->
<url />
<!-- 構(gòu)建完成時(shí)娱俺,需要通知的開發(fā)者/用戶的配置項(xiàng)稍味。包括被通知者信息和通知條件(錯(cuò)誤,失敗荠卷,成功模庐,警告) -->
<notifiers>
<!-- 配置一種方式,當(dāng)構(gòu)建中斷時(shí)油宜,以該方式通知用戶/開發(fā)者 -->
<notifier>
<!-- 傳送通知的途徑 -->
<type />
<!-- 發(fā)生錯(cuò)誤時(shí)是否通知 -->
<sendOnError />
<!-- 構(gòu)建失敗時(shí)是否通知 -->
<sendOnFailure />
<!-- 構(gòu)建成功時(shí)是否通知 -->
<sendOnSuccess />
<!-- 發(fā)生警告時(shí)是否通知 -->
<sendOnWarning />
<!-- 不贊成使用掂碱。通知發(fā)送到哪里 -->
<address />
<!-- 擴(kuò)展配置項(xiàng) -->
<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)目開發(fā)者列表 -->
<developers>
<!-- 某個(gè)項(xiàng)目開發(fā)者的信息 -->
<developer>
<!-- SCM里項(xiàng)目開發(fā)者的唯一標(biāo)識(shí)符 -->
<id> HELLO WORLD </id>
<!-- 項(xiàng)目開發(fā)者的全名 -->
<name> banseon </name>
<!-- 項(xiàng)目開發(fā)者的email -->
<email> banseon@126.com </email>
<!-- 項(xiàng)目開發(fā)者的主頁的URL -->
<url />
<!-- 項(xiàng)目開發(fā)者在項(xiàng)目中扮演的角色,角色元素描述了各種角色 -->
<roles>
<role> Project Manager </role>
<role> Architect </role>
</roles>
<!-- 項(xiàng)目開發(fā)者所屬組織 -->
<organization> demo </organization>
<!-- 項(xiàng)目開發(fā)者所屬組織的URL -->
<organizationUrl> http://hi.baidu.com/banseon </organizationUrl>
<!-- 項(xiàng)目開發(fā)者屬性迈喉,如即時(shí)消息如何處理等 -->
<properties>
<dept> No </dept>
</properties>
<!-- 項(xiàng)目開發(fā)者所在時(shí)區(qū)绍刮, -11到12范圍內(nèi)的整數(shù)。 -->
<timezone> -5 </timezone>
</developer>
</developers>
<!-- 項(xiàng)目的其他貢獻(xiàn)者列表 -->
<contributors>
<!-- 項(xiàng)目的其他貢獻(xiàn)者挨摸。參見developers/developer元素 -->
<contributor>
<name />
<email />
<url />
<organization />
<organizationUrl />
<roles />
<timezone />
<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頁面饱搏,其他一些報(bào)表和validation也會(huì)用到該元素。 -->
<license>
<!-- license用于法律上的名稱 -->
<name> Apache 2 </name>
<!-- 官方的license正文頁面的URL -->
<url> http://www.baidu.com/banseon/LICENSE-2.0.txt </url>
<!-- 項(xiàng)目分發(fā)的主要方式:
repo置逻,可以從Maven庫下載
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)簽允許你配置你的代碼庫,供Maven web站點(diǎn)和其它插件使用。 -->
<scm>
<!-- SCM的URL,該URL描述了版本庫和如何連接到版本庫鬓催。欲知詳情肺素,請(qǐng)看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 />
<!-- 指向項(xiàng)目的可瀏覽SCM庫(例如ViewVC或者Fisheye)的URL菌瘫。 -->
<url> http://svn.baidu.com/banseon </url>
</scm>
<!-- 描述項(xiàng)目所屬組織的各種屬性。Maven產(chǎn)生的文檔用 -->
<organization>
<!-- 組織的全名 -->
<name> demo </name>
<!-- 組織主頁的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 />
<!-- 該元素設(shè)置了項(xiàng)目腳本源碼目錄栖忠,該目錄和源碼目錄不同:絕大多數(shù)情況下,該目錄下的內(nèi)容 會(huì)被拷貝到輸出目錄(因?yàn)槟_本是被解釋的贸街,而不是被編譯的)庵寞。 -->
<scriptSourceDirectory />
<!-- 該元素設(shè)置了項(xiàng)目單元測試使用的源碼目錄,當(dāng)測試項(xiàng)目的時(shí)候薛匪,構(gòu)建系統(tǒng)會(huì)編譯目錄里的源碼捐川。該路徑是相對(duì)于pom.xml的相對(duì)路徑。 -->
<testSourceDirectory />
<!-- 被編譯過的應(yīng)用程序class文件存放的目錄逸尖。 -->
<outputDirectory />
<!-- 被編譯過的測試class文件存放的目錄古沥。 -->
<testOutputDirectory />
<!-- 使用來自該項(xiàng)目的一系列構(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)項(xiàng)目沒有規(guī)定目標(biāo)(Maven2 叫做階段)時(shí)的默認(rèn)值 -->
<defaultGoal />
<!-- 這個(gè)元素描述了項(xiàng)目相關(guān)的所有資源路徑列表娇跟,例如和項(xiàng)目相關(guān)的屬性文件岩齿,這些資源被包含在最終的打包文件里。 -->
<resources>
<!-- 這個(gè)元素描述了項(xiàng)目相關(guān)或測試相關(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 />
<!-- 是否使用參數(shù)值代替參數(shù)名。參數(shù)值取自properties元素或者文件里配置的屬性澜驮,文件在filters元素里列出陷揪。 -->
<filtering />
<!-- 描述存放資源的目錄,該路徑相對(duì)POM路徑 -->
<directory />
<!-- 包含的模式列表,例如**/*.xml. -->
<includes />
<!-- 排除的模式列表悍缠,例如**/*.xml -->
<excludes />
</resource>
</resources>
<!-- 這個(gè)元素描述了單元測試相關(guān)的所有資源路徑卦绣,例如和單元測試相關(guān)的屬性文件。 -->
<testResources>
<!-- 這個(gè)元素描述了測試相關(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)打開時(shí)趴拧,使用到的過濾器屬性文件列表 -->
<filters />
<!-- 子項(xiàng)目可以引用的默認(rèn)插件信息溅漾。該插件配置項(xiàng)直到被引用時(shí)才會(huì)被解析或綁定到生命周期。給定插件的任何本地配置都會(huì)覆蓋這里的配置 -->
<pluginManagement>
<!-- 使用的插件列表 著榴。 -->
<plugins>
<!-- plugin元素包含描述插件所需要的信息添履。 -->
<plugin>
<!-- 插件在倉庫里的group ID -->
<groupId />
<!-- 插件在倉庫里的artifact ID -->
<artifactId />
<!-- 被使用的插件的版本(或版本范圍) -->
<version />
<!-- 是否從該插件下載Maven擴(kuò)展(例如打包和類型處理器),由于性能原因脑又,只有在真需要下載時(shí)暮胧,該元素才被設(shè)置成enabled。 -->
<extensions />
<!-- 在構(gòu)建生命周期中執(zhí)行一組目標(biāo)的配置问麸。每個(gè)目標(biāo)可能有不同的配置往衷。 -->
<executions>
<!-- execution元素包含了插件執(zhí)行需要的信息 -->
<execution>
<!-- 執(zhí)行目標(biāo)的標(biāo)識(shí)符,用于標(biāo)識(shí)構(gòu)建過程中的目標(biāo)严卖,或者匹配繼承過程中需要合并的執(zhí)行目標(biāo) -->
<id />
<!-- 綁定了目標(biāo)的構(gòu)建生命周期階段席舍,如果省略,目標(biāo)會(huì)被綁定到源數(shù)據(jù)里配置的默認(rèn)階段 -->
<phase />
<!-- 配置的執(zhí)行目標(biāo) -->
<goals />
<!-- 配置是否被傳播到子POM -->
<inherited />
<!-- 作為DOM對(duì)象的配置 -->
<configuration />
</execution>
</executions>
<!-- 項(xiàng)目引入插件所需要的額外依賴 -->
<dependencies>
<!-- 參見dependencies/dependency元素 -->
<dependency></dependency>
</dependencies>
<!-- 任何配置是否被傳播到子項(xiàng)目 -->
<inherited />
<!-- 作為DOM對(duì)象的配置 -->
<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>
<!-- 在列的項(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 />
<!-- 自動(dòng)觸發(fā)profile的條件邏輯东且。Activation是profile的開啟鑰匙启具。profile的力量來自于它
能夠在某些特定的環(huán)境中自動(dòng)使用某些特定的值;這些環(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> 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檢測到某一個(gè)屬性(其值可以在POM中通過${名稱}引用)帝嗡,其擁有對(duì)應(yīng)的名稱和值,Profile就會(huì)被激活璃氢。如果值
字段是空的哟玷,那么存在屬性名稱字段就會(huì)激活profile,否則按區(qū)分大小寫方式匹配屬性值字段 -->
<property>
<!-- 激活profile的屬性的名稱 -->
<name> mavenVersion </name>
<!-- 激活profile的屬性的值 -->
<value> 2.0.3 </value>
</property>
<!-- 提供一個(gè)文件名一也,通過檢測該文件的存在或不存在來激活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)目所需要的信息。參見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>
<!-- 模塊(有時(shí)稱作子項(xiàng)目) 被構(gòu)建成項(xiàng)目的一部分京痢。列出的每個(gè)模塊元素是指向該模塊的目錄的相對(duì)路徑 -->
<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)建和報(bào)表 -->
<pluginRepositories>
<!-- 包含需要連接到遠(yuǎn)程插件倉庫的信息.參見repositories/repository元素 -->
<pluginRepository>
<releases>
<enabled />
<updatePolicy />
<checksumPolicy />
</releases>
<snapshots>
<enabled />
<updatePolicy />
<checksumPolicy />
</snapshots>
<id />
<name />
<url />
<layout />
</pluginRepository>
</pluginRepositories>
<!-- 該元素描述了項(xiàng)目相關(guān)的所有依賴祭椰。 這些依賴組成了項(xiàng)目構(gòu)建過程中的一個(gè)個(gè)環(huán)節(jié)臭家。它們自動(dòng)從項(xiàng)目定義的倉庫中下載。要獲取更多信息方淤,請(qǐng)看項(xiàng)目依賴機(jī)制钉赁。 -->
<dependencies>
<!-- 參見dependencies/dependency元素 -->
<dependency></dependency>
</dependencies>
<!-- 不贊成使用. 現(xiàn)在Maven忽略該元素. -->
<reports />
<!-- 該元素包括使用報(bào)表插件產(chǎn)生報(bào)表的規(guī)范。當(dāng)用戶執(zhí)行“mvn site”携茂,這些報(bào)表就會(huì)運(yùn)行你踩。 在頁面導(dǎo)航欄能看到所有報(bào)表的鏈接。參見reporting元素 -->
<reporting></reporting>
<!-- 參見dependencyManagement元素 -->
<dependencyManagement>
<dependencies>
<!-- 參見dependencies/dependency元素 -->
<dependency></dependency>
</dependencies>
</dependencyManagement>
<!-- 參見distributionManagement元素 -->
<distributionManagement></distributionManagement>
<!-- 參見properties元素 -->
<properties />
</profile>
</profiles>
<!-- 模塊(有時(shí)稱作子項(xiàng)目) 被構(gòu)建成項(xiàng)目的一部分讳苦。列出的每個(gè)模塊元素是指向該模塊的目錄的相對(duì)路徑 -->
<modules />
<!-- 發(fā)現(xiàn)依賴和擴(kuò)展的遠(yuǎn)程倉庫列表带膜。 -->
<repositories>
<!-- 包含需要連接到遠(yuǎn)程倉庫的信息 -->
<repository>
<!-- 如何處理遠(yuǎn)程倉庫里發(fā)布版本的下載 -->
<releases>
<!-- true或者false表示該倉庫是否為下載某種類型構(gòu)件(發(fā)布版,快照版)開啟鸳谜。 -->
<enabled />
<!-- 該元素指定更新發(fā)生的頻率膝藕。Maven會(huì)比較本地POM和遠(yuǎn)程POM的時(shí)間戳。這里的選項(xiàng)是:always(一直)咐扭,daily(默認(rèn)芭挽,每日)滑废,interval:X(這里X是以分鐘為單位的時(shí)間間隔),或者never(從不)览绿。 -->
<updatePolicy />
<!-- 當(dāng)Maven驗(yàn)證構(gòu)件校驗(yàn)文件失敗時(shí)該怎么做:ignore(忽略)策严,fail(失敗)饿敲,或者warn(警告)妻导。 -->
<checksumPolicy />
</releases>
<!-- 如何處理遠(yuǎn)程倉庫里快照版本的下載。有了releases和snapshots這兩組配置怀各,POM就可以在每個(gè)單獨(dú)的倉庫中倔韭,為每種類型的構(gòu)件采取不同的策略。例如瓢对,可能有人會(huì)決定只為開發(fā)目的開啟對(duì)快照版本下載的支持寿酌。參見repositories/repository/releases元素 -->
<snapshots>
<enabled />
<updatePolicy />
<checksumPolicy />
</snapshots>
<!-- 遠(yuǎn)程倉庫唯一標(biāo)識(shí)符∷队迹可以用來匹配在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為其倉庫提供了一個(gè)默認(rèn)的布局法焰;然而秧荆,Maven 1.x有一種不同的布局。我們可以使用該元素指定布局是default(默認(rèn))還是legacy(遺留)埃仪。 -->
<layout> default </layout>
</repository>
</repositories>
<!-- 發(fā)現(xiàn)插件的遠(yuǎn)程倉庫列表乙濒,這些插件用于構(gòu)建和報(bào)表 -->
<pluginRepositories>
<!-- 包含需要連接到遠(yuǎn)程插件倉庫的信息.參見repositories/repository元素 -->
<pluginRepository></pluginRepository>
</pluginRepositories>
<!-- 該元素描述了項(xiàng)目相關(guān)的所有依賴。 這些依賴組成了項(xiàng)目構(gòu)建過程中的一個(gè)個(gè)環(huán)節(jié)卵蛉。它們自動(dòng)從項(xiàng)目定義的倉庫中下載颁股。要獲取更多信息,請(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編譯器,你就可以使用分類器來生成兩個(gè)單獨(dú)的JAR構(gòu)件扬卷。 -->
<classifier></classifier>
<!-- 依賴范圍牙言。在項(xiàng)目發(fā)布過程中,幫助決定哪些構(gòu)件被包括進(jìn)來怪得。欲知詳情請(qǐng)參考依賴機(jī)制咱枉。
- compile :默認(rèn)范圍,用于編譯
- provided:類似于編譯徒恋,但支持你期待jdk或者容器提供蚕断,類似于classpath
- runtime: 在執(zhí)行時(shí)需要使用
- test: 用于test任務(wù)時(shí)使用
- system: 需要外在提供相應(yīng)的元素。通過systemPath來取得
- 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)目的依賴指黎。此元素主要用于解決版本沖突問題 -->
<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)行所计。 在頁面導(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)表插件在倉庫里的group ID -->
<groupId />
<!-- 報(bào)表插件在倉庫里的artifact ID -->
<artifactId />
<!-- 被使用的報(bào)表插件的版本(或版本范圍) -->
<version />
<!-- 任何配置是否被傳播到子項(xiàng)目 -->
<inherited />
<!-- 報(bào)表插件的配置 -->
<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 />
<!-- 產(chǎn)生報(bào)表集合時(shí),被使用的報(bào)表的配置 -->
<configuration />
<!-- 配置是否被繼承到子POMs -->
<inherited />
<!-- 這個(gè)集合里使用到哪些報(bào)表 -->
<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以外的一些信息沒有描述,則通過group ID和artifact ID匹配到這里的依賴透典,并使用這里的依賴信息晴楔。 -->
<dependencyManagement>
<dependencies>
<!-- 參見dependencies/dependency元素 -->
<dependency></dependency>
</dependencies>
</dependencyManagement>
<!-- 項(xiàng)目分發(fā)信息,在執(zhí)行mvn deploy后表示要發(fā)布的位置峭咒。有了這些信息就可以把網(wǎng)站部署到遠(yuǎn)程服務(wù)器或者把構(gòu)件部署到遠(yuǎn)程倉庫税弃。 -->
<distributionManagement>
<!-- 部署項(xiàng)目產(chǎn)生的構(gòu)件到遠(yuǎn)程倉庫需要的信息 -->
<repository>
<!-- 是分配給快照一個(gè)唯一的版本號(hào)(由時(shí)間戳和構(gòu)建流水號(hào))?還是每次都使用相同的版本號(hào)凑队?參見repositories/repository元素 -->
<uniqueVersion />
<id> banseon-maven2 </id>
<name> banseon maven2 </name>
<url> file://${basedir}/target/deploy </url>
<layout />
</repository>
<!-- 構(gòu)件的快照部署到哪里则果?如果沒有配置該元素,默認(rèn)部署到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 />
</snapshotRepository>
<!-- 部署項(xiàng)目的網(wǎng)站需要的信息 -->
<site>
<!-- 部署位置的唯一標(biāo)識(shí)符西壮,用來匹配站點(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)目下載頁面的URL叫惊。如果沒有該元素款青,用戶應(yīng)該參考主頁。使用該元素的原因是:幫助定位那些不在倉庫里的構(gòu)件(由于license限制)霍狰。 -->
<downloadUrl />
<!-- 如果構(gòu)件有了新的group ID和artifact ID(構(gòu)件移到了新的位置)抡草,這里列出構(gòu)件的重定位信息。 -->
<relocation>
<!-- 構(gòu)件新的group ID -->
<groupId />
<!-- 構(gòu)件新的artifact ID -->
<artifactId />
<!-- 構(gòu)件新的版本號(hào) -->
<version />
<!-- 顯示給用戶的蔗坯,關(guān)于移動(dòng)的額外信息康震,例如原因。 -->
<message />
</relocation>
<!-- 給出該構(gòu)件在遠(yuǎn)程倉庫的狀態(tài)宾濒。不得在本地項(xiàng)目中設(shè)置該元素腿短,因?yàn)檫@是工具自動(dòng)更新的。有效的值有:none(默認(rèn))绘梦,converted(倉庫管理員從Maven 1 POM轉(zhuǎn)換過來)橘忱,partner(直接從伙伴Maven 2倉庫同步過來),deployed(從Maven 2實(shí)例部署)谚咬,verified(被核實(shí)時(shí)正確的和最終的)鹦付。 -->
<status />
</distributionManagement>
<!-- 以值替代名稱,Properties可以在整個(gè)POM中使用择卦,也可以作為觸發(fā)條件(見settings.xml配置文件里activation元素的說明)敲长。格式是<name>value</name>。 -->
<properties />
</project>