1 Maven 介紹
Maven 翻譯為"專家"饶米、"內(nèi)行"
它是 Apache 下的一個(gè)純 Java 開發(fā)的開源項(xiàng)目,Maven 曾是 Jakarta 項(xiàng)目的子項(xiàng)目车胡,現(xiàn)為由 Apache 軟件基金會(huì)主持的獨(dú)立 Apache 項(xiàng)目檬输。
1.1 為什么使用 Maven
由于Java的生態(tài)非常豐富,無論你想實(shí)現(xiàn)什么功能匈棘,都能找到對(duì)應(yīng)的工具類丧慈,這些工具類都是以jar包的形式出現(xiàn)的,例如 Spring主卫,SpringMVC逃默、MyBatis、數(shù)據(jù)庫(kù)驅(qū)動(dòng)等等簇搅,都是以jar包的形式出現(xiàn)的完域。
jar包之間會(huì)有關(guān)聯(lián),在使用一個(gè)依賴之前瘩将,還需要確定這個(gè)依賴所依賴的其他依賴吟税。所以,當(dāng)項(xiàng)目比較大的時(shí)候姿现,依賴管理會(huì)變得非常麻煩臃腫肠仪,這是 Maven 解決的第一個(gè)問題。
Maven 是一個(gè)項(xiàng)目管理工具备典,可以對(duì) Java 項(xiàng)目進(jìn)行構(gòu)建异旧、依賴管理。
Maven 也可被用于構(gòu)建和管理各種項(xiàng)目提佣,例如 C#吮蛹,Ruby,Scala 和其他語言編寫的項(xiàng)目镐依。
Maven 還可以處理多模塊項(xiàng)目匹涮。簡(jiǎn)單的項(xiàng)目,單模塊分包處理即可槐壳,如果項(xiàng)目比較復(fù)雜,要做成多模塊項(xiàng)目喜每,例如一個(gè)電商項(xiàng)目有訂單模塊务唐、會(huì)員模塊、商品模塊带兜、支付模塊...枫笛,一般來說,多模塊項(xiàng)目刚照,每一個(gè)模塊無法獨(dú)立運(yùn)行刑巧,要多個(gè)模塊合在一起,項(xiàng)目才可以運(yùn)行,這個(gè)時(shí)候啊楚,借助 Maven 工具吠冤,可以實(shí)現(xiàn)項(xiàng)目的一鍵打包。
1.2 Maven是什么
Maven是一個(gè)項(xiàng)目管理工具恭理,它包含了一個(gè)項(xiàng)目對(duì)象模型(Project Object Model)拯辙,反映在配置中,就是一個(gè)pom.xml文件颜价。它是一組標(biāo)準(zhǔn)集合涯保,一個(gè)項(xiàng)目的生命周期、一個(gè)依賴管理系統(tǒng)周伦,另外還包括定義在項(xiàng)目生命周期階段的插件(plugin)以及目標(biāo)(goal)夕春。
當(dāng)我們使用Maven的時(shí)候,通過一個(gè)自定義的項(xiàng)目對(duì)象模型pom.xml來詳細(xì)描述我們自己的項(xiàng)目专挪。
1.3 Maven功能
Maven 能夠幫助開發(fā)者完成以下工作:
- 構(gòu)建
- 文檔生成
- 報(bào)告
- 依賴
- SCMs
- 發(fā)布
- 分發(fā)
- 郵件列表
1.4 約定配置
Maven 提倡使用一個(gè)共同的標(biāo)準(zhǔn)目錄結(jié)構(gòu)及志,Maven 使用約定優(yōu)于配置的原則,大家盡可能的遵守這樣的目錄結(jié)構(gòu)狈蚤。
如下所示:
目錄 | 目的 |
---|---|
${basedir} | 存放pom.xml和所有的子目錄 |
${basedir}/src/main/java | 項(xiàng)目的java源代碼 |
${basedir}/src/main/resources | 項(xiàng)目的資源困肩,比如說property文件,springmvc.xml |
${basedir}/src/test/java | 項(xiàng)目的測(cè)試類,比如說Junit代碼 |
${basedir}/src/test/resources | 測(cè)試用的資源 |
${basedir}/src/main/webapp/WEB-INF | web應(yīng)用文件目錄枷畏,web項(xiàng)目的信息叉跛,比如存放web.xml、本地圖片潭枣、jsp視圖頁面 |
${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ù)目錄位置 |
1.5 Maven特點(diǎn)
- 項(xiàng)目設(shè)置遵循統(tǒng)一的規(guī)則。
- 任意工程中共享幻捏。
- 依賴管理包括自動(dòng)更新盆犁。
- 一個(gè)龐大且不斷增長(zhǎng)的庫(kù)。
- 可擴(kuò)展篡九,能夠輕松編寫 Java 或腳本語言的插件谐岁。
- 只需很少或不需要額外配置即可即時(shí)訪問新功能。
- 基于模型的構(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)建過程相同的元數(shù)據(jù)航揉,Maven 能夠生成一個(gè)網(wǎng)站或PDF,包括您要添加的任何文檔金刁,并添加到關(guān)于項(xiàng)目開發(fā)狀態(tài)的標(biāo)準(zhǔn)報(bào)告中帅涂。
- 發(fā)布管理和發(fā)布單獨(dú)的輸出 ? 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)目依賴,無需使用版本號(hào)求晶,并行構(gòu)建 ? 編譯的速度能普遍提高20 - 50 %焰雕。
- 更好的錯(cuò)誤報(bào)告 ? Maven 改進(jìn)了錯(cuò)誤報(bào)告,它為您提供了 Maven wiki 頁面的鏈接芳杏,您可以點(diǎn)擊鏈接查看錯(cuò)誤的完整描述矩屁。
1.6 Maven中的有兩大核心
- 依賴管理:對(duì)jar的統(tǒng)一管理(Maven提供了一個(gè)Maven的中央倉(cāng)庫(kù)https://mvnrepository.com/,當(dāng)我們?cè)陧?xiàng)目中添加完依賴之后爵赵,Maven會(huì)自動(dòng)去中央倉(cāng)庫(kù)下載相關(guān)的依賴吝秕,并且解決依賴的依賴問題)
- 項(xiàng)目構(gòu)建:對(duì)項(xiàng)目進(jìn)行編譯、測(cè)試空幻、打包烁峭、部署、上傳到私服等
2. Maven 安裝
Maven是Java 項(xiàng)目秕铛,因此必須先安裝JDK约郁。
2.1 下載Maven
下載地址:http://maven.apache.org/download.cgi
2.2 解壓并配置
解壓后Maven本身的目錄結(jié)構(gòu)如下:
配置上我們只需要配置環(huán)境變量即可:
首先配置 MAVEN_HOME:
然后配置環(huán)境變量:
2.3 檢驗(yàn)安裝
命令行窗口輸入:mvn -v
如果打印出Maven信息,則證明安裝成功
★如果使用了 IntelliJ IDEA 但两,可以不用去額外下載 Maven鬓梅,直接使用 IDEA 中自帶的 Maven 插件即可。IntelliJ IDEA 中自帶的 Maven 插件在 \ideaIU-2019.2.4.win\plugins\maven\lib\maven3
Maven 的安裝整體上來說比較簡(jiǎn)單谨湘,只需要下載安裝包绽快,然后解壓并配置環(huán)境變量即可。不過紧阔,我一般其實(shí)建議大家使用 IDEA 自帶的 Maven 插件谎僻,主要是用著方便。
3. Maven配置
實(shí)際上寓辱,沒有特殊需求的話,安裝好之后直接就可以用了赤拒。一般來說秫筏,還是需要稍微配置一下诱鞠,比如中央倉(cāng)庫(kù)的問題。默認(rèn)使用 Maven 自己的中央倉(cāng)庫(kù)这敬,使用起來網(wǎng)速比較慢航夺,這個(gè)時(shí)候,可以通過修改配置文件崔涂,將倉(cāng)庫(kù)改成國(guó)內(nèi)的鏡像倉(cāng)庫(kù)阳掐,國(guó)內(nèi)倉(cāng)庫(kù)使用較多的是阿里巴巴的倉(cāng)庫(kù)。
3.1 倉(cāng)庫(kù)類型
Maven有3種倉(cāng)庫(kù)類型:本地倉(cāng)庫(kù)冷蚂、私服倉(cāng)庫(kù)缭保、中央倉(cāng)庫(kù)
倉(cāng)庫(kù)類型 | 說明 |
---|---|
本地倉(cāng)庫(kù) | 就是你自己電腦上的倉(cāng)庫(kù),每個(gè)人電腦上都有一個(gè)倉(cāng)庫(kù) 默認(rèn)位置在當(dāng)前用戶名.m2\repository |
私服倉(cāng)庫(kù) | 一般來說是公司內(nèi)部搭建的Maven私服蝙茶,處于局域網(wǎng)中艺骂,訪問速度較快 這個(gè)倉(cāng)庫(kù)中存放的jar 一般就是公司內(nèi)部自己開發(fā)的jar |
中央倉(cāng)庫(kù) | 由Apache 團(tuán)隊(duì)來維護(hù),包含了大部分的jar 早期不包含Oracle 數(shù)據(jù)庫(kù)驅(qū)動(dòng)隆夯,從 2019 年8月開始钳恕,包含了Oracle驅(qū)動(dòng) |
現(xiàn)在存在3個(gè)倉(cāng)庫(kù),那么jar包如何查找呢蹄衷?
3.2 本地倉(cāng)庫(kù)配置
本地倉(cāng)庫(kù)默認(rèn)位置在當(dāng)前用戶名.m2\repository忧额,這個(gè)位置可以自定義,但是不建議大家自定義這個(gè)地址愧口,有幾個(gè)原因:
- 雖然所有的本地的 jar 都放在這個(gè)倉(cāng)庫(kù)中睦番,但是并不會(huì)占用很大的空間。
- 默認(rèn)的位置比較隱蔽调卑,不容易碰到
當(dāng)然是可以自定義本地倉(cāng)庫(kù)位置的抡砂,在 conf/settings.xml 中自定義本地倉(cāng)庫(kù)位置:
3.3 遠(yuǎn)程鏡像配置
由于默認(rèn)的中央倉(cāng)庫(kù)下載較慢,因此恬涧,也可以將遠(yuǎn)程倉(cāng)庫(kù)地址改為阿里巴巴的倉(cāng)庫(kù)地址:
<mirror>
<id>nexus-aliyun</id>
<mirrorOf>central</mirrorOf>
<name>Nexus aliyun</name>
<url>http://maven.aliyun.com/nexus/content/groups/public</url>
</mirror>
這段配置注益,加在 settings.xml 中的 mirrors 節(jié)點(diǎn)中:
4. POM詳解
POM的全稱是Project Object Model(項(xiàng)目對(duì)象模型 ) 。
它是 Maven 工程的基本工作單元溯捆,是一個(gè)XML文件丑搔,包含了項(xiàng)目的基本信息,用于描述項(xiàng)目如何構(gòu)建提揍,聲明項(xiàng)目依賴啤月,等等。
執(zhí)行任務(wù)或目標(biāo)時(shí)劳跃,Maven 會(huì)在當(dāng)前目錄中查找 POM谎仲。它讀取 POM,獲取所需的配置信息刨仑,然后執(zhí)行目標(biāo)郑诺。
POM 中可以指定以下配置:
- 項(xiàng)目依賴
- 插件
- 執(zhí)行目標(biāo)
- 項(xiàng)目構(gòu)建profile
- 項(xiàng)目版本
- 項(xiàng)目開發(fā)者列表
- 相關(guān)郵件列表信息
在創(chuàng)建 POM 之前夹姥,我們首先需要描述項(xiàng)目組 (groupId), 項(xiàng)目的唯一ID。
<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來區(qū)分的 -->
<artifactId>project</artifactId>
<!-- 版本號(hào) -->
<version>1.0</version>
</project>
所有POM文件都需要 project 元素和三個(gè)必需字段:groupId,artifactId较店,version士八。
節(jié)點(diǎn) | 描述 |
---|---|
project | 工程的根標(biāo)簽 |
modelVersion | 模型版本需要設(shè)置為 4.0.0 |
groupId | 這是工程組的標(biāo)識(shí)。它在一個(gè)組織或者項(xiàng)目中通常是唯一的泽西。 例如:一個(gè)銀行組織 com.companyname.project-group 擁有所有的和銀行相關(guān)的項(xiàng)目曹铃。 |
artifactId | 這是工程的標(biāo)識(shí),它通常是工程的名稱捧杉。 例如:消費(fèi)者銀行陕见。groupId 和 artifactId 一起定義了 artifact 在倉(cāng)庫(kù)中的位置。 |
version | 這是工程的版本號(hào)味抖。在 artifact 的倉(cāng)庫(kù)中评甜,它用來區(qū)分不同的版本。例如:com.company.bank:consumer-banking:1.0 com.company.bank:consumer-banking:1.1
|
4.1 父POM
父(Super)POM是 Maven 默認(rèn)的POM仔涩。
所有的 POM 都繼承自一個(gè)父 POM(無論是否顯式定義了這個(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 去下載。
Maven使用effective pom(Super pom 加上工程自己的配置)來執(zhí)行相關(guān)的目標(biāo)霞揉,它幫助開發(fā)者在 pom.xml 中做盡可能少的配置旬薯,當(dāng)然這些配置可以被重寫。
使用以下命令來查看 Super POM默認(rèn)配置:mvn help:effective-pom
接下來我們創(chuàng)建目錄 MVN/project适秩,在該目錄下創(chuàng)建 pom.xml绊序,內(nèi)容如下:
<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來區(qū)分的 -->
<artifactId>project</artifactId>
<!-- 版本號(hào) -->
<version>1.0</version>
</project>
在命令控制臺(tái)阶捆,進(jìn)入 MVN/project 目錄,執(zhí)行以下命令:
C:\MVN\project>mvn help:effective-pom
Maven 將會(huì)開始處理并顯示 effective-pom。
[INFO] Scanning for projects...
Downloading: https://repo.maven.apache.org/maven2/org/apache/maven/plugins/maven-clean-plugin/2.5/maven-clean-plugin-2.5.pom
...
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 01:36 min
[INFO] Finished at: 2018-09-05T11:31:28+08:00
[INFO] Final Memory: 15M/149M
[INFO] ------------------------------------------------------------------------
Effective POM的結(jié)果就像在控制臺(tái)中顯示的一樣趁猴,經(jīng)過繼承刊咳、插值之后,使配置生效儡司。
<?xml version="1.0" encoding="UTF-8"?>
<!-- ================================================================= -->
<!-- -->
<!-- Generated by Maven Help Plugin on 2012-07-05T11:41:51 -->
<!-- See: http://maven.apache.org/plugins/maven-help-plugin/ -->
<!-- -->
<!-- ================================================================= -->
<!-- ================================================================= -->
<!-- -->
<!-- Effective POM for project -->
<!-- 'com.companyname.project-group:project-name:jar:1.0' -->
<!-- -->
<!-- ================================================================= -->
<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 h
ttp://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.companyname.project-group</groupId>
<artifactId>project</artifactId>
<version>1.0</version>
<build>
<sourceDirectory>C:\MVN\project\src\main\java</sourceDirectory>
<scriptSourceDirectory>src/main/scripts</scriptSourceDirectory>
<testSourceDirectory>C:\MVN\project\src\test\java</testSourceDirectory>
<outputDirectory>C:\MVN\project\target\classes</outputDirectory>
<testOutputDirectory>C:\MVN\project\target\test-classes</testOutputDirectory>
<resources>
<resource>
<mergeId>resource-0</mergeId>
<directory>C:\MVN\project\src\main\resources</directory>
</resource>
</resources>
<testResources>
<testResource>
<mergeId>resource-1</mergeId>
<directory>C:\MVN\project\src\test\resources</directory>
</testResource>
</testResources>
<directory>C:\MVN\project\target</directory>
<finalName>project-1.0</finalName>
<pluginManagement>
<plugins>
<plugin>
<artifactId>maven-antrun-plugin</artifactId>
<version>1.3</version>
</plugin>
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<version>2.2-beta-2</version>
</plugin>
<plugin>
<artifactId>maven-clean-plugin</artifactId>
<version>2.2</version>
</plugin>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>2.0.2</version>
</plugin>
<plugin>
<artifactId>maven-dependency-plugin</artifactId>
<version>2.0</version>
</plugin>
<plugin>
<artifactId>maven-deploy-plugin</artifactId>
<version>2.4</version>
</plugin>
<plugin>
<artifactId>maven-ear-plugin</artifactId>
<version>2.3.1</version>
</plugin>
<plugin>
<artifactId>maven-ejb-plugin</artifactId>
<version>2.1</version>
</plugin>
<plugin>
<artifactId>maven-install-plugin</artifactId>
<version>2.2</version>
</plugin>
<plugin>
<artifactId>maven-jar-plugin</artifactId>
<version>2.2</version>
</plugin>
<plugin>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.5</version>
</plugin>
<plugin>
<artifactId>maven-plugin-plugin</artifactId>
<version>2.4.3</version>
</plugin>
<plugin>
<artifactId>maven-rar-plugin</artifactId>
<version>2.2</version>
</plugin>
<plugin>
<artifactId>maven-release-plugin</artifactId>
<version>2.0-beta-8</version>
</plugin>
<plugin>
<artifactId>maven-resources-plugin</artifactId>
<version>2.3</version>
</plugin>
<plugin>
<artifactId>maven-site-plugin</artifactId>
<version>2.0-beta-7</version>
</plugin>
<plugin>
<artifactId>maven-source-plugin</artifactId>
<version>2.0.4</version>
</plugin>
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.4.3</version>
</plugin>
<plugin>
<artifactId>maven-war-plugin</artifactId>
<version>2.1-alpha-2</version>
</plugin>
</plugins>
</pluginManagement>
<plugins>
<plugin>
<artifactId>maven-help-plugin</artifactId>
<version>2.1.1</version>
</plugin>
</plugins>
</build>
<repositories>
<repository>
<snapshots>
<enabled>false</enabled>
</snapshots>
<id>central</id>
<name>Maven Repository Switchboard</name>
<url>http://repo1.maven.org/maven2</url>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<releases>
<updatePolicy>never</updatePolicy>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
<id>central</id>
<name>Maven Plugin Repository</name>
<url>http://repo1.maven.org/maven2</url>
</pluginRepository>
</pluginRepositories>
<reporting>
<outputDirectory>C:\MVN\project\target/site</outputDirectory>
</reporting>
</project>
在上面的 pom.xml 中,你可以看到 Maven 在執(zhí)行目標(biāo)時(shí)需要用到的默認(rèn)工程源碼目錄結(jié)構(gòu)余指、輸出目錄捕犬、需要的插件、倉(cāng)庫(kù)和報(bào)表目錄酵镜。
Maven的pom.xml文件也不需要手工編寫碉碉。
Maven提供了大量的原型插件來創(chuàng)建工程,包括工程結(jié)構(gòu)和pom.xml淮韭。
4.2POM標(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)目中沒有規(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)件。換句話說择同,你不能有兩個(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)目主頁的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īng)該修改你自己的索引頁文件,而不是調(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)目的問題管理系統(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)建完成時(shí)往产,需要通知的開發(fā)者/用戶的配置項(xiàng)被碗。包括被通知者信息和通知條件(錯(cuò)誤,失敗仿村,成功锐朴,警告) -->
<notifiers>
<!--配置一種方式,當(dāng)構(gòu)建中斷時(shí)蔼囊,以該方式通知用戶/開發(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)目開發(fā)者列表 -->
<developers>
<!--某個(gè)項(xiàng)目開發(fā)者的信息 -->
<developer>
<!--SCM里項(xiàng)目開發(fā)者的唯一標(biāo)識(shí)符 -->
<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ā)者屬性录平,如即時(shí)消息如何處理等 -->
<properties>
<dept>No</dept>
</properties>
<!--項(xiàng)目開發(fā)者所在時(shí)區(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列表表箭。如果列出多個(gè)license,用戶可以選擇它們中的一個(gè)而不是接受所有l(wèi)icense钮莲。 -->
<licenses>
<!--描述了項(xiàng)目的license免钻,用于生成項(xiàng)目的web站點(diǎn)的license頁面,其他一些報(bào)表和validation也會(huì)用到該元素崔拥。 -->
<license>
<!--license用于法律上的名稱 -->
<name>Apache 2</name>
<!--官方的license正文頁面的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>
<!--給開發(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庫(kù)(例如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)目的時(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 />
<!--被編譯過的應(yīng)用程序class文件存放的目錄户矢。 -->
<outputDirectory />
<!--被編譯過的測(cè)試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 叫做階段)時(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)的所有資源路徑,參見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)打開時(shí),使用到的過濾器屬性文件列表 -->
<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)建過程中的目標(biāo)凳兵,或者匹配繼承過程中需要合并的執(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>
<!--參見dependencies/dependency元素 -->
<dependency>
......
</dependency>
</dependencies>
<!--任何配置是否被傳播到子項(xiàng)目 -->
<inherited />
<!--作為DOM對(duì)象的配置 -->
<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庐扫,如果被激活,會(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的開啟鑰匙萨醒。profile的力量來自于它 能夠在某些特定的環(huán)境中自動(dòng)使用某些特定的值;這些環(huán)境通過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開頭的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中通過${名稱}引用)埃元,其擁有對(duì)應(yīng)的名稱和值涝涤,Profile就會(huì)被激活。如果值 字段是空的岛杀,那么存在屬性名稱字段就會(huì)激活profile阔拳,否則按區(qū)分大小寫方式匹配屬性值字段 -->
<property>
<!--激活profile的屬性的名稱 -->
<name>mavenVersion</name>
<!--激活profile的屬性的值 -->
<value>2.0.3</value>
</property>
<!--提供一個(gè)文件名,通過檢測(cè)該文件的存在或不存在來激活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)目所需要的信息搔预。參見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>
<!--模塊(有時(shí)稱作子項(xiàng)目) 被構(gòu)建成項(xiàng)目的一部分霹期。列出的每個(gè)模塊元素是指向該模塊的目錄的相對(duì)路徑 -->
<modules />
<!--發(fā)現(xiàn)依賴和擴(kuò)展的遠(yuǎn)程倉(cāng)庫(kù)列表。 -->
<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)程倉(cāng)庫(kù)列表斯撮,這些插件用于構(gòu)建和報(bào)表 -->
<pluginRepositories>
<!--包含需要連接到遠(yuǎn)程插件倉(cāng)庫(kù)的信息.參見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)建過程中的一個(gè)個(gè)環(huán)節(jié)。它們自動(dòng)從項(xiàng)目定義的倉(cāng)庫(kù)中下載勿锅。要獲取更多信息帕膜,請(qǐ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)表就會(huì)運(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>
<!--模塊(有時(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ā)布版吞鸭,快照版)開啟寺董。 -->
<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ì)決定只為開發(fā)目的開啟對(duì)快照版本下載的支持划滋。參見repositories/repository/releases元素 -->
<snapshots>
<enabled />
<updatePolicy />
<checksumPolicy />
</snapshots>
<!--遠(yuǎn)程倉(cāng)庫(kù)唯一標(biāo)識(shí)符饵筑。可以用來匹配在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ù)的信息.參見repositories/repository元素 -->
<pluginRepository>
......
</pluginRepository>
</pluginRepositories>
<!--該元素描述了項(xiàng)目相關(guān)的所有依賴裤纹。 這些依賴組成了項(xiàng)目構(gòu)建過程中的一個(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編譯器,你就可以使用分類器來生成兩個(gè)單獨(dú)的JAR構(gòu)件。 -->
<classifier></classifier>
<!--依賴范圍优训。在項(xiàng)目發(fā)布過程中搁吓,幫助決定哪些構(gòu)件被包括進(jìn)來。欲知詳情請(qǐng)參考依賴機(jī)制寓娩。 - compile :默認(rèn)范圍叛氨,用于編譯 - provided:類似于編譯呼渣,但支持你期待jdk或者容器提供,類似于classpath
- runtime: 在執(zhí)行時(shí)需要使用 - test: 用于test任務(wù)時(shí)使用 - system: 需要外在提供相應(yīng)的元素寞埠。通過systemPath來取得
- 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)目的依賴姐直。此元素主要用于解決版本沖突問題 -->
<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)行科展。 在頁面導(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以外的一些信息沒有描述浑测,則通過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)程倉(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)槐雾?參見repositories/repository元素 -->
<uniqueVersion />
<id>banseon-maven2</id>
<name>banseon maven2</name>
<url>file://${basedir}/target/deploy</url>
<layout />
</repository>
<!--構(gòu)件的快照部署到哪里?如果沒有配置該元素幅狮,默認(rèn)部署到repository元素配置的倉(cāng)庫(kù),參見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í)符株灸,用來匹配站點(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)該參考主頁逐抑。使用該元素的原因是:幫助定位那些不在倉(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)換過來),partner(直接從伙伴Maven 2倉(cāng)庫(kù)同步過來)汇四,deployed(從Maven 2實(shí)例部 署)接奈,verified(被核實(shí)時(shí)正確的和最終的)。 -->
<status />
</distributionManagement>
<!--以值替代名稱通孽,Properties可以在整個(gè)POM中使用序宦,也可以作為觸發(fā)條件(見settings.xml配置文件里activation元素的說明)。格式是<name>value</name>背苦。 -->
<properties />
</project>
5. Maven構(gòu)建生命周期
Maven 構(gòu)建生命周期定義了一個(gè)項(xiàng)目構(gòu)建跟發(fā)布的過程互捌。
一個(gè)典型的 Maven 構(gòu)建(build)生命周期是由以下幾個(gè)階段的序列組成的:
階段 | 處理 | 描述 |
---|---|---|
驗(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ù)中疫剃,以共享給其他開發(fā)人員和工程 |
為了完成 default 生命周期,這些階段(包括其他未在上面羅列的生命周期階段)將被按順序地執(zhí)行硼讽。
5.1 Maven 有以下三個(gè)標(biāo)準(zhǔn)的生命周期:
- clean:項(xiàng)目清理的處理
- default(或 build):項(xiàng)目部署的處理
- site:項(xiàng)目站點(diǎn)文檔創(chuàng)建的處理
5.2 構(gòu)建階段由插件目標(biāo)構(gòu)成
一個(gè)插件目標(biāo)代表一個(gè)特定的任務(wù)(比構(gòu)建階段更為精細(xì))巢价,這有助于項(xiàng)目的構(gòu)建和管理。
這些目標(biāo)可能被綁定到多個(gè)階段或者無綁定固阁。不綁定到任何構(gòu)建階段的目標(biāo)可以在構(gòu)建生命周期之外通過直接調(diào)用執(zhí)行壤躲。
這些目標(biāo)的執(zhí)行順序取決于調(diào)用目標(biāo)和構(gòu)建階段的順序。
例如备燃,考慮下面的命令:
clean 和 pakage 是構(gòu)建階段碉克,dependency:copy-dependencies 是目標(biāo)
mvn clean dependency:copy-dependencies package
這里的 clean 階段將會(huì)被首先執(zhí)行,然后 dependency:copy-dependencies 目標(biāo)會(huì)被執(zhí)行并齐,最終 package 階段被執(zhí)行漏麦。
5.3 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)行.
也就是說捏膨,如果執(zhí)行 mvn clean
將運(yùn)行以下兩個(gè)生命周期階段:
pre-clean, clean
如果我們運(yùn)行mvn post-clean
,則運(yùn)行以下三個(gè)生命周期階段:
pre-clean, clean, post-clean
我們可以通過在上面的 clean 生命周期的任何階段定義目標(biāo)來修改這部分的操作行為。
在下面的例子中号涯,我們將 maven-antrun-plugin:run 目標(biāo)添加到 pre-clean目胡、clean 和 post-clean 階段中。這樣我們可以在 clean 生命周期的各個(gè)階段顯示文本信息链快。
我們已經(jīng)在 C:\MVN\project 目錄下創(chuàng)建了一個(gè) pom.xml 文件誉己。
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.companyname.projectgroup</groupId>
<artifactId>project</artifactId>
<version>1.0</version>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-antrun-plugin</artifactId>
<version>1.1</version>
<executions>
<execution>
<id>id.pre-clean</id>
<phase>pre-clean</phase>
<goals>
<goal>run</goal>
</goals>
<configuration>
<tasks>
<echo>pre-clean phase</echo>
</tasks>
</configuration>
</execution>
<execution>
<id>id.clean</id>
<phase>clean</phase>
<goals>
<goal>run</goal>
</goals>
<configuration>
<tasks>
<echo>clean phase</echo>
</tasks>
</configuration>
</execution>
<execution>
<id>id.post-clean</id>
<phase>post-clean</phase>
<goals>
<goal>run</goal>
</goals>
<configuration>
<tasks>
<echo>post-clean phase</echo>
</tasks>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
現(xiàn)在打開命令控制臺(tái),跳轉(zhuǎn)到 pom.xml 所在目錄久又,并執(zhí)行下面的 mvn 命令:
C:\MVN\project>mvn post-clean
Maven 將會(huì)開始處理并顯示 clean 生命周期的所有階段巫延。
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------
[INFO] Building Unnamed - com.companyname.projectgroup:project:jar:1.0
[INFO] task-segment: [post-clean]
[INFO] ------------------------------------------------------------------
[INFO] [antrun:run {execution: id.pre-clean}]
[INFO] Executing tasks
[echo] pre-clean phase
[INFO] Executed tasks
[INFO] [clean:clean {execution: default-clean}]
[INFO] [antrun:run {execution: id.clean}]
[INFO] Executing tasks
[echo] clean phase
[INFO] Executed tasks
[INFO] [antrun:run {execution: id.post-clean}]
[INFO] Executing tasks
[echo] post-clean phase
[INFO] Executed tasks
[INFO] ------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------
[INFO] Total time: < 1 second
[INFO] Finished at: Sat Jul 07 13:38:59 IST 2012
[INFO] Final Memory: 4M/44M
[INFO] ------------------------------------------------------------------
你可以嘗試修改 mvn clean 命令,來顯示 pre-clean 和 clean地消,而在 post-clean 階段不執(zhí)行任何操作炉峰。
5.4 Default (Build) 生命周期
這是 Maven 的主要生命周期,被用于構(gòu)建應(yīng)用脉执,包括下面的 23 個(gè)階段:
生命周期階段 | 描述 |
---|---|
validate(校驗(yàn)) | 校驗(yàn)項(xiàng)目是否正確并且所有必要的信息可以完成項(xiàng)目的構(gòu)建過程疼阔。 |
initialize(初始化) | 初始化構(gòu)建狀態(tài),比如設(shè)置屬性值半夷。 |
generate-sources(生成源代碼) | 生成包含在編譯階段中的任何源代碼婆廊。 |
process-sources(處理源代碼) | 處理源代碼,比如說巫橄,過濾任意值淘邻。 |
generate-resources(生成資源文件) | 生成將會(huì)包含在項(xiàng)目包中的資源文件。 |
process-resources (處理資源文件) | 復(fù)制和處理資源到目標(biāo)目錄湘换,為打包階段最好準(zhǔn)備宾舅。 |
compile(編譯) | 編譯項(xiàng)目的源代碼。 |
process-classes(處理類文件) | 處理編譯生成的文件彩倚,比如說對(duì)Java class文件做字節(jié)碼改善優(yōu)化筹我。 |
generate-test-sources(生成測(cè)試源代碼) | 生成包含在編譯階段中的任何測(cè)試源代碼。 |
process-test-sources(處理測(cè)試源代碼) | 處理測(cè)試源代碼帆离,比如說蔬蕊,過濾任意值。 |
generate-test-resources(生成測(cè)試資源文件) | 為測(cè)試創(chuàng)建資源文件哥谷。 |
process-test-resources(處理測(cè)試資源文件) | 復(fù)制和處理測(cè)試資源到目標(biāo)目錄岸夯。 |
test-compile(編譯測(cè)試源碼) | 編譯測(cè)試源代碼到測(cè)試目標(biāo)目錄. |
process-test-classes(處理測(cè)試類文件) | 處理測(cè)試源碼編譯生成的文件。 |
test(測(cè)試) | 使用合適的單元測(cè)試框架運(yùn)行測(cè)試(Juint是其中之一)们妥。 |
prepare-package(準(zhǔn)備打包) | 在實(shí)際打包之前猜扮,執(zhí)行任何的必要的操作為打包做準(zhǔn)備。 |
package(打包) | 將編譯后的代碼打包成可分發(fā)格式的文件王悍,比如JAR、WAR或者EAR文件餐曼。 |
pre-integration-test(集成測(cè)試前) | 在執(zhí)行集成測(cè)試前進(jìn)行必要的動(dòng)作压储。比如說鲜漩,搭建需要的環(huán)境。 |
integration-test(集成測(cè)試) | 處理和部署項(xiàng)目到可以運(yùn)行集成測(cè)試環(huán)境中集惋。 |
post-integration-test(集成測(cè)試后) | 在執(zhí)行集成測(cè)試完成后進(jìn)行必要的動(dòng)作孕似。比如說,清理集成測(cè)試環(huán)境刮刑。 |
verify (驗(yàn)證) | 運(yùn)行任意的檢查來驗(yàn)證項(xiàng)目包有效且達(dá)到質(zhì)量標(biāo)準(zhǔn)喉祭。 |
install(安裝) | 安裝項(xiàng)目包到本地倉(cāng)庫(kù),這樣項(xiàng)目包可以用作其他本地項(xiàng)目的依賴雷绢。 |
deploy(部署) | 將最終的項(xiàng)目包復(fù)制到遠(yuǎn)程倉(cāng)庫(kù)中與其他開發(fā)者和項(xiàng)目共享泛烙。 |
有一些與 Maven 生命周期相關(guān)的重要概念需要說明:
- 當(dāng)一個(gè)階段通過 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 生命周期的一部分階段中。這樣我們可以顯示生命周期的文本信息踪宠。
我們已經(jīng)更新了 C:\MVN\project 目錄下的 pom.xml 文件自赔。
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.companyname.projectgroup</groupId>
<artifactId>project</artifactId>
<version>1.0</version>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-antrun-plugin</artifactId>
<version>1.1</version>
<executions>
<execution>
<id>id.validate</id>
<phase>validate</phase>
<goals>
<goal>run</goal>
</goals>
<configuration>
<tasks>
<echo>validate phase</echo>
</tasks>
</configuration>
</execution>
<execution>
<id>id.compile</id>
<phase>compile</phase>
<goals>
<goal>run</goal>
</goals>
<configuration>
<tasks>
<echo>compile phase</echo>
</tasks>
</configuration>
</execution>
<execution>
<id>id.test</id>
<phase>test</phase>
<goals>
<goal>run</goal>
</goals>
<configuration>
<tasks>
<echo>test phase</echo>
</tasks>
</configuration>
</execution>
<execution>
<id>id.package</id>
<phase>package</phase>
<goals>
<goal>run</goal>
</goals>
<configuration>
<tasks>
<echo>package phase</echo>
</tasks>
</configuration>
</execution>
<execution>
<id>id.deploy</id>
<phase>deploy</phase>
<goals>
<goal>run</goal>
</goals>
<configuration>
<tasks>
<echo>deploy phase</echo>
</tasks>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
現(xiàn)在打開命令控制臺(tái),跳轉(zhuǎn)到 pom.xml 所在目錄柳琢,并執(zhí)行以下 mvn 命令:
C:\MVN\project>mvn compile
Maven 將會(huì)開始處理并顯示直到編譯階段的構(gòu)建生命周期的各個(gè)階段:
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------
[INFO] Building Unnamed - com.companyname.projectgroup:project:jar:1.0
[INFO] task-segment: [compile]
[INFO] ------------------------------------------------------------------
[INFO] [antrun:run {execution: id.validate}]
[INFO] Executing tasks
[echo] validate phase
[INFO] Executed tasks
[INFO] [resources:resources {execution: default-resources}]
[WARNING] Using platform encoding (Cp1252 actually) to copy filtered resources,
i.e. build is platform dependent!
[INFO] skip non existing resourceDirectory C:\MVN\project\src\main\resources
[INFO] [compiler:compile {execution: default-compile}]
[INFO] Nothing to compile - all classes are up to date
[INFO] [antrun:run {execution: id.compile}]
[INFO] Executing tasks
[echo] compile phase
[INFO] Executed tasks
[INFO] ------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------
[INFO] Total time: 2 seconds
[INFO] Finished at: Sat Jul 07 20:18:25 IST 2012
[INFO] Final Memory: 7M/64M
[INFO] ------------------------------------------------------------------
5.5 Site 生命周期
Maven Site 插件一般用來創(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 生命周期的所有階段中璧榄。這樣我們可以顯示生命周期的所有文本信息租漂。
我們已經(jīng)更新了 C:\MVN\project 目錄下的 pom.xml 文件:
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.companyname.projectgroup</groupId>
<artifactId>project</artifactId>
<version>1.0</version>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-antrun-plugin</artifactId>
<version>1.1</version>
<executions>
<execution>
<id>id.pre-site</id>
<phase>pre-site</phase>
<goals>
<goal>run</goal>
</goals>
<configuration>
<tasks>
<echo>pre-site phase</echo>
</tasks>
</configuration>
</execution>
<execution>
<id>id.site</id>
<phase>site</phase>
<goals>
<goal>run</goal>
</goals>
<configuration>
<tasks>
<echo>site phase</echo>
</tasks>
</configuration>
</execution>
<execution>
<id>id.post-site</id>
<phase>post-site</phase>
<goals>
<goal>run</goal>
</goals>
<configuration>
<tasks>
<echo>post-site phase</echo>
</tasks>
</configuration>
</execution>
<execution>
<id>id.site-deploy</id>
<phase>site-deploy</phase>
<goals>
<goal>run</goal>
</goals>
<configuration>
<tasks>
<echo>site-deploy phase</echo>
</tasks>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
現(xiàn)在打開命令控制臺(tái)材泄,跳轉(zhuǎn)到 pom.xml 所在目錄创淡,并執(zhí)行以下 mvn 命令:
C:\MVN\project>mvn site
Maven 將會(huì)開始處理并顯示直到 site 階段的 site 生命周期的各個(gè)階段:
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------
[INFO] Building Unnamed - com.companyname.projectgroup:project:jar:1.0
[INFO] task-segment: [site]
[INFO] ------------------------------------------------------------------
[INFO] [antrun:run {execution: id.pre-site}]
[INFO] Executing tasks
[echo] pre-site phase
[INFO] Executed tasks
[INFO] [site:site {execution: default-site}]
[INFO] Generating "About" report.
[INFO] Generating "Issue Tracking" report.
[INFO] Generating "Project Team" report.
[INFO] Generating "Dependencies" report.
[INFO] Generating "Project Plugins" report.
[INFO] Generating "Continuous Integration" report.
[INFO] Generating "Source Repository" report.
[INFO] Generating "Project License" report.
[INFO] Generating "Mailing Lists" report.
[INFO] Generating "Plugin Management" report.
[INFO] Generating "Project Summary" report.
[INFO] [antrun:run {execution: id.site}]
[INFO] Executing tasks
[echo] site phase
[INFO] Executed tasks
[INFO] ------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------
[INFO] Total time: 3 seconds
[INFO] Finished at: Sat Jul 07 15:25:10 IST 2012
[INFO] Final Memory: 24M/149M
[INFO] ------------------------------------------------------------------
5.6 小結(jié):
Maven每個(gè)生命周期中都包含著一系列的階段(phase)版姑。
這些 phase 就相當(dāng)于 Maven 提供的統(tǒng)一的接口景埃,然后這些phase的實(shí)現(xiàn)由 Maven的插件來完成普泡。
我們?cè)谳斎雖vn 命令的時(shí)候您访,比如 mvn clean,clean 對(duì)應(yīng)的就是 Clean 生命周期中的 clean 階段精刷。但是 clean 的具體操作是由 maven-clean-plugin 來實(shí)現(xiàn)的拗胜。
所以說 Maven 生命周期的每一個(gè)階段的具體實(shí)現(xiàn)都是由Maven插件實(shí)現(xiàn)的
關(guān)于Maven插件的學(xué)習(xí):https://www.runoob.com/maven/maven-plugins.html
6. Maven常用命令
Maven中有一些常見的命令,如果使用Eclipse需要手動(dòng)敲命令怒允,如果使用 IDEA 的話埂软,可以不用命令,直接點(diǎn)點(diǎn)點(diǎn)就可以了:
常用命令 | 中文含義 | 說明 |
---|---|---|
mvn clean | 清理 | 這個(gè)命令可以用來清理已經(jīng)編譯好的文件 |
mvn compile | 編譯 | 將Java代碼編譯成Class 文件 |
mvn test | 測(cè)試 | 項(xiàng)目測(cè)試 |
mvn package | 打包 | 根據(jù)用戶的配置纫事,將項(xiàng)目打成jar包或者war包 |
mvn install | 安裝 | 手動(dòng)向本地倉(cāng)庫(kù)安裝一個(gè)jar |
mvn deploy | 上傳 | 將 jar 上傳到私服 |
這里需要注意的是勘畔,這些命令都不是獨(dú)立運(yùn)行的,它有一個(gè)順序丽惶。舉個(gè)簡(jiǎn)單例子:
我想將 jar 上傳到私服炫七,那么就要構(gòu)建 jar,就需要執(zhí)行package命令蚊夫,要打包诉字,當(dāng)然也需要測(cè)試,那就要走mvn test命令知纷,要測(cè)試就要先編譯.....壤圃,因此,最終所有的命令都會(huì)執(zhí)行一遍琅轧。不過伍绳,開發(fā)者也可以手動(dòng)配置不執(zhí)行某一個(gè)命令,這就是跳過乍桂。一般來是冲杀,除了測(cè)試,其他步驟都不建議跳過睹酌。
同時(shí)权谁,在執(zhí)行上述命令時(shí)我們還可以指定參數(shù),例如:
mvn clean deploy -Pdev
:指定發(fā)包到dev環(huán)境
mvn clean install -f api/pom.xml -Ptest
:將指定文件安裝到本地倉(cāng)庫(kù)(指定環(huán)境)
mvn clean package -Ptest -U
:指定測(cè)試環(huán)境打包憋沿,并強(qiáng)制Maven使用最新快照
mvn clean package -Dmaven.test.skip=true
:項(xiàng)目跳過測(cè)試打包
6.1 通過命令來構(gòu)建項(xiàng)目(了解)
可以直接通過命令來構(gòu)建一個(gè)Maven項(xiàng)目旺芽,不過在實(shí)際開發(fā)中,一般使用 Eclipse或者IDEA就可以直接創(chuàng)建Maven項(xiàng)目了辐啄。
創(chuàng)建命令:
mvn archetype:generate -DgroupId=org.javaboy -DartifactId=firstapp -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
看到如下提示采章,表示項(xiàng)目創(chuàng)建成功:
項(xiàng)目創(chuàng)建成功后,就兩個(gè)文件:
說明對(duì)一個(gè)任何一個(gè)項(xiàng)目而言壶辜,最最核心的就是這兩個(gè):
pom.xml 中悯舟,則定義了所有的項(xiàng)目配置:
6.2 對(duì)項(xiàng)目進(jìn)行打包
接下來,我們通過 mvn package 命令可以將剛剛創(chuàng)建的項(xiàng)目打成一個(gè) jar 包砸民。
在打包之前抵怎,需要配置 JDK 的版本至少為7以上奋救,因此,我們還需要手動(dòng)修改一下pom.xml 文件反惕,即添加如下配置:
添加完成后菠镇,執(zhí)行打包命令,注意執(zhí)行所有命令時(shí)承璃,命令行要定位到 pom.xml 文件所在的目錄,看到如下提示蚌本,表示項(xiàng)目打包成功:
6.3 將項(xiàng)目安裝到本地倉(cāng)庫(kù)
如果需要將項(xiàng)目安裝到本地倉(cāng)庫(kù)盔粹,可以直接執(zhí)行 mvn install 命令,注意程癌,mvn install 命令會(huì)包含上面的 mvn package 過程舷嗡。
安裝到本地倉(cāng)庫(kù)之后,這個(gè)時(shí)候嵌莉,點(diǎn)開自己的本地倉(cāng)庫(kù)进萄,就可以看到相關(guān)的 jar 了。
7. Maven的依賴管理
Maven 項(xiàng)目锐峭,如果需要使用第三方的控件中鼠,都是通過依賴管理來完成的。
這里用到的一個(gè)東西就是 pom.xml 文件沿癞,概念叫做項(xiàng)目對(duì)象模型(POM援雇,Project Object Model),我們?cè)?pom.xml 中定義了 Maven 項(xiàng)目的形式椎扬,所以惫搏,pom.xml 相當(dāng)于是 Maven 項(xiàng)目的一個(gè)地圖。就類似于 web.xml 文件用來描述三大web組件一樣蚕涤。
這個(gè)地圖中都涉及到哪些東西呢筐赔?
7.1 Maven 坐標(biāo)
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
</dependency>
</dependencies>
-
dependencies
在<dependencies>標(biāo)簽中,添加項(xiàng)目需要的jar所對(duì)應(yīng)的maven坐標(biāo)揖铜。 -
dependency
一個(gè)dependency標(biāo)簽表示一個(gè)坐標(biāo) -
groupId
團(tuán)體茴丰、公司、組織機(jī)構(gòu)等等的唯一標(biāo)識(shí)蛮位。
團(tuán)體標(biāo)識(shí)的約定是它以創(chuàng)建這個(gè)項(xiàng)目的組織名稱的逆向域名(例如 org.javaboy)開頭较沪。
一個(gè) Maven 坐標(biāo)必須要包含 groupId。一些典型的groupId如apache的groupId 是org.apache -
artifactId
artifactId 相當(dāng)于在一個(gè)組織中項(xiàng)目的唯一標(biāo)識(shí)符失仁。 -
version
一個(gè)項(xiàng)目的版本尸曼。一個(gè)項(xiàng)目的話,可能會(huì)有多個(gè)版本萄焦。如果是正在開發(fā)的項(xiàng)目控轿,我們可以給版本號(hào)加上一個(gè) SNAPSHOT冤竹,表示這是一個(gè)快照版(新建項(xiàng)目的默認(rèn)版本號(hào)就是快照版) -
scope
表示依賴范圍。
我們添加了很多依賴茬射,但是不同依賴的使用范圍是不一樣的鹦蠕。
最典型的有兩個(gè):
- 數(shù)據(jù)庫(kù)驅(qū)動(dòng)
數(shù)據(jù)庫(kù)驅(qū)動(dòng),在使用的過程中在抛,我們自己寫代碼钟病,寫的是 JDBC 代碼,只有在項(xiàng)目運(yùn)行時(shí)刚梭,才需要執(zhí)行 MySQL 驅(qū)動(dòng)中的代碼肠阱。所以,MySQL 驅(qū)動(dòng)這個(gè)依賴在添加到項(xiàng)目中之后朴读,可以設(shè)置它的 scope 為 runtime屹徘,編譯的時(shí)候不生效。 - 單元測(cè)試衅金。
單元測(cè)試噪伊,只在測(cè)試的時(shí)候生效,所以可以設(shè)置它的 scope 為 test氮唯,這樣鉴吹,當(dāng)項(xiàng)目打包發(fā)布時(shí),單元測(cè)試的依賴就不會(huì)跟著發(fā)布惩琉。
7.2 依賴傳遞性與繼承性
Maven的依賴具有繼承性拙寡,體現(xiàn)在子項(xiàng)目會(huì)繼承父項(xiàng)目中的依賴。
Maven的依賴具有傳遞性琳水,體現(xiàn)在A項(xiàng)目依賴了b.jar肆糕,b.jar中又依賴了c.jar,那么A項(xiàng)目中是可以訪問c.jar的在孝。
當(dāng)有依賴傳遞時(shí)需要注意:當(dāng)存在間接依賴的情況時(shí)诚啃,主工程對(duì)間接依賴的jar都是可以直接訪問嗎?
其實(shí)這要看間接依賴的jar包引入時(shí)的依賴范圍私沮,只有依賴范圍為compile時(shí)可以訪問
DependencyManagement 和 Dependencies的區(qū)別:
dependencyManagement統(tǒng)一管理項(xiàng)目的版本號(hào)始赎,只聲明依賴,并不實(shí)現(xiàn)引入仔燕,因此子項(xiàng)目需要顯示的聲明需要用的依賴造垛。
在子項(xiàng)目中寫了該依賴項(xiàng),并且沒有指定具體版本晰搀,會(huì)自動(dòng)從父項(xiàng)目中繼承該項(xiàng)五辽,并且version和scope都讀取自父pom;
另外如果子項(xiàng)目中指定了版本號(hào),那么會(huì)使用子項(xiàng)目中指定的jar版本外恕。而所有聲明在dependencies里的依賴都會(huì)自動(dòng)引入杆逗,并默認(rèn)會(huì)被所有的子項(xiàng)目(如果有子項(xiàng)目)繼承乡翅。
一般webapp的pom不能直接寫dependencies,需嵌套在dependencyManagement中罪郊。
7.3 依賴沖突與解決
依賴沖突產(chǎn)生的原因
在圖中蠕蚜,a.jar 依賴 b.jar,同時(shí) a.jar 依賴 d.jar悔橄,這個(gè)時(shí)候靶累,a 和 b、d 的關(guān)系是直接依賴的關(guān)系癣疟,a 和 c 的關(guān)系是間接依賴的關(guān)系尺铣。
Maven如何解決依賴沖突
Maven默認(rèn)使用如下原則進(jìn)行依賴的管理:
- 先定義先使用
- 路徑最近原則:短路優(yōu)先,誰離得最近就使用誰的依賴jar包
以 spring-context 為例争舞,下圖中 x 表示失效的依賴(優(yōu)先級(jí)低的依賴,即路徑近的依賴優(yōu)先使用):
為了便于理解澈灼,再舉個(gè)例子:
短路優(yōu)先:誰離得最近就使用誰的依賴jar包
C到達(dá)A為:C->B->A
C到達(dá)B為:C->B
例如:
A中的commons-io的版本為2.4
B中的commons-io的版本為2.0
C依賴于B竞川,B依賴于A
那么C的junit的包為2.0版本,因?yàn)橐蕾嚨亩搪穬?yōu)先如果兩條路都是一樣長(zhǎng)的時(shí)候呢叁熔?例如:
C到達(dá)A為C->A
C到達(dá)B為C->B
則看pom文件中依賴的兩個(gè)工程誰在前面就是用哪個(gè)版本委乌。但不一定生效 ,往往是這種路徑一致造成jar沖突
。
7.4 手動(dòng)排除依賴
我們可以通過 <exclusion>標(biāo)簽排除不想加入的依賴荣回,例如:
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>5.1.9.RELEASE</version>
<exclusions>
<exclusion>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
</exclusion>
</exclusions>
</dependency>
這個(gè)表示從 spring-context 中排除 spring-core 依賴
參考資料:https://mp.weixin.qq.com/s/9aMRFEXbh0-usVE96uZ8Ag
參考資料:https://www.runoob.com/maven/maven-tutorial.html