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