1.pom.xml中的內(nèi)置變量
Maven內(nèi)置變量說明:
* ${basedir} 項(xiàng)目根目錄(即pom.xml文件所在目錄)
* ${project.build.directory} 構(gòu)建目錄炒瘟,缺省為target目錄
* ${project.build.outputDirectory} 構(gòu)建過程輸出目錄瓶佳,缺省為target/classes
* ${project.build.finalName} 產(chǎn)出物名稱疤苹,缺省為${project.artifactId}-${project.version}
* ${project.packaging} 打包類型鄙信,缺省為jar
* ${project.xxx} 當(dāng)前pom文件的任意節(jié)點(diǎn)的內(nèi)容
* ${env.xxx} 獲取系統(tǒng)環(huán)境變量钝的。例如,"env.PATH"指代了$path環(huán)境變量(在Windows上是%PATH%)。
* ${settings.xxx} 指代了settings.xml中對應(yīng)元素的值。例如:<settings><offline>false</offline></settings>通過 ${settings.offline}獲得offline的值。
* Java System Properties: 所有可通過java.lang.System.getProperties()訪問的屬性都能在POM中使用世分,例如 ${JAVA_HOME}。
2.配置詳解
<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ī)定某個元素的值臭埋,那么父項(xiàng)目中的對應(yīng)值即為項(xiàng)目的默認(rèn)值踪央。 坐標(biāo)包括group ID,artifact ID和 version斋泄。-->
<parent>
<!--被繼承的父項(xiàng)目的構(gòu)件標(biāo)識符-->
<artifactId/>
<!--被繼承的父項(xiàng)目的全球唯一標(biāo)識符-->
<groupId/>
<!--被繼承的父項(xiàng)目的版本-->
<version/>
<!--父項(xiàng)目的pom.xml文件的相對路徑杯瞻。相對路徑允許你選擇一個不同的路徑。默認(rèn)值是../pom.xml。Maven首先在構(gòu)建當(dāng)前項(xiàng)目的地方尋找父項(xiàng)目的pom列赎,其次在文件系統(tǒng)的這個位置(relativePath位置)睁冬,然后在本地倉庫,最后在遠(yuǎn)程倉庫尋找父項(xiàng)目的pom旗唁。-->
<relativePath/>
</parent>
<!--聲明項(xiàng)目描述符遵循哪一個POM模型版本。模型本身的版本很少改變痹束,雖然如此检疫,但它仍然是必不可少的,這是為了當(dāng)Maven引入了新的特性或者其他模型變更的時候祷嘶,確保穩(wěn)定性屎媳。-->
<modelVersion>4.0.0</modelVersion>
<!--項(xiàng)目的全球唯一標(biāo)識符,通常使用全限定的包名區(qū)分該項(xiàng)目和其他項(xiàng)目论巍。并且構(gòu)建時生成的路徑也是由此生成烛谊, 如com.mycompany.app生成的相對路徑為:/com/mycompany/app-->
<groupId>asia.banseon</groupId>
<!--構(gòu)件的標(biāo)識符,它和group ID一起唯一標(biāo)識一個構(gòu)件嘉汰。換句話說丹禀,你不能有兩個不同的項(xiàng)目擁有同樣的artifact ID和groupID;在某個特定的group ID下鞋怀,artifact ID也必須是唯一的双泪。構(gòu)件是項(xiàng)目產(chǎn)生的或使用的一個東西,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)前版本邑滨,格式為:主版本.次版本.增量版本-限定版本號-->
<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)這個元素能夠用HTML格式描述時(例如,CDATA中的文本會被解析器忽略掖看,就可以包含HTML標(biāo)簽)匣距, 不鼓勵使用純文本描述面哥。如果你需要修改產(chǎn)生的web站點(diǎn)的索引頁面,你應(yīng)該修改你自己的索引頁文件毅待,而不是調(diào)整這里的文檔尚卫。-->
<description>A maven project to study maven.</description>
<!--描述了這個項(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)建完成時怎爵,需要通知的開發(fā)者/用戶的配置項(xiàng)。包括被通知者信息和通知條件(錯誤盅蝗,失敗鳖链,成功,警告)-->
<notifiers>
<!--配置一種方式墩莫,當(dāng)構(gòu)建中斷時芙委,以該方式通知用戶/開發(fā)者-->
<notifier>
<!--傳送通知的途徑-->
<type/>
<!--發(fā)生錯誤時是否通知-->
<sendOnError/>
<!--構(gòu)建失敗時是否通知-->
<sendOnFailure/>
<!--構(gòu)建成功時是否通知-->
<sendOnSuccess/>
<!--發(fā)生警告時是否通知-->
<sendOnWarning/>
<!--不贊成使用。通知發(fā)送到哪里-->
<address/>
<!--擴(kuò)展配置項(xiàng)-->
<configuration/>
</notifier>
</notifiers>
</ciManagement>
<!--項(xiàng)目創(chuàng)建年份狂秦,4位數(shù)字灌侣。當(dāng)產(chǎn)生版權(quán)信息時需要使用這個值。-->
<inceptionYear/>
<!--項(xiàng)目相關(guān)郵件列表信息-->
<mailingLists>
<!--該元素描述了項(xiàng)目相關(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>
<!--項(xiàng)目開發(fā)者列表-->
<developers>
<!--某個項(xiàng)目開發(fā)者的信息-->
<developer>
<!--SCM里項(xiàng)目開發(fā)者的唯一標(biāo)識符-->
<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ā)者屬性缴川,如即時消息如何處理等-->
<properties>
<dept>No</dept>
</properties>
<!--項(xiàng)目開發(fā)者所在時區(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列表恋日。如果列出多個license膀篮,用戶可以選擇它們中的一個而不是接受所有l(wèi)icense。-->
<licenses>
<!--描述了項(xiàng)目的license岂膳,用于生成項(xiàng)目的web站點(diǎn)的license頁面誓竿,其他一些報(bào)表和validation也會用到該元素。-->
<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筷屡, 用戶必須手動下載和安裝依賴-->
<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描述了版本庫和如何連接到版本庫速蕊。欲知詳情,請看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)目的時候,構(gòu)建系統(tǒng)會編譯目錄里的源碼泛啸。該路徑是相對于pom.xml的相對路徑绿语。-->
<sourceDirectory/>
<!--該元素設(shè)置了項(xiàng)目腳本源碼目錄,該目錄和源碼目錄不同:絕大多數(shù)情況下候址,該目錄下的內(nèi)容 會被拷貝到輸出目錄(因?yàn)槟_本是被解釋的吕粹,而不是被編譯的)。-->
<scriptSourceDirectory/>
<!--該元素設(shè)置了項(xiàng)目單元測試使用的源碼目錄岗仑,當(dāng)測試項(xiàng)目的時候匹耕,構(gòu)建系統(tǒng)會編譯目錄里的源碼。該路徑是相對于pom.xml的相對路徑荠雕。-->
<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 叫做階段)時的默認(rèn)值-->
<defaultGoal/>
<!--這個元素描述了項(xiàng)目相關(guān)的所有資源路徑列表既鞠,例如和項(xiàng)目相關(guān)的屬性文件,這些資源被包含在最終的打包文件里盖文。-->
<resources>
<!--這個元素描述了項(xiàng)目相關(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/>
<!--子項(xiàng)目可以引用的默認(rèn)插件信息。該插件配置項(xiàng)直到被引用時才會被解析或綁定到生命周期睦疫。給定插件的任何本地配置都會覆蓋這里的配置-->
<pluginManagement>
<!--使用的插件列表 害驹。-->
<plugins>
<!--plugin元素包含描述插件所需要的信息。-->
<plugin>
<!--插件在倉庫里的group ID-->
<groupId/>
<!--插件在倉庫里的artifact ID-->
<artifactId/>
<!--被使用的插件的版本(或版本范圍)-->
<version/>
<!--是否從該插件下載Maven擴(kuò)展(例如打包和類型處理器)蛤育,由于性能原因宛官,只有在真需要下載時,該元素才被設(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>
<!--項(xiàng)目引入插件所需要的額外依賴-->
<dependencies>
<!--參見dependencies/dependency元素-->
<dependency>
......
</dependency>
</dependencies>
<!--任何配置是否被傳播到子項(xiàng)目-->
<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>
<!--在列的項(xiàng)目構(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)建項(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>
<!--模塊(有時稱作子項(xiàng)目) 被構(gòu)建成項(xiàng)目的一部分续镇。列出的每個模塊元素是指向該模塊的目錄的相對路徑-->
<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)建過程中的一個個環(huán)節(jié)。它們自動從項(xià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)表就會運(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>
<!--模塊(有時稱作子項(xiàng)目) 被構(gòu)建成項(xiàng)目的一部分恢暖。列出的每個模塊元素是指向該模塊的目錄的相對路徑-->
<modules/>
<!--發(fā)現(xiàn)依賴和擴(kuò)展的遠(yuǎn)程倉庫列表排监。-->
<repositories>
<!--包含需要連接到遠(yuǎn)程倉庫的信息-->
<repository>
<!--如何處理遠(yuǎn)程倉庫里發(fā)布版本的下載-->
<releases>
<!--true或者false表示該倉庫是否為下載某種類型構(gòu)件(發(fā)布版,快照版)開啟杰捂。 -->
<enabled/>
<!--該元素指定更新發(fā)生的頻率社露。Maven會比較本地POM和遠(yuǎn)程POM的時間戳。這里的選項(xiàng)是:always(一直)琼娘,daily(默認(rèn)峭弟,每日),interval:X(這里X是以分鐘為單位的時間間隔)脱拼,或者never(從不)瞒瘸。-->
<updatePolicy/>
<!--當(dāng)Maven驗(yàn)證構(gòu)件校驗(yàn)文件失敗時該怎么做:ignore(忽略),fail(失斚ㄅā)情臭,或者warn(警告)。-->
<checksumPolicy/>
</releases>
<!--如何處理遠(yuǎn)程倉庫里快照版本的下載赌蔑。有了releases和snapshots這兩組配置俯在,POM就可以在每個單獨(dú)的倉庫中,為每種類型的構(gòu)件采取不同的策略娃惯。例如跷乐,可能有人會決定只為開發(fā)目的開啟對快照版本下載的支持。參見repositories/repository/releases元素-->
<snapshots>
<enabled/><updatePolicy/><checksumPolicy/>
</snapshots>
<!--遠(yuǎn)程倉庫唯一標(biāo)識符趾浅°堤幔可以用來匹配在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為其倉庫提供了一個默認(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)建過程中的一個個環(huán)節(jié)不见。它們自動從項(xiàng)目定義的倉庫中下載。要獲取更多信息订歪,請看項(xiàng)目依賴機(jī)制脖祈。-->
<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。它通常表示依賴的文件的擴(kuò)展名眼虱,但也有例外喻奥。一個類型可以被映射成另外一個擴(kuò)展名或分類器。類型經(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)建兩個單獨(dú)的構(gòu)件成JAR疚鲤,一個使用Java 1.4編譯器,另一個使用Java 6編譯器缘挑,你就可以使用分類器來生成兩個單獨(dú)的JAR構(gòu)件集歇。-->
<classifier></classifier>
<!--依賴范圍。在項(xiàng)目發(fā)布過程中语淘,幫助決定哪些構(gòu)件被包括進(jìn)來鬼悠。欲知詳情請參考依賴機(jī)制。
- compile :默認(rèn)范圍亏娜,用于編譯
- provided:類似于編譯焕窝,但支持你期待jdk或者容器提供,類似于classpath
- runtime: 在執(zhí)行時需要使用
- test: 用于test任務(wù)時使用
- system: 需要外在提供相應(yīng)的元素维贺。通過systemPath來取得
- systemPath: 僅用于范圍為system它掂。提供相應(yīng)的路徑
- optional: 當(dāng)項(xiàng)目自身被依賴時,標(biāo)注依賴是否傳遞溯泣。用于連續(xù)依賴時使用-->
<scope>test</scope>
<!--僅供system范圍使用虐秋。注意,不鼓勵使用這個元素垃沦,并且在新的版本中該元素可能被覆蓋掉客给。該元素為依賴規(guī)定了文件系統(tǒng)上的路徑。需要絕對路徑而不是相對路徑肢簿。推薦使用屬性匹配絕對路徑靶剑,例如${java.home}蜻拨。-->
<systemPath></systemPath>
<!--當(dāng)計(jì)算傳遞依賴時, 從依賴構(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)中顯式的引用對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)表就會運(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ī)范,每個規(guī)范可能有不同的配置粪狼。一個規(guī)范(報(bào)表集)對應(yīng)一個執(zhí)行目標(biāo) 退腥。例如,有1再榄,2狡刘,3,4困鸥,5嗅蔬,6,7疾就,8澜术,9個報(bào)表。1猬腰,2鸟废,5構(gòu)成A報(bào)表集,對應(yīng)一個執(zhí)行目標(biāo)姑荷。2盒延,5缩擂,8構(gòu)成B報(bào)表集兰英,對應(yīng)另一個執(zhí)行目標(biāo)-->
<reportSets>
<!--表示報(bào)表的一個集合供鸠,以及產(chǎn)生該集合的配置-->
<reportSet>
<!--報(bào)表集合的唯一標(biāo)識符,POM繼承時用到-->
<id/>
<!--產(chǎn)生報(bào)表集合時薄坏,被使用的報(bào)表的配置-->
<configuration/>
<!--配置是否被繼承到子POMs-->
<inherited/>
<!--這個集合里使用到哪些報(bào)表-->
<reports/>
</reportSet>
</reportSets>
</plugin>
</plugins>
</reporting>
<!--繼承自該項(xiàng)目的所有子項(xiàng)目的默認(rèn)依賴信息寨闹。這部分的依賴信息不會被立即解析,而是當(dāng)子項(xiàng)目聲明一個依賴(必須描述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ò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>
<!--部署項(xiàng)目的網(wǎng)站需要的信息-->
<site>
<!--部署位置的唯一標(biāo)識符应媚,用來匹配站點(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)件新的版本號-->
<version/>
<!--顯示給用戶的,關(guān)于移動的額外信息嗜桌,例如原因奥溺。-->
<message/>
</relocation>
<!--給出該構(gòu)件在遠(yuǎn)程倉庫的狀態(tài)。不得在本地項(xiàng)目中設(shè)置該元素骨宠,因?yàn)檫@是工具自動更新的浮定。有效的值有:none(默認(rèn))相满,converted(倉庫管理員從Maven 1 POM轉(zhuǎn)換過來),partner(直接從伙伴Maven 2倉庫同步過來)桦卒,deployed(從Maven 2實(shí)例部署)立美,verified(被核實(shí)時正確的和最終的)方灾。-->
<status/>
</distributionManagement>
<!--以值替代名稱洞慎,Properties可以在整個POM中使用劲腿,也可以作為觸發(fā)條件(見settings.xml配置文件里activation元素的說明)焦人。格式是<name>value</name>花椭。-->
<properties/>
</project>
3.相關(guān)元素介紹
3.1 optional 元素
optional是Maven依賴jar時的一個選項(xiàng),表示該依賴是可選的嗦锐,項(xiàng)目之間依賴不傳遞沪曙。
不設(shè)置 optional(默認(rèn)為false)或者設(shè)置 optional 為 false碳默,表示傳遞依賴缘眶。
#1.假設(shè)有兩個項(xiàng)目A和B该抒,其中A為父項(xiàng)目凑保,B為子項(xiàng)目欧引。在父項(xiàng)目中引入了單元測試的依賴:
[
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<optional>false</optional>
</dependency>
]
>> 當(dāng)optional元素默認(rèn)值(false)時:
由于optional為false, 那么具有依賴傳遞性憋肖。
此時癌蓖,子項(xiàng)目B中會直接引入父項(xiàng)目A中引入的Junit的jar包租副。
也就是說B項(xiàng)目打包時用僧,jar/war包中會包含junit的jar包。
>> 當(dāng)optional元素為true 時:
由于optional為true, 那么不具有依賴傳遞性院仿。
如果項(xiàng)目B不需要Junit的jar包歹垫,那么在其pom文件中不需進(jìn)行任何處理便可以排惨。
如果B項(xiàng)目也需要對應(yīng)的jar包依賴,可以有兩種選擇:
第一欲低、A項(xiàng)目中對應(yīng)依賴的optional設(shè)置為false或去掉瑞筐;
第二面哼、B項(xiàng)目中直接引入需要的該依賴魔策。
#2.parent繼承的情況
我們經(jīng)常會在parent項(xiàng)目中配置統(tǒng)一的依賴版本控制
<dependencyManagement>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<optional>true</optional>
</dependency>
</dependencies>
</dependencyManagement>
此時虎敦,如果B項(xiàng)目需要Junit的jar包其徙,可以直接在項(xiàng)目中引入唾那,這里父項(xiàng)目中的optional配置對子項(xiàng)目并無影響闹获。
#3.結(jié)論
在Maven項(xiàng)目中避诽,恰當(dāng)?shù)氖褂胦ptional配置沙庐,可以在很大程度上減少jar包的大小,提升編譯和發(fā)布速度古涧。
optional 元素在父子項(xiàng)目中的傳遞性.png
3.2 scope元素
scope元素主要用來控制依賴的使用范圍,指定當(dāng)前包的依賴范圍和依賴的傳遞性柒昏,也就是哪些依賴在哪些classpath中可用职祷。
常見的可選值有:compile, provided, runtime, test, system等是尖。
#1.compile(編譯, 默認(rèn)值)
compile表示對應(yīng)依賴會參與當(dāng)前項(xiàng)目的編譯、測試兜辞、運(yùn)行等逸吵,是一個比較強(qiáng)的依賴。
打包時通常會包含該依賴啸罢,部署時會打包到lib目錄下胎食。
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
#2.test(測試)
scope為test表示依賴項(xiàng)目僅參與測試環(huán)節(jié),在編譯粥航、運(yùn)行递雀、打包時不會使用。
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
#3.runntime(運(yùn)行時)
runntime僅僅適用于運(yùn)行和測試環(huán)節(jié),在編譯環(huán)境下不會被使用摆昧。
比如編譯時只需要JDBC API的jar昭躺,而只有運(yùn)行時才需要JDBC驅(qū)動實(shí)現(xiàn)窍仰。
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.20</version>
<scope>runtime</scope>
</dependency>
#4.provided(已提供)
provided適合在編譯和測試的環(huán)境,和compile功能相似晶伦,
但provide僅在編譯和測試階段生效族沃,provide不會被打包,也不具有傳遞性沽一。
比如:servlet-api, Tomcat容器已經(jīng)提供盖溺,不需要重復(fù)引入。
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<scope>provided</scope>
</dependency>
#5.system (不推薦使用)
system范圍依賴與provided類似铣缠,不過依賴項(xiàng)不會從maven倉庫獲取烘嘱,而需要從本地文件系統(tǒng)提供。
使用時蝗蛙,一定要配合systemPath屬性蝇庭。不推薦使用,盡量從Maven庫中引用依賴捡硅。
<dependency>
<groupId>sun.jdk</groupId>
<artifactId>tools</artifactId>
<version>1.5.0</version>
<scope>system</scope>
<systemPath>${java.home}/../lib/tools.jar</systemPath>
</dependency>
3.2.1 scope 依賴的傳遞性
如下圖: B 依賴 A泰涂,C 依賴 B
傳遞性的關(guān)鍵是 B 依賴 A 時所設(shè)置的 scope 值,當(dāng) B 采用不同的值時對應(yīng)的依賴關(guān)系如下:
>> 當(dāng) B 通過 test 或 provided 依賴 A 時,C 不依賴 A驻债;
>> 當(dāng) B 通過 runtime 或 compile 依賴 A 時冻辩,C 依賴 A;
參考資源
https://juejin.cn/post/6901496488174714894
最后編輯于 :2021.06.08 21:36:06
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者