1. POM(Project Object Model, 項(xiàng)目對(duì)象模型, 把項(xiàng)目當(dāng)作對(duì)象管理)是Maven工程的基本工作單元, 是一個(gè)XML文件, 包含了項(xiàng)目的基本信息, 用于描述項(xiàng)目如何構(gòu)建, 聲明項(xiàng)目依賴, 等等。

2. 執(zhí)行任務(wù)或目標(biāo)時(shí), Maven會(huì)在當(dāng)前目錄中查找POM。它讀取POM, 獲取所需的配置信息, 然后執(zhí)行目標(biāo)。

3. POM中可以指定以下配置:

3.1. 項(xiàng)目依賴

3.2. 插件

3.3. 執(zhí)行目標(biāo)

3.4. 項(xiàng)目構(gòu)建profile

3.5. 項(xiàng)目版本

3.6. 項(xiàng)目開(kāi)發(fā)者列表

3.7. 相關(guān)郵件列表信息

4. 所有POM文件都需要project元素和三個(gè)必需字段: groupId, artifactId, version。下面就是一個(gè)最基本的pom.xml。

5. 基本的pom.xml節(jié)點(diǎn)的含義?

6. 父(Super)POM

6.1. 父(Super)POM是Maven默認(rèn)的POM。所有的POM都繼承自一個(gè)父POM(無(wú)論是否顯式定義了這個(gè)父POM)。父POM包含了一些可以被繼承的默認(rèn)設(shè)置。因此, 當(dāng)Maven發(fā)現(xiàn)需要下載POM中的依賴時(shí), 它會(huì)到Super POM中配置的默認(rèn)倉(cāng)庫(kù)http://repo1.maven.org/maven2去下載。

6.2. Maven使用effective pom(Super pom加上工程自己的配置)來(lái)執(zhí)行相關(guān)的目標(biāo), 它幫助開(kāi)發(fā)者在pom.xml中做盡可能少的配置, 當(dāng)然這些配置可以被重寫(xiě)。

6.3. 使用以下命令來(lái)查看Super POM默認(rèn)配置:

mvn help:effective-pom

6.4. 到MavenWeb下執(zhí)行mvn help:effective-pom命令

6.5. 在上面的pom.xml中, 你可以看到Maven在執(zhí)行目標(biāo)時(shí)需要用到的默認(rèn)工程源碼目錄結(jié)構(gòu)、輸出目錄、需要的插件、倉(cāng)庫(kù)和報(bào)表目錄。

7. POM標(biāo)簽大全詳解

<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)件類(lèi)型, 例如jar、war、ear、pom。插件可以創(chuàng)建他們自己的構(gòu)件類(lèi)型, 所以前面列的不是全部構(gòu)件類(lèi)型 --><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ā)者使用的, 類(lèi)似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ò)展(例如打包和類(lèi)型處理器), 由于性能原因, 只有在真需要下載時(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ū)分大小寫(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 /><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ù)是否為下載某種類(lèi)型構(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ù)中, 為每種類(lèi)型的構(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ù)布局類(lèi)型-可以是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><!-- 依賴類(lèi)型, 默認(rèn)類(lèi)型是jar。它通常表示依賴的文件的擴(kuò)展名, 但也有例外。一個(gè)類(lèi)型可以被映射成另外一個(gè)擴(kuò)展名或分類(lèi)器。類(lèi)型經(jīng)常和使用的打包方式對(duì)應(yīng), 盡管這也有例外。一些類(lèi)型的例子: jar, war, ejb-client和test-jar。如果設(shè)置extensions為 true, 就可以在 plugin里定義新的類(lèi)型。所以前面的類(lèi)型的例子不完整。 --><type>jar</type><!-- 依賴的分類(lèi)器。分類(lèi)器可以區(qū)分屬于同一個(gè)POM, 但不同構(gòu)建方式的構(gòu)件。分類(lèi)器名被附加到文件名的版本號(hào)后面。例如, 如果你想要構(gòu)建兩個(gè)單獨(dú)的構(gòu)件成 JAR, 一個(gè)使用Java 1.4編譯器, 另一個(gè)使用Java 6編譯器, 你就可以使用分類(lèi)器來(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: 類(lèi)似于編譯, 但支持你期待jdk或者容器提供, 類(lèi)似于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>

總結(jié)

以上是生活随笔為你收集整理的005_Maven POM的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。