轉(zhuǎn)自:http://blog.csdn.net/ithomer/article/details/9332071
?
什么是pom?
??? pom作為項(xiàng)目對(duì)象模型。通過(guò)xml表示maven項(xiàng)目,使用pom.xml來(lái)實(shí)現(xiàn)。主要描述了項(xiàng)目:包括配置文件;開(kāi)發(fā)者需要遵循的規(guī)則,缺陷管理系統(tǒng),組織和licenses,項(xiàng)目的url,項(xiàng)目的依賴性,以及其他所有的項(xiàng)目相關(guān)因素。
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.0http://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 /> <!-- 被繼承的父項(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位置),然后在本地倉(cāng)庫(kù),最后在遠(yuǎn)程倉(cāng)庫(kù)尋找父項(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)件。換句話說(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 > 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)目主頁(yè)的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è)面,你應(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 /> </ 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 /> <!-- 該項(xiàng)目使用的持續(xù)集成系統(tǒng)的URL(如果持續(xù)集成系統(tǒng)有web接口的話)。 --> < url /> <!-- 構(gòu)建完成時(shí),需要通知的開(kāi)發(fā)者/用戶的配置項(xiàng)。包括被通知者信息和通知條件(錯(cuò)誤,失敗,成功,警告) --> < notifiers > <!-- 配置一種方式,當(dāng)構(gòu)建中斷時(shí),以該方式通知用戶/開(kāi)發(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)目開(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 /> <!-- 項(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/banseon </ 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 > < 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頁(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 /> <!-- 指向項(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 /> <!-- 該元素設(shè)置了項(xiàng)目腳本源碼目錄,該目錄和源碼目錄不同:絕大多數(shù)情況下,該目錄下的內(nèi)容 會(huì)被拷貝到輸出目錄(因?yàn)槟_本是被解釋的,而不是被編譯的)。 --> < scriptSourceDirectory /> <!-- 該元素設(shè)置了項(xiàng)目單元測(cè)試使用的源碼目錄,當(dāng)測(cè)試項(xiàng)目的時(shí)候,構(gòu)建系統(tǒng)會(huì)編譯目錄里的源碼。該路徑是相對(duì)于pom.xml的相對(duì)路徑。 --> < testSourceDirectory /> <!-- 被編譯過(guò)的應(yīng)用程序class文件存放的目錄。 --> < outputDirectory /> <!-- 被編譯過(guò)的測(cè)試class文件存放的目錄。 --> < testOutputDirectory /> <!-- 使用來(lái)自該項(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)目沒(méi)有規(guī)定目標(biāo)(Maven2 叫做階段)時(shí)的默認(rèn)值 --> < 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 /> <!-- 是否使用參數(shù)值代替參數(shù)名。參數(shù)值取自properties元素或者文件里配置的屬性,文件在filters元素里列出。 --> < filtering /> <!-- 描述存放資源的目錄,該路徑相對(duì)POM路徑 --> < directory /> <!-- 包含的模式列表,例如**/*.xml. --> < includes /> <!-- 排除的模式列表,例如**/*.xml --> < excludes /> </ resource > </ resources > <!-- 這個(gè)元素描述了單元測(cè)試相關(guān)的所有資源路徑,例如和單元測(cè)試相關(guān)的屬性文件。 --> < testResources > <!-- 這個(gè)元素描述了測(cè)試相關(guān)的所有資源路徑,參見(jiàn)build/resources/resource元素的說(shuō)明 --> < 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開(kāi)關(guān)打開(kāi)時(shí),使用到的過(guò)濾器屬性文件列表 --> < filters /> <!-- 子項(xiàng)目可以引用的默認(rèn)插件信息。該插件配置項(xiàng)直到被引用時(shí)才會(huì)被解析或綁定到生命周期。給定插件的任何本地配置都會(huì)覆蓋這里的配置 --> < pluginManagement > <!-- 使用的插件列表 。 --> < plugins > <!-- plugin元素包含描述插件所需要的信息。 --> < plugin > <!-- 插件在倉(cāng)庫(kù)里的group ID --> < groupId /> <!-- 插件在倉(cāng)庫(kù)里的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)建過(guò)程中的目標(biāo),或者匹配繼承過(guò)程中需要合并的執(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 > <!-- 參見(jiàn)dependencies/dependency元素 --> < dependency > ...... </ dependency > </ dependencies > <!-- 任何配置是否被傳播到子項(xiàng)目 --> < inherited /> <!-- 作為DOM對(duì)象的配置 --> < configuration /> </ plugin > </ plugins > </ pluginManagement > <!-- 使用的插件列表 --> < plugins > <!-- 參見(jiàn)build/pluginManagement/plugins/plugin元素 --> < plugin > < groupId />< artifactId />< version />< extensions /> < executions > < execution > < id />< phase />< goals />< inherited />< configuration /> </ execution > </ executions > < dependencies > <!-- 參見(jiàn)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的開(kāi)啟鑰匙。profile的力量來(lái)自于它 能夠在某些特定的環(huán)境中自動(dòng)使用某些特定的值;這些環(huán)境通過(guò)activation元素指定。activation元素并不是激活profile的唯一方式。 --> < activation > <!-- profile默認(rèn)是否激活的標(biāo)志 --> < activeByDefault /> <!-- 當(dāng)匹配的jdk被檢測(cè)到,profile被激活。例如,1.4激活JDK1.4,1.4.0_2,而!1.4激活所有版本不是以1.4開(kāi)頭的JDK。 --> < 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ū)分大小寫方式匹配屬性值字段 --> < 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 />< filtering />< directory />< includes />< excludes /> </ resource > </ resources > < testResources > < testResource > < targetPath />< filtering />< directory />< includes />< excludes /> </ testResource > </ testResources > < directory />< finalName />< filters /> < pluginManagement > < plugins > <!-- 參見(jiàn)build/pluginManagement/plugins/plugin元素 --> < plugin > < groupId />< artifactId />< version />< extensions /> < executions > < execution > < id />< phase />< goals />< inherited />< configuration /> </ execution > </ executions > < dependencies > <!-- 參見(jiàn)dependencies/dependency元素 --> < dependency > ...... </ dependency > </ dependencies > < goals />< inherited />< configuration /> </ plugin > </ plugins > </ pluginManagement > < plugins > <!-- 參見(jiàn)build/pluginManagement/plugins/plugin元素 --> < plugin > < groupId />< artifactId />< version />< extensions /> < executions > < execution > < id />< phase />< goals />< inherited />< configuration /> </ execution > </ executions > < dependencies > <!-- 參見(jiàn)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)程倉(cāng)庫(kù)列表。 --> < repositories > <!-- 參見(jiàn)repositories/repository元素 --> < repository > < releases > < enabled />< updatePolicy />< checksumPolicy /> </ releases > < snapshots > < enabled />< updatePolicy />< checksumPolicy /> </ snapshots > < id />< name />< url />< 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 />< updatePolicy />< checksumPolicy /> </ releases > < snapshots > < enabled />< updatePolicy />< checksumPolicy /> </ snapshots > < id />< name />< url />< 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 /> <!-- 該元素包括使用報(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 /> <!-- 發(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 /> <!-- 該元素指定更新發(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)程倉(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 />< updatePolicy />< 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 /> <!-- 報(bào)表插件在倉(cāng)庫(kù)里的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以外的一些信息沒(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 /> </ 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 /> </ 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 /> <!-- 構(gòu)件新的artifact ID --> < artifactId /> <!-- 構(gòu)件新的版本號(hào) --> < version /> <!-- 顯示給用戶的,關(guān)于移動(dòng)的額外信息,例如原因。 --> < 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 /> </ distributionManagement > <!-- 以值替代名稱,Properties可以在整個(gè)POM中使用,也可以作為觸發(fā)條件(見(jiàn)settings.xml配置文件里activation元素的說(shuō)明)。格式是<name>value</name>。 --> < properties /> </ project >
?
更多文章、技術(shù)交流、商務(wù)合作、聯(lián)系博主
微信掃碼或搜索:z360901061

微信掃一掃加我為好友
QQ號(hào)聯(lián)系: 360901061
您的支持是博主寫作最大的動(dòng)力,如果您喜歡我的文章,感覺(jué)我的文章對(duì)您有幫助,請(qǐng)用微信掃描下面二維碼支持博主2元、5元、10元、20元等您想捐的金額吧,狠狠點(diǎn)擊下面給點(diǎn)支持吧,站長(zhǎng)非常感激您!手機(jī)微信長(zhǎng)按不能支付解決辦法:請(qǐng)將微信支付二維碼保存到相冊(cè),切換到微信,然后點(diǎn)擊微信右上角掃一掃功能,選擇支付二維碼完成支付。
【本文對(duì)您有幫助就好】元
