開(kāi)發(fā)好幾年了,從來(lái)沒(méi)看過(guò)/學(xué)過(guò)Maven剖煌,然而卻每天都在用赋访,今天抽半天時(shí)間補(bǔ)補(bǔ)課。
Maven概念
什么是Maven啄枕?
- Maven 翻譯過(guò)來(lái)就是專家
- 官網(wǎng) http://maven.apache.org/
- Maven使用POM (Project Object Model)項(xiàng)目對(duì)象模型婚陪,就是通過(guò)一段描述信息管理項(xiàng)目的構(gòu)建,描述信息為一個(gè)xml類型的文件频祝,該文件用于管理:源代碼泌参、配置文件、開(kāi)發(fā)者的信息和角色常空、問(wèn)題追蹤系統(tǒng)沽一、組織信息、項(xiàng)目授權(quán)漓糙、項(xiàng)目的url铣缠、項(xiàng)目的依賴關(guān)系等等。
- Maven的用途通常有:構(gòu)建項(xiàng)目昆禽,文檔生成蝗蛙,報(bào)告,依賴管理醉鳖,SCMS捡硅,發(fā)布項(xiàng)目,分發(fā)項(xiàng)目盗棵,郵件管理
- 主要思想:約定大于配置
- 其實(shí)就是一個(gè)詞:標(biāo)準(zhǔn)壮韭。規(guī)范了Java項(xiàng)目開(kāi)發(fā)的一個(gè)標(biāo)準(zhǔn)北发,標(biāo)準(zhǔn)很重要,每個(gè)公司都有自己的標(biāo)準(zhǔn)喷屋,那就亂套了
約定項(xiàng)目目錄結(jié)構(gòu)
-- 項(xiàng)目目錄
--src 項(xiàng)目中的所有資源
--main 存放開(kāi)發(fā)代碼和資源
--java 項(xiàng)目的java源代碼
--resources 項(xiàng)目的資源文件琳拨,源代碼之外的其他文件
--test 存放測(cè)試代碼和資源
--java 項(xiàng)目的測(cè)試類和測(cè)試代碼
--resources 項(xiàng)目的測(cè)試資源
--target 打包輸出目錄
--classes 編譯輸出目錄
--test-classes 測(cè)試代碼編譯輸出目錄
--generated-sources 自動(dòng)生成的資源輸出目錄
--generated-test-sources 測(cè)試資源輸出目錄
--pom.xml 文檔對(duì)象模型的描述文件
詳細(xì)解釋如下:
- ${basedir} 存放pom.xml和所有的子目錄
- ${basedir}/src/main/java 項(xiàng)目的java源代碼
- ${basedir}/src/main/resources 項(xiàng)目的資源,比如說(shuō)property文件屯曹,springmvc.xml
- ${basedir}/src/test/java 項(xiàng)目的測(cè)試類从绘,比如說(shuō)Junit代碼
- ${basedir}/src/test/resources 測(cè)試用用的資源
- ${basedir}/src/main/webapp/WEB-INF web應(yīng)用文件目錄,web項(xiàng)目的信息是牢,比如存放web.xml、本地圖片陕截、jsp視圖頁(yè)面
- ${basedir}/target 打包輸出目錄
- ${basedir}/target/classes 編譯輸出目錄
- ${basedir}/target/test-classes 測(cè)試編譯輸出目錄
- Test.java Maven只會(huì)自動(dòng)運(yùn)行符合該命名規(guī)則的測(cè)試類
- ~/.m2/repository Maven默認(rèn)的本地倉(cāng)庫(kù)目錄位置
開(kāi)始使用Maven的優(yōu)勢(shì)
- 項(xiàng)目設(shè)置遵循統(tǒng)一的規(guī)則驳棱。
- 任意工程中共享。
- 依賴管理包括自動(dòng)更新农曲。
- 一個(gè)龐大且不斷增長(zhǎng)的庫(kù)社搅。
- 可擴(kuò)展,能夠輕松編寫 Java 或腳本語(yǔ)言的插件乳规。
- 只需很少或不需要額外配置即可即時(shí)訪問(wèn)新功能形葬。
- 基于模型的構(gòu)建 ? Maven能夠?qū)⑷我鈹?shù)量的項(xiàng)目構(gòu)建到預(yù)定義的輸出類型中,如 JAR暮的,WAR 或基于項(xiàng)目元數(shù)據(jù)的分發(fā)笙以,而不需要在大多數(shù)情況下執(zhí)行任何腳本。
- 項(xiàng)目信息的一致性站點(diǎn) ? 使用與構(gòu)建過(guò)程相同的元數(shù)據(jù)冻辩,Maven 能夠生成一個(gè)網(wǎng)站或PDF猖腕,包括您要添加的任何文檔,并添加到關(guān)于項(xiàng)目開(kāi)發(fā)狀態(tài)的標(biāo)準(zhǔn)報(bào)告中恨闪。
- 發(fā)布管理和發(fā)布發(fā)布 ? Maven 將不需要額外的配置倘感,就可以與源代碼管理系統(tǒng)(如 Subversion 或 Git)集成,并可以基于某個(gè)標(biāo)簽管理項(xiàng)目的發(fā)布咙咽。它也可以將其發(fā)布到分發(fā)位置供其他項(xiàng)目使用老玛。Maven能夠發(fā)布單獨(dú)的輸出,如 JAR钧敞,包含其他依賴和文檔的歸檔蜡豹,或者作為源代碼發(fā)布。
- 向后兼容性 ? 您可以很輕松的從舊版本 Maven 的多個(gè)模塊移植到 Maven 3 中犁享。
- 子項(xiàng)目使用父項(xiàng)目依賴時(shí)余素,正常情況子項(xiàng)目應(yīng)該繼承父項(xiàng)目依賴,無(wú)需使用版本號(hào)炊昆,
- 并行構(gòu)建 ? 編譯的速度能普遍提高20 - 50 %桨吊。
- 更好的錯(cuò)誤報(bào)告 ? Maven 改進(jìn)了錯(cuò)誤報(bào)告威根,它為您提供了 Maven wiki 頁(yè)面的鏈接鸳劳,您可以點(diǎn)擊鏈接查看錯(cuò)誤的完整描述外遇。
安裝
很多集成開(kāi)發(fā)環(huán)境默認(rèn)集成了一個(gè)maven,比如IDEA译打,但是了解下安裝過(guò)程還是有必要的佑淀。
- 安裝JDK
- 配置JAVA_HOME
- 下載Maven解壓可用 過(guò)程見(jiàn):http://www.runoob.com/maven/maven-setup.html
POM詳解
項(xiàng)目對(duì)象模型留美,Project Object Model ,就是一個(gè)xml文件伸刃,描述了項(xiàng)目的信息谎砾,如果構(gòu)建、依賴什么的
所以看pom.xml主要就是看一下幾個(gè)配置:
- jar包依賴
- 執(zhí)行目標(biāo)
- 構(gòu)建profile
- 版本
- 項(xiàng)目開(kāi)發(fā)者列表
- 相關(guān)郵件列表
所有的pom文件都必須有的元素:
- project 工程的根標(biāo)簽
- modelVersion 模型版本號(hào)
- goupId 工程組的唯一標(biāo)識(shí)捧颅,通常為公司或組織域名
- artifactId 工程的唯一標(biāo)識(shí)景图,通常是工程名稱
- version 工程的版本號(hào)
- 所有的POM都默認(rèn)繼承自一個(gè)父POM(不管你是否顯示定義),父POM有一些默認(rèn)的配置幫助開(kāi)發(fā)者簡(jiǎn)化開(kāi)發(fā)配置碉哑,使用命令
mvn help:effective-pom
可以查看Super POM 默認(rè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/xsd/maven-4.0.0.xsd">
<!-- 模型版本 -->
<modelVersion>4.0.0</modelVersion>
<!-- 公司或者組織的唯一標(biāo)志挚币,并且配置時(shí)生成的路徑也是由此生成, 如com.companyname.project-group扣典,maven會(huì)將該項(xiàng)目打成的jar包放本地路徑:/com/companyname/project-group -->
<groupId>com.companyname.project-group</groupId>
<!-- 項(xiàng)目的唯一ID妆毕,一個(gè)groupId下面可能多個(gè)項(xiàng)目,就是靠artifactId來(lái)區(qū)分的 -->
<artifactId>project</artifactId>
<!-- 版本號(hào) -->
<version>1.0</version>
</project>
POM的詳細(xì)配置
<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>
Maven的構(gòu)建生命周期
- 驗(yàn)證 validate 驗(yàn)證項(xiàng)目 驗(yàn)證項(xiàng)目是否正確且所有必須信息是可用的
- 編譯 compile 執(zhí)行編譯 源代碼編譯在此階段完成
- 測(cè)試 Test 測(cè)試 使用適當(dāng)?shù)膯卧獪y(cè)試框架(例如JUnit)運(yùn)行測(cè)試巍虫。
- 包裝 package 打包 創(chuàng)建JAR/WAR包如在 pom.xml 中定義提及的包
- 檢查 verify 檢查 對(duì)集成測(cè)試的結(jié)果進(jìn)行檢查,以保證質(zhì)量達(dá)標(biāo)
- 安裝 install 安裝 安裝打包的項(xiàng)目到本地倉(cāng)庫(kù)鳍刷,以供其他項(xiàng)目使用
- 部署 deploy 部署 拷貝最終的工程包到遠(yuǎn)程倉(cāng)庫(kù)中占遥,以共享給其他開(kāi)發(fā)人員和工程
Maven的三個(gè)標(biāo)準(zhǔn)生命周期
- clean 項(xiàng)目清理
- default或build 項(xiàng)目部署
- site 項(xiàng)目站點(diǎn)文檔構(gòu)建
Clean 生命周期
當(dāng)我們執(zhí)行 mvn post-clean 命令時(shí),Maven 調(diào)用 clean 生命周期输瓜,它包含以下階段:
pre-clean:執(zhí)行一些需要在clean之前完成的工作
clean:移除所有上一次構(gòu)建生成的文件
post-clean:執(zhí)行一些需要在clean之后立刻完成的工作
mvn clean 中的 clean 就是上面的 clean瓦胎,在一個(gè)生命周期中,運(yùn)行某個(gè)階段的時(shí)候尤揣,它之前的所有階段都會(huì)被運(yùn)行搔啊,也就是說(shuō),mvn clean 等同于 mvn pre-clean clean 北戏,如果我們運(yùn)行 mvn post-clean 负芋,那么 pre-clean,clean 都會(huì)被運(yùn)行嗜愈。
Default (Build) 生命周期
這是 Maven 的主要生命周期旧蛾,被用于構(gòu)建應(yīng)用惩猫,包括下面的 23 個(gè)階段:
- validate 檢查工程配置是否正確,完成構(gòu)建過(guò)程的所有必要信息是否能夠獲取到蚜点。
- initialize 初始化構(gòu)建狀態(tài),例如設(shè)置屬性拌阴。
- generate-sources 生成編譯階段需要包含的任何源碼文件绍绘。
- process-sources 處理源代碼,例如幽钢,過(guò)濾任何值(filter any value)笔横。
- generate-resources 生成工程包中需要包含的資源文件称鳞。
- process-resources 拷貝和處理資源文件到目的目錄中,為打包階段做準(zhǔn)備左刽。
- compile 編譯工程源碼。
- process-classes 處理編譯生成的文件酌媒,例如 Java Class 字節(jié)碼的加強(qiáng)和優(yōu)化欠痴。
- generate-test-sources 生成編譯階段需要包含的任何測(cè)試源代碼。
- process-test-sources 處理測(cè)試源代碼秒咨,例如喇辽,過(guò)濾任何值(filter any values)。
- test-compile 編譯測(cè)試源代碼到測(cè)試目的目錄雨席。
- process-test-classes 處理測(cè)試代碼文件編譯后生成的文件菩咨。
- test 使用適當(dāng)?shù)膯卧獪y(cè)試框架(例如JUnit)運(yùn)行測(cè)試。
- prepare-package 在真正打包之前陡厘,為準(zhǔn)備打包執(zhí)行任何必要的操作抽米。
package 獲取編譯后的代碼,并按照可發(fā)布的格式進(jìn)行打包糙置,例如 JAR云茸、WAR 或者 EAR 文件。 - pre-integration-test 在集成測(cè)試執(zhí)行之前谤饭,執(zhí)行所需的操作查辩。例如,設(shè)置所需的環(huán)境變量网持。
- integration-test 處理和部署必須的工程包到集成測(cè)試能夠運(yùn)行的環(huán)境中宜岛。
- post-integration-test 在集成測(cè)試被執(zhí)行后執(zhí)行必要的操作。例如功舀,清理環(huán)境萍倡。
- verify 運(yùn)行檢查操作來(lái)驗(yàn)證工程包是有效的,并滿足質(zhì)量要求辟汰。
- install 安裝工程包到本地倉(cāng)庫(kù)中列敲,該倉(cāng)庫(kù)可以作為本地其他工程的依賴阱佛。
- deploy 拷貝最終的工程包到遠(yuǎn)程倉(cāng)庫(kù)中,以共享給其他開(kāi)發(fā)人員和工程戴而。
有一些與 Maven 生命周期相關(guān)的重要概念需要說(shuō)明:
當(dāng)一個(gè)階段通過(guò) Maven 命令調(diào)用時(shí)凑术,例如 mvn compile,只有該階段之前以及包括該階段在內(nèi)的所有階段會(huì)被執(zhí)行所意。
不同的 maven 目標(biāo)將根據(jù)打包的類型(JAR / WAR / EAR)淮逊,被綁定到不同的 Maven 生命周期階段。
在下面的例子中扶踊,我們將 maven-antrun-plugin:run 目標(biāo)添加到 Build 生命周期的一部分階段中泄鹏。這樣我們可以顯示生命周期的文本信息。
Site 生命周期
Maven Site 插件一般用來(lái)創(chuàng)建新的報(bào)告文檔秧耗、部署站點(diǎn)等备籽。
- pre-site:執(zhí)行一些需要在生成站點(diǎn)文檔之前完成的工作
- site:生成項(xiàng)目的站點(diǎn)文檔
- post-site: 執(zhí)行一些需要在生成站點(diǎn)文檔之后完成的工作,并且為部署做準(zhǔn)備
- site-deploy:將生成的站點(diǎn)文檔部署到特定的服務(wù)器上
這里經(jīng)常用到的是site階段和site-deploy階段分井,用以生成和發(fā)布Maven站點(diǎn)车猬,這可是Maven相當(dāng)強(qiáng)大的功能,Manager比較喜歡尺锚,文檔及統(tǒng)計(jì)數(shù)據(jù)自動(dòng)生成诈唬,很好看。 在下面的例子中缩麸,我們將 maven-antrun-plugin:run 目標(biāo)添加到 Site 生命周期的所有階段中铸磅。這樣我們可以顯示生命周期的所有文本信息。
Maven使用構(gòu)建配置文件
pom中可以引用外界的配置文件杭朱,達(dá)到不同環(huán)境(開(kāi)發(fā)阅仔、測(cè)試、部署)使用不同的構(gòu)建配置http://www.runoob.com/maven/maven-build-profiles.html
Maven倉(cāng)庫(kù)
存放依賴的一個(gè)位置/文件夾/倉(cāng)庫(kù)
- 本地倉(cāng)庫(kù)
- 中央倉(cāng)庫(kù)
- 遠(yuǎn)程倉(cāng)庫(kù)
本地倉(cāng)庫(kù)
第一次執(zhí)行maven命令時(shí)被創(chuàng)建弧械,maven運(yùn)行時(shí)需要的構(gòu)件都從本地倉(cāng)庫(kù)獲取八酒,本地倉(cāng)庫(kù)不存在時(shí)首先去遠(yuǎn)程倉(cāng)庫(kù)下載到本地倉(cāng)庫(kù),然后再使用刃唐。
默認(rèn)目錄%USER_HOME%.m2/repostitory
需要修改的話羞迷,更改 %M2_HOME%\conf 目錄中的 Maven 的 settings.xml 文件中定義另一個(gè)路徑。
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
http://maven.apache.org/xsd/settings-1.0.0.xsd">
<localRepository>C:/MyLocalRepository</localRepository>
</settings>
中央倉(cāng)庫(kù)
Maven社區(qū)提供的倉(cāng)庫(kù)画饥,包含所有的依賴庫(kù)衔瓮。
遠(yuǎn)程倉(cāng)庫(kù)
開(kāi)發(fā)者自己搭建的倉(cāng)庫(kù),可以放自己的私有jar包抖甘,而不讓別人使用热鞍,公司內(nèi)通常做一個(gè)自己的遠(yuǎn)程倉(cāng)庫(kù)來(lái)加快jar包的下載速度,類似的阿里云倉(cāng)庫(kù)就是國(guó)內(nèi)的加速倉(cāng)庫(kù)。
<repositories>
<repository>
<id>companyname.lib1</id>
<url>http://download.companyname.org/maven2/lib1</url>
</repository>
<repository>
<id>companyname.lib2</id>
<url>http://download.companyname.org/maven2/lib2</url>
</repository>
</repositories>
Maven依賴搜索順序
步驟 1 - 在本地倉(cāng)庫(kù)中搜索薇宠,如果找不到偷办,執(zhí)行步驟 2,如果找到了則執(zhí)行其他操作澄港。
步驟 2 - 在中央倉(cāng)庫(kù)中搜索椒涯,如果找不到,并且有一個(gè)或多個(gè)遠(yuǎn)程倉(cāng)庫(kù)已經(jīng)設(shè)置回梧,則執(zhí)行步驟 4废岂,如果找到了則下載到本地倉(cāng)庫(kù)中已被將來(lái)引用。
步驟 3 - 如果遠(yuǎn)程倉(cāng)庫(kù)沒(méi)有被設(shè)置漂辐,Maven 將簡(jiǎn)單的停滯處理并拋出錯(cuò)誤(無(wú)法找到依賴的文件)。
步驟 4 - 在一個(gè)或多個(gè)遠(yuǎn)程倉(cāng)庫(kù)中搜索依賴的文件棕硫,如果找到則下載到本地倉(cāng)庫(kù)已被將來(lái)引用髓涯,否則 Maven 將停止處理并拋出錯(cuò)誤(無(wú)法找到依賴的文件)。
使用阿里云倉(cāng)庫(kù)
眾所周知哈扮,中國(guó)政府實(shí)行網(wǎng)絡(luò)閉關(guān)鎖國(guó)政策纬纪。Maven訪問(wèn)是不可能的了,使用阿里云的倉(cāng)庫(kù)速度會(huì)快的多
Maven 阿里云(Aliyun)倉(cāng)庫(kù)
Maven 倉(cāng)庫(kù)默認(rèn)在國(guó)外滑肉, 國(guó)內(nèi)使用難免很慢包各,我們可以更換為阿里云的倉(cāng)庫(kù)。
第一步:修改 maven 根目錄下的 conf 文件夾中的 setting.xml 文件靶庙,在 mirrors 節(jié)點(diǎn)上问畅,添加內(nèi)容如下:
<mirrors>
<mirror>
<id>alimaven</id>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<mirrorOf>central</mirrorOf>
</mirror>
</mirrors>
第二步: pom.xml文件里添加:
<repositories>
<repository>
<id>alimaven</id>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
Maven插件
Maven的生命周期包含著一系列的階段,這些phase就相當(dāng)于Maven提供的接口六荒,實(shí)現(xiàn)是由插件來(lái)完成的护姆。
插件執(zhí)行的命令mvn [plugin-name]:[goal-name]
常見(jiàn)插件
不展開(kāi)細(xì)聊:http://www.runoob.com/maven/maven-plugins.html