1、Maven概念html
Maven是一個項目管理和整合工具。Maven爲開發者提供了一套完整的構建生命週期框架。開發團隊幾乎不用花多少時間就可以自動完成工程的基礎構建配置,由於Maven使用了一個標準的目錄結構和一個默認的構建生命週期。java
如有多個開發團隊環境的狀況下,Maven可以在很短的時間內使得每項工做都按照標準進行。由於大部分的工程配置都很是簡單且可複用,在建立報告、檢查、構建和測試自動配置時,Maven可讓開發者的工做變得更簡單。web
Maven的主要目的是爲開發者提供:spring
一個可複用、可維護、更易理解的工程綜合模型,與這個模型交互的插件或工具apache
Maven工程結構和內容定義在一個xml文件中(通常是pom.xml)json
利用Maven構建項目過程階段:windows
2、Maven安裝配置設計模式
1. JDK安裝api
Maven是基於Java的工具,因此配置Maven要作的第一件事就是安裝JDK服務器
2. Windows安裝
Maven下載地址:http://maven.apache.org/download.html
下載解壓後,添加環境變量即完成
3. Linux安裝
① 配置yum源
# sudo yum install -y yum-utils # yum-config-manager --add-repo http://repos.fedorapeople.org/repos/dchen/apache-maven/epel-apache-maven.repo
② 安裝Maven
# yum install -y apache-maven
完成安裝後,經過mvn --version 檢驗安裝版本
3、Maven初體驗
Maven主要是用來打jar、war包以及管理jar包
1. 原始的javac打包方式
假如咱們有一個Hello.java文件,想要將它打成可執行jar包,通常這樣作。
使用 javac 命令和 jar 命令打包:
生成的jar包文件,由兩部分組成,class文件和META-INF目錄,以下:
此時的jar包,是不可直接運行的,須要指定入口main類
進入META-INF目錄,編輯MANIFEST.MF文件,以下:
運行此jar包,獲得運行結果:
2. maven打包
在pom文件內配置入口類
執行maven打包命令
mvn package
運行生成的jar,結果與原始方式無區別
4、POM結構
5、Maven流程
1. maven的理想
maven像一種什麼設計模式?答案:模板方法模式
自動走完標準的構建流程:清理->編譯->測試->報告->打包->部署
統一入口,全部配置在一個pom裏搞定
2. maven的約定
約定的目錄(不可改):
src/main/java –存放項目的.java文件 |
src/main/resources –存放項目資源文件。比方spring,hibernate配置文件 |
src/test/java –存放所有測試.java文件,比方JUnit測試類 |
src/test/resources ---測試資源文件 |
target ---項目輸出位置,編譯完畢後的東西放到這裏面 |
pom.xml |
3. maven的生命週期
maven的構建生命週期,只是一個抽象的規範流程。週期內的每一個階段的具體執行,是在插件裏面來實現的。
各個生命週期預設的定義以下:
階段 |
處理 |
描述 |
驗證 validate |
驗證項目 |
驗證項目是否正確且全部必須信息是可用的 |
編譯 compile |
執行編譯 |
源代碼編譯在此階段完成 |
測試 Test |
測試 |
使用適當的單元測試框架(例如JUnit)運行測試。 |
包裝 package |
打包 |
建立JAR/WAR包如在 pom.xml 中定義說起的包 |
檢查 verify |
檢查 |
對集成測試的結果進行檢查,以保證質量達標 |
安裝 install |
安裝 |
安裝打包的項目到本地倉庫,以供其餘項目使用 |
部署 deploy |
部署 |
拷貝最終的工程包到遠程倉庫中,以共享給其餘開發人員和工程 |
運行任何一個階段,都會從其所在生命週期的第一個階段開始,順序執行到指定的階段,如:
mvn package(本義:執行default週期的package階段,maven會自動從process-resources階段開始運行到package階段結束)
4. maven的插件
插件plugin是綁定到生命週期,承擔實際功能的組件。mvn運行時,自動關聯插件來運行
下圖是maven默認的各階段對應的插件列表:
生命週期 |
生命週期階段 |
插件目標 |
執行任務 |
clean |
pre-clean |
||
clean |
maven-clean-plugin:clean |
刪除項目的輸出目錄。 |
|
post-clean |
|||
site |
pre-site |
||
site |
maven-site-plugin:site |
||
post-site |
|||
site-deploy |
maven-site-plugin:deploy |
||
default |
process-resources |
maven-resources-plugin:resources |
複製主資源文件至主輸出目錄 |
compile |
maven-compiler-plugin:compile |
編譯主代碼至主輸出目錄 |
|
process-test-resources |
maven-resources-plugin:testResources |
複製測試資源文件至測試輸出目 |
|
test-compile |
maven-compiler-plugin:testCompile |
編譯測試代碼至測試輸出目錄 |
|
test |
maven-surefire-plugin:test |
執行測試用例 |
|
package |
maven-jar-plugin:jar(ejb:ejb jar:jar rar:rar war:war) |
建立項目jar包 |
|
install |
maven-install-plugin:install |
將項目輸出構件安裝到本地倉庫 |
|
deploy |
maven-deploy-plugin:deploy |
將項目輸出構件部署到遠程倉庫 |
6、經常使用Maven命令
mvn clean 清理
mvn compile 編譯主程序
mvn package 打包
mvn install 安裝jar到本地庫
使用maven命令生成項目(idea和eclipse生成項目最終也是依賴maven插件生成的):
mvn archetype:generate -DgroupId=enjoy -DartifactId=simple -DarchetypeArtifactId=maven-archetype-quickstart -Dversion=1.0
mvn archetype:generate -DgroupId=enjoy -DartifactId=simple-web -DarchetypeArtifactId=maven-archetype-webapp -Dversion=1.0
7、Maven插件開發
能夠自定義插件,來擴展maven的功能。插件的開發步驟以下:
1. 引入maven api依賴
2. 編寫簡單Mojo類(繼承AbstractMojo)
3. 執行插件
mvn com.enjoy:enjoy-plugin:1.0:log
4. 關聯插件到生命週期來執行
構建項目對應的生命週期
8、Maven座標與依賴
1. 座標
--------在數學中, 任何一個座標能夠惟一肯定一個「點」
Maven 中座標是Jar包的惟一標識
座標元素包括groupId、artifactId、version、packaging:
元素 | 描述 | 說明 |
groupId | 定義當前模塊隸屬的實際 Maven項目 |
中小企業經常直接對應公司、組織 |
artifactId | 定義實際項目中的一個Maven模塊 | 惟一標識一個模塊 |
version | 定義當前項目所屬版本 | SNAPSHOT:表示不穩定版本 LATEST:指最新發布的版本,多是個發佈版,也多是一個snapshot版本 RELEASE:指最後一個發佈版 |
packaging | 定義Maven項目打包方式 | 有jar(默認)、war、pom、maven-plugin等 |
dassifier | 附屬構建(如javadoc、sources) | 須有附加插件的幫助 |
2. 依賴
依賴即:A->B,B->C,C->D這種項目間的依存關係。
在java的jvm內,依賴的最終表現是,項目A啓動時,其依賴的jar包必須都對應放入其classpath路徑內。
3. 依賴傳遞
上述過程當中,項目Mall歸結起來,依賴的fastjson會有三個版本。
而咱們的jvm最終確定只能接受一個版本的jar,因此必須有所取捨。
maven默認的取捨規則是:
一、路徑最短原則:product和customer裏的fastjson引用路徑較短,路徑爲兩步;pay項目裏的fastjson引用路徑較長,路徑爲三步。所以pay中的fastjson被淘汰;
二、同路徑長度下,誰先聲明誰優先:product和customer中的fastjson路徑相同,那麼就看在pom中是先聲明product仍是先聲明customer,誰先用誰的。
4. 依賴衝突及解決
在依賴傳遞裏,咱們看到,maven根據本身的規則爲咱們取捨出了一個版本的jar,但此jar版本選擇可能會與咱們的項目預期不符:
例如:咱們最終想的版本是fastjson:1.2.30版本(但它在第一步即被淘汰掉了)
當出現此類狀況時,咱們項目運行可能會出錯(項目中使用到了1.2.30版本的特性),此問題便是咱們常遇到的jar包衝突問題。
補救方式:使用exclusions將product和customer中的fastjson包排除掉,用法以下圖:
當發生jar衝突程序報錯時,可使用mvn命令查出項目最終依賴的jar包樹,看版本是不是咱們預期的:
命令:mvn dependency:tree
5. 依賴範圍scope
mvn在運行時,生命週期的不一樣階段,會有不一樣的依賴範圍,通常有如下依賴範圍scope:
- compile:默認範圍,用於編譯(依賴的jar在打包時會包含進去)
- provided:相似於編譯,但支持你期待jdk或者容器提供,相似於classpath(依賴的jar在打包時不會包含進去)
- runtime:在執行時須要使用(依賴的jar在打包時會包含進去)
- test:用於test任務時使用(依賴的jar在打包時不會包含進去)
- system:須要外在提供相應的元素。經過systemPath來取得(通常禁止使用)
每一個scope其實是配置了一個不一樣的classpath,jvm根據選擇不一樣的classpath來達到依賴不一樣
9、環境激活-profiles使用
在springmvc項目中,開發/測試/線上三個不一樣環境,配置文件每每也不一樣。
打包時須要對配置文件作出選擇(maven提供了profiles機制供咱們使用)。
這個選擇,實際發生在default生命週期的resource階段(maven-resources-plugin執行過程裏)
2. 定義profiles
爲了指導插件將對應的resource文件打入classpath裏,先定出profiles
此定義即指,當mvn命令執行時,咱們須要經過 -P dev或者-P test方式傳入咱們的意圖:
dev/test選擇,會致使properties裏的變量值含義不一樣,咱們主要關注package.environment變量
3. 資源插件的配置指定
配置maven-resources-plugin插件執行時,要複製的目錄資源
4. mvn約定的資源中須要過濾掉環境目錄
須要將mvn約定的資源目錄裏,過濾掉環境目錄
5. 小屬性更輕便的用法
對於簡單的屬性,咱們能夠選擇更輕便的用法
① 直接在環境中定義屬性值
② 項目屬性文件配置
③ 約定的資源啓用替換過濾
最後有對pom.xml裏面各標籤有疑惑的小夥伴,下面附上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/maven-v4_0_0.xsd "> <!-- 父項目的座標。若是項目中沒有規定某個元素的值,那麼父項目中的對應值即爲項目的默認值。 座標包括group ID,artifact ID和 version。 --> <parent> <!-- 被繼承的父項目的構件標識符 --> <artifactId>xxx</artifactId> <!-- 被繼承的父項目的全球惟一標識符 --> <groupId>xxx</groupId> <!-- 被繼承的父項目的版本 --> <version>xxx</version> <!-- 父項目的pom.xml文件的相對路徑。相對路徑容許你選擇一個不一樣的路徑。默認值是../pom.xml。 Maven首先在構建當前項目的地方尋找父項目的pom,其次在文件系統的這個位置(relativePath位置), 而後在本地倉庫,最後在遠程倉庫尋找父項目的pom。 --> <relativePath>xxx</relativePath> </parent> <!-- 聲明項目描述符遵循哪個POM模型版本。模型自己的版本不多改變,雖然如此,但它仍然是必不可少的, 這是爲了當Maven引入了新的特性或者其餘模型變動的時候,確保穩定性。 --> <modelVersion> 4.0.0 </modelVersion> <!-- 項目的全球惟一標識符,一般使用全限定的包名區分該項目和其餘項目。而且構建時生成的路徑也是由今生成, 如com.mycompany.app生成的相對路徑爲:/com/mycompany/app --> <groupId>xxx</groupId> <!-- 構件的標識符,它和group ID一塊兒惟一標識一個構件。換句話說,你不能有兩個不一樣的項目擁有一樣的artifact ID 和groupID;在某個特定的group ID下,artifact ID也必須是惟一的。構件是項目產生的或使用的一個東西,Maven 爲項目產生的構件包括:JARs,源碼,二進制發佈和WARs等。 --> <artifactId>xxx</artifactId> <!-- 項目產生的構件類型,例如jar、war、ear、pom。插件能夠建立他們本身的構件類型,因此前面列的不是所有構件類型 --> <packaging> jar </packaging> <!-- 項目當前版本,格式爲:主版本.次版本.增量版本-限定版本號 --> <version> 1.0-SNAPSHOT </version> <!-- 項目的名稱, Maven產生的文檔用 --> <name> xxx-maven </name> <!-- 項目主頁的URL, Maven產生的文檔用 --> <url> http://maven.apache.org </url> <!-- 項目的詳細描述, Maven 產生的文檔用。 當這個元素可以用HTML格式描述時(例如,CDATA中的文本會被解析器忽略, 就能夠包含HTML標籤), 不鼓勵使用純文本描述。若是你須要修改產生的web站點的索引頁面,你應該修改你本身的 索引頁文件,而不是調整這裏的文檔。 --> <description> A maven project to study maven. </description> <!-- 描述了這個項目構建環境中的前提條件。 --> <prerequisites> <!-- 構建該項目或使用該插件所須要的Maven的最低版本 --> <maven></maven> </prerequisites> <!-- 項目的問題管理系統(Bugzilla, Jira, Scarab,或任何你喜歡的問題管理系統)的名稱和URL,本例爲 jira --> <issueManagement> <!-- 問題管理系統(例如jira)的名字, --> <system> jira </system> <!-- 該項目使用的問題管理系統的URL --> <url> http://jira.baidu.com/banseon </url> </issueManagement> <!-- 項目持續集成信息 --> <ciManagement> <!-- 持續集成系統的名字,例如continuum --> <system></system> <!-- 該項目使用的持續集成系統的URL(若是持續集成系統有web接口的話)。 --> <url></url> <!-- 構建完成時,須要通知的開發者/用戶的配置項。包括被通知者信息和通知條件(錯誤,失敗,成功,警告) --> <notifiers> <!-- 配置一種方式,當構建中斷時,以該方式通知用戶/開發者 --> <notifier> <!-- 傳送通知的途徑 --> <type></type> <!-- 發生錯誤時是否通知 --> <sendOnError></sendOnError> <!-- 構建失敗時是否通知 --> <sendOnFailure></sendOnFailure> <!-- 構建成功時是否通知 --> <sendOnSuccess></sendOnSuccess> <!-- 發生警告時是否通知 --> <sendOnWarning></sendOnWarning> <!-- 不同意使用。通知發送到哪裏 --> <address></address> <!-- 擴展配置項 --> <configuration></configuration> </notifier> </notifiers> </ciManagement> <!-- 項目建立年份,4位數字。當產生版權信息時須要使用這個值。 --> <inceptionYear /> <!-- 項目相關郵件列表信息 --> <mailingLists> <!-- 該元素描述了項目相關的全部郵件列表。自動產生的網站引用這些信息。 --> <mailingList> <!-- 郵件的名稱 --> <name> Demo </name> <!-- 發送郵件的地址或連接,若是是郵件地址,建立文檔時,mailto: 連接會被自動建立 --> <post> banseon@126.com </post> <!-- 訂閱郵件的地址或連接,若是是郵件地址,建立文檔時,mailto: 連接會被自動建立 --> <subscribe> banseon@126.com </subscribe> <!-- 取消訂閱郵件的地址或連接,若是是郵件地址,建立文檔時,mailto: 連接會被自動建立 --> <unsubscribe> banseon@126.com </unsubscribe> <!-- 你能夠瀏覽郵件信息的URL --> <archive> http:/hi.baidu.com/banseon/demo/dev/ </archive> </mailingList> </mailingLists> <!-- 項目開發者列表 --> <developers> <!-- 某個項目開發者的信息 --> <developer> <!-- SCM裏項目開發者的惟一標識符 --> <id> HELLO WORLD </id> <!-- 項目開發者的全名 --> <name> banseon </name> <!-- 項目開發者的email --> <email> banseon@126.com </email> <!-- 項目開發者的主頁的URL --> <url></url> <!-- 項目開發者在項目中扮演的角色,角色元素描述了各類角色 --> <roles> <role> Project Manager </role> <role> Architect </role> </roles> <!-- 項目開發者所屬組織 --> <organization> demo </organization> <!-- 項目開發者所屬組織的URL --> <organizationUrl> http://hi.baidu.com/xxx </organizationUrl> <!-- 項目開發者屬性,如即時消息如何處理等 --> <properties> <dept> No </dept> </properties> <!-- 項目開發者所在時區, -11到12範圍內的整數。 --> <timezone> -5 </timezone> </developer> </developers> <!-- 項目的其餘貢獻者列表 --> <contributors> <!-- 項目的其餘貢獻者。參見developers/developer元素 --> <contributor> <!-- 項目貢獻者的全名 --> <name></name> <!-- 項目貢獻者的email --> <email></email> <!-- 項目貢獻者的主頁的URL --> <url></url> <!-- 項目貢獻者所屬組織 --> <organization></organization> <!-- 項目貢獻者所屬組織的URL --> <organizationUrl></organizationUrl> <!-- 項目貢獻者在項目中扮演的角色,角色元素描述了各類角色 --> <roles> <role> Project Manager </role> <role> Architect </role> </roles> <!-- 項目貢獻者所在時區, -11到12範圍內的整數。 --> <timezone></timezone> <!-- 項目貢獻者屬性,如即時消息如何處理等 --> <properties> <dept> No </dept> </properties> </contributor> </contributors> <!-- 該元素描述了項目全部License列表。 應該只列出該項目的license列表,不要列出依賴項目的 license列表。 若是列出多個license,用戶能夠選擇它們中的一個而不是接受全部license。 --> <licenses> <!-- 描述了項目的license,用於生成項目的web站點的license頁面,其餘一些報表和validation也會用到該元素。 --> <license> <!-- license用於法律上的名稱 --> <name> Apache 2 </name> <!-- 官方的license正文頁面的URL --> <url> http://www.baidu.com/banseon/LICENSE-2.0.txt </url> <!-- 項目分發的主要方式: repo,能夠從Maven庫下載 manual, 用戶必須手動下載和安裝依賴 --> <distribution> repo </distribution> <!-- 關於license的補充信息 --> <comments> A business-friendly OSS license </comments> </license> </licenses> <!-- SCM(Source Control Management)標籤容許你配置你的代碼庫,供Maven web站點和其它插件使用。 --> <scm> <!-- SCM的URL,該URL描述了版本庫和如何鏈接到版本庫。欲知詳情,請看SCMs提供的URL格式和列表。該鏈接只讀。 --> <connection> scm:svn:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk) </connection> <!-- 給開發者使用的,相似connection元素。即該鏈接不只僅只讀 --> <developerConnection> scm:svn:http://svn.baidu.com/banseon/maven/banseon/dao-trunk </developerConnection> <!-- 當前代碼的標籤,在開發階段默認爲HEAD --> <tag></tag> <!-- 指向項目的可瀏覽SCM庫(例如ViewVC或者Fisheye)的URL。 --> <url> http://svn.baidu.com/banseon </url> </scm> <!-- 描述項目所屬組織的各類屬性。Maven產生的文檔用 --> <organization> <!-- 組織的全名 --> <name> demo </name> <!-- 組織主頁的URL --> <url> http://www.baidu.com/banseon </url> </organization> <!-- 構建項目須要的信息 --> <build> <!-- 該元素設置了項目源碼目錄,當構建項目的時候,構建系統會編譯目錄裏的源碼。該路徑是相對 於pom.xml的相對路徑。 --> <sourceDirectory></sourceDirectory> <!-- 該元素設置了項目腳本源碼目錄,該目錄和源碼目錄不一樣:絕大多數狀況下,該目錄下的內容會 被拷貝到輸出目錄(由於腳本是被解釋的,而不是被編譯的)。 --> <scriptSourceDirectory></scriptSourceDirectory> <!-- 該元素設置了項目單元測試使用的源碼目錄,當測試項目的時候,構建系統會編譯目錄裏的源碼。 該路徑是相對於pom.xml的相對路徑。 --> <testSourceDirectory></testSourceDirectory> <!-- 被編譯過的應用程序class文件存放的目錄。 --> <outputDirectory></outputDirectory> <!-- 被編譯過的測試class文件存放的目錄。 --> <testOutputDirectory></testOutputDirectory> <!-- 使用來自該項目的一系列構建擴展 --> <extensions> <!-- 描述使用到的構建擴展。 --> <extension> <!-- 構建擴展的groupId --> <groupId></groupId> <!-- 構建擴展的artifactId --> <artifactId></artifactId> <!-- 構建擴展的版本 --> <version></version> </extension> </extensions> <!-- 當項目沒有規定目標(Maven2 叫作階段)時的默認值 --> <defaultGoal></defaultGoal> <!-- 這個元素描述了項目相關的全部資源路徑列表,例如和項目相關的屬性文件,這些資源被包含在 最終的打包文件裏。 --> <resources> <!-- 這個元素描述了項目相關或測試相關的全部資源路徑 --> <resource> <!-- 描述了資源的目標路徑。該路徑相對target/classes目錄(例如${project.build.outputDirectory})。 舉個例子,若是你想資源在特定的包裏(org.apache.maven.messages),你就必須該元素設置爲 org/apache/maven/messages。然而,若是你只是想把資源放到源碼目錄結構裏,就不須要該配置。 --> <targetPath></targetPath> <!-- 是否使用參數值代替參數名。參數值取自properties元素或者文件裏配置的屬性,文件在filters元素 裏列出。 --> <filtering></filtering> <!-- 描述存放資源的目錄,該路徑相對POM路徑 --> <directory></directory> <!-- 包含的模式列表,例如**/*.xml. --> <includes> <include></include> </includes> <!-- 排除的模式列表,例如**/*.xml --> <excludes> <exclude></exclude> </excludes> </resource> </resources> <!-- 這個元素描述了單元測試相關的全部資源路徑,例如和單元測試相關的屬性文件。 --> <testResources> <!-- 這個元素描述了測試相關的全部資源路徑,參見build/resources/resource元素的說明 --> <testResource> <!-- 描述了測試相關的資源的目標路徑。該路徑相對target/classes目錄(例如${project.build.outputDirectory})。 舉個例子,若是你想資源在特定的包裏(org.apache.maven.messages),你就必須該元素設置爲 org/apache/maven/messages。然而,若是你只是想把資源放到源碼目錄結構裏,就不須要該配置。 --> <targetPath></targetPath> <!-- 是否使用參數值代替參數名。參數值取自properties元素或者文件裏配置的屬性,文件在filters元素 裏列出。 --> <filtering></filtering> <!-- 描述存放測試相關的資源的目錄,該路徑相對POM路徑 --> <directory></directory> <!-- 包含的模式列表,例如**/*.xml. --> <includes> <include></include> </includes> <!-- 排除的模式列表,例如**/*.xml --> <excludes> <exclude></exclude> </excludes> </testResource> </testResources> <!-- 構建產生的全部文件存放的目錄 --> <directory></directory> <!-- 產生的構件的文件名,默認值是${artifactId}-${version}。 --> <finalName></finalName> <!-- 當filtering開關打開時,使用到的過濾器屬性文件列表 --> <filters></filters> <!-- 子項目能夠引用的默認插件信息。該插件配置項直到被引用時纔會被解析或綁定到生命週期。給定插件的任何本 地配置都會覆蓋這裏的配置 --> <pluginManagement> <!-- 使用的插件列表 。 --> <plugins> <!-- plugin元素包含描述插件所須要的信息。 --> <plugin> <!-- 插件在倉庫裏的group ID --> <groupId></groupId> <!-- 插件在倉庫裏的artifact ID --> <artifactId></artifactId> <!-- 被使用的插件的版本(或版本範圍) --> <version></version> <!-- 是否從該插件下載Maven擴展(例如打包和類型處理器),因爲性能緣由,只有在真須要下載時,該 元素才被設置成enabled。 --> <extensions>true/false</extensions> <!-- 在構建生命週期中執行一組目標的配置。每一個目標可能有不一樣的配置。 --> <executions> <!-- execution元素包含了插件執行須要的信息 --> <execution> <!-- 執行目標的標識符,用於標識構建過程當中的目標,或者匹配繼承過程當中須要合併的執行目標 --> <id></id> <!-- 綁定了目標的構建生命週期階段,若是省略,目標會被綁定到源數據裏配置的默認階段 --> <phase></phase> <!-- 配置的執行目標 --> <goals></goals> <!-- 配置是否被傳播到子POM --> <inherited>true/false</inherited> <!-- 做爲DOM對象的配置 --> <configuration></configuration> </execution> </executions> <!-- 項目引入插件所須要的額外依賴 --> <dependencies> <!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> <!-- 任何配置是否被傳播到子項目 --> <inherited>true/false</inherited> <!-- 做爲DOM對象的配置 --> <configuration></configuration> </plugin> </plugins> </pluginManagement> <!-- 該項目使用的插件列表 。 --> <plugins> <!-- plugin元素包含描述插件所須要的信息。 --> <plugin> <!-- 插件在倉庫裏的group ID --> <groupId></groupId> <!-- 插件在倉庫裏的artifact ID --> <artifactId></artifactId> <!-- 被使用的插件的版本(或版本範圍) --> <version></version> <!-- 是否從該插件下載Maven擴展(例如打包和類型處理器),因爲性能緣由,只有在真須要下載時,該 元素才被設置成enabled。 --> <extensions>true/false</extensions> <!-- 在構建生命週期中執行一組目標的配置。每一個目標可能有不一樣的配置。 --> <executions> <!-- execution元素包含了插件執行須要的信息 --> <execution> <!-- 執行目標的標識符,用於標識構建過程當中的目標,或者匹配繼承過程當中須要合併的執行目標 --> <id></id> <!-- 綁定了目標的構建生命週期階段,若是省略,目標會被綁定到源數據裏配置的默認階段 --> <phase></phase> <!-- 配置的執行目標 --> <goals></goals> <!-- 配置是否被傳播到子POM --> <inherited>true/false</inherited> <!-- 做爲DOM對象的配置 --> <configuration></configuration> </execution> </executions> <!-- 項目引入插件所須要的額外依賴 --> <dependencies> <!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> <!-- 任何配置是否被傳播到子項目 --> <inherited>true/false</inherited> <!-- 做爲DOM對象的配置 --> <configuration></configuration> </plugin> </plugins> </build> <!-- 在列的項目構建profile,若是被激活,會修改構建處理 --> <profiles> <!-- 根據環境參數或命令行參數激活某個構建處理 --> <profile> <!-- 構建配置的惟一標識符。即用於命令行激活,也用於在繼承時合併具備相同標識符的profile。 --> <id></id> <!-- 自動觸發profile的條件邏輯。Activation是profile的開啓鑰匙。profile的力量來自於它可以 在某些特定的環境中自動使用某些特定的值;這些環境經過activation元素指定。activation元 素並非激活profile的惟一方式。 --> <activation> <!-- profile默認是否激活的標誌 --> <activeByDefault>true/false</activeByDefault> <!-- 當匹配的jdk被檢測到,profile被激活。例如,1.4激活JDK1.4,1.4.0_2,而!1.4激活全部版本 不是以1.4開頭的JDK。 --> <jdk>jdk版本,如:1.7</jdk> <!-- 當匹配的操做系統屬性被檢測到,profile被激活。os元素能夠定義一些操做系統相關的屬性。 --> <os> <!-- 激活profile的操做系統的名字 --> <name> Windows XP </name> <!-- 激活profile的操做系統所屬家族(如 'windows') --> <family> Windows </family> <!-- 激活profile的操做系統體系結構 --> <arch> x86 </arch> <!-- 激活profile的操做系統版本 --> <version> 5.1.2600 </version> </os> <!-- 若是Maven檢測到某一個屬性(其值能夠在POM中經過${名稱}引用),其擁有對應的名稱和值,Profile 就會被激活。若是值字段是空的,那麼存在屬性名稱字段就會激活profile,不然按區分大小寫方式匹 配屬性值字段 --> <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> <!-- 構建項目所須要的信息。參見build元素 --> <build> <defaultGoal /> <resources> <resource> <targetPath></targetPath> <filtering></filtering> <directory></directory> <includes> <include></include> </includes> <excludes> <exclude></exclude> </excludes> </resource> </resources> <testResources> <testResource> <targetPath></targetPath> <filtering></filtering> <directory></directory> <includes> <include></include> </includes> <excludes> <exclude></exclude> </excludes> </testResource> </testResources> <directory></directory> <finalName></finalName> <filters></filters> <pluginManagement> <plugins> <!-- 參見build/pluginManagement/plugins/plugin元素 --> <plugin> <groupId></groupId> <artifactId></artifactId> <version></version> <extensions>true/false</extensions> <executions> <execution> <id></id> <phase></phase> <goals></goals> <inherited>true/false</inherited> <configuration></configuration> </execution> </executions> <dependencies> <!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> <goals></goals> <inherited>true/false</inherited> <configuration></configuration> </plugin> </plugins> </pluginManagement> <plugins> <!-- 參見build/pluginManagement/plugins/plugin元素 --> <plugin> <groupId></groupId> <artifactId></artifactId> <version></version> <extensions>true/false</extensions> <executions> <execution> <id></id> <phase></phase> <goals></goals> <inherited>true/false</inherited> <configuration></configuration> </execution> </executions> <dependencies> <!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> <goals></goals> <inherited>true/false</inherited> <configuration></configuration> </plugin> </plugins> </build> <!-- 模塊(有時稱做子項目) 被構建成項目的一部分。列出的每一個模塊元素是指向該模塊的目錄的 相對路徑 --> <modules> <!--子項目相對路徑--> <module></module> </modules> <!-- 發現依賴和擴展的遠程倉庫列表。 --> <repositories> <!-- 參見repositories/repository元素 --> <repository> <releases> <enabled><enabled> <updatePolicy></updatePolicy> <checksumPolicy></checksumPolicy> </releases> <snapshots> <enabled><enabled> <updatePolicy></updatePolicy> <checksumPolicy></checksumPolicy> </snapshots> <id></id> <name></name> <url></url> <layout></layout> </repository> </repositories> <!-- 發現插件的遠程倉庫列表,這些插件用於構建和報表 --> <pluginRepositories> <!-- 包含須要鏈接到遠程插件倉庫的信息.參見repositories/repository元素 --> <pluginRepository> <releases> <enabled><enabled> <updatePolicy></updatePolicy> <checksumPolicy></checksumPolicy> </releases> <snapshots> <enabled><enabled> <updatePolicy></updatePolicy> <checksumPolicy></checksumPolicy> </snapshots> <id></id> <name></name> <url></url> <layout></layout> </pluginRepository> </pluginRepositories> <!-- 該元素描述了項目相關的全部依賴。 這些依賴組成了項目構建過程當中的一個個環節。它們自動從項目定義的 倉庫中下載。要獲取更多信息,請看項目依賴機制。 --> <dependencies> <!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> <!-- 不同意使用. 如今Maven忽略該元素. --> <reports></reports> <!-- 該元素包括使用報表插件產生報表的規範。當用戶執行「mvn site」,這些報表就會運行。 在頁面導航欄能看 到全部報表的連接。參見reporting元素 --> <reporting></reporting> <!-- 參見dependencyManagement元素 --> <dependencyManagement> <dependencies> <!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> </dependencyManagement> <!-- 參見distributionManagement元素 --> <distributionManagement> </distributionManagement> <!-- 參見properties元素 --> <properties /> </profile> </profiles> <!-- 模塊(有時稱做子項目) 被構建成項目的一部分。列出的每一個模塊元素是指向該模塊的目錄的相對路徑 --> <modules> <!--子項目相對路徑--> <module></module> </modules> <!-- 發現依賴和擴展的遠程倉庫列表。 --> <repositories> <!-- 包含須要鏈接到遠程倉庫的信息 --> <repository> <!-- 如何處理遠程倉庫裏發佈版本的下載 --> <releases> <!-- true或者false表示該倉庫是否爲下載某種類型構件(發佈版,快照版)開啓。 --> <enabled><enabled> <!-- 該元素指定更新發生的頻率。Maven會比較本地POM和遠程POM的時間戳。這裏的選項是:always(一直), daily(默認,每日),interval:X(這裏X是以分鐘爲單位的時間間隔),或者never(從不)。 --> <updatePolicy></updatePolicy> <!-- 當Maven驗證構件校驗文件失敗時該怎麼作:ignore(忽略),fail(失敗),或者warn(警告)。 --> <checksumPolicy></checksumPolicy> </releases> <!-- 如何處理遠程倉庫裏快照版本的下載。有了releases和snapshots這兩組配置,POM就能夠在每一個單獨的倉庫中, 爲每種類型的構件採起不一樣的策略。例如,可能有人會決定只爲開發目的開啓對快照版本下載的支持。參見repositories/repository/releases元素 --> <snapshots> <enabled><enabled> <updatePolicy></updatePolicy> <checksumPolicy></checksumPolicy> </snapshots> <!-- 遠程倉庫惟一標識符。能夠用來匹配在settings.xml文件裏配置的遠程倉庫 --> <id> banseon-repository-proxy </id> <!-- 遠程倉庫名稱 --> <name> banseon-repository-proxy </name> <!-- 遠程倉庫URL,按protocol://hostname/path形式 --> <url> http://192.168.1.169:9999/repository/ </url> <!-- 用於定位和排序構件的倉庫佈局類型-能夠是default(默認)或者legacy(遺留)。Maven 2爲其倉庫提供了一個默認 的佈局;然而,Maven 1.x有一種不一樣的佈局。咱們可使用該元素指定佈局是default(默認)仍是legacy(遺留)。 --> <layout> default </layout> </repository> </repositories> <!-- 發現插件的遠程倉庫列表,這些插件用於構建和報表 --> <pluginRepositories> <!-- 包含須要鏈接到遠程插件倉庫的信息.參見repositories/repository元素 --> <pluginRepository> </pluginRepository> </pluginRepositories> <!-- 該元素描述了項目相關的全部依賴。 這些依賴組成了項目構建過程當中的一個個環節。它們自動從項目定義的倉庫中下載。 要獲取更多信息,請看項目依賴機制。 --> <dependencies> <dependency> <!-- 依賴的group ID --> <groupId> org.apache.maven </groupId> <!-- 依賴的artifact ID --> <artifactId> maven-artifact </artifactId> <!-- 依賴的版本號。 在Maven 2裏, 也能夠配置成版本號的範圍。 --> <version> 3.8.1 </version> <!-- 依賴類型,默認類型是jar。它一般表示依賴的文件的擴展名,但也有例外。一個類型能夠被映射成另一個擴展 名或分類器。類型常常和使用的打包方式對應,儘管這也有例外。一些類型的例子:jar,war,ejb-client和test-jar。 若是設置extensions爲 true,就能夠在plugin裏定義新的類型。因此前面的類型的例子不完整。 --> <type> jar </type> <!-- 依賴的分類器。分類器能夠區分屬於同一個POM,但不一樣構建方式的構件。分類器名被附加到文件名的版本號後面。例如, 若是你想要構建兩個單獨的構件成JAR,一個使用Java 1.4編譯器,另外一個使用Java 6編譯器,你就可使用分類器來生 成兩個單獨的JAR構件。 --> <classifier></classifier> <!-- 依賴範圍。在項目發佈過程當中,幫助決定哪些構件被包括進來。欲知詳情請參考依賴機制。 - compile :默認範圍,用於編譯 - provided:相似於編譯,但支持你期待jdk或者容器提供,相似於classpath - runtime: 在執行時須要使用 - test: 用於test任務時使用 - system: 須要外在提供相應的元素。經過systemPath來取得 - systemPath: 僅用於範圍爲system。提供相應的路徑 - optional: 當項目自身被依賴時,標註依賴是否傳遞。用於連續依賴時使用 --> <scope> test </scope> <!-- 僅供system範圍使用。注意,不鼓勵使用這個元素,而且在新的版本中該元素可能被覆蓋掉。該元素爲依賴規定了文件 系統上的路徑。須要絕對路徑而不是相對路徑。推薦使用屬性匹配絕對路徑,例如${java.home}。 --> <systemPath></systemPath> <!-- 當計算傳遞依賴時, 從依賴構件列表裏,列出被排除的依賴構件集。即告訴maven你只依賴指定的項目,不依賴項目的 依賴。此元素主要用於解決版本衝突問題 --> <exclusions> <exclusion> <artifactId> spring-core </artifactId> <groupId> org.springframework </groupId> </exclusion> </exclusions> <!-- 可選依賴,若是你在項目B中把C依賴聲明爲可選,你就須要在依賴於B的項目(例如項目A)中顯式的引用對C的依賴。 可選依賴阻斷依賴的傳遞性。 --> <optional> true </optional> </dependency> </dependencies> <!-- 不同意使用. 如今Maven忽略該元素. --> <reports></reports> <!-- 該元素描述使用報表插件產生報表的規範。當用戶執行「mvn site」,這些報表就會運行。 在頁面導航欄能看到全部報表的連接。 --> <reporting> <!-- true,則,網站不包括默認的報表。這包括「項目信息」菜單中的報表。 --> <excludeDefaults /> <!-- 全部產生的報表存放到哪裏。默認值是${project.build.directory}/site。 --> <outputDirectory /> <!-- 使用的報表插件和他們的配置。 --> <plugins> <!-- plugin元素包含描述報表插件須要的信息 --> <plugin> <!-- 報表插件在倉庫裏的group ID --> <groupId></groupId> <!-- 報表插件在倉庫裏的artifact ID --> <artifactId></artifactId> <!-- 被使用的報表插件的版本(或版本範圍) --> <version></version> <!-- 任何配置是否被傳播到子項目 --> <inherited>true/false</inherited> <!-- 報表插件的配置 --> <configuration></configuration> <!-- 一組報表的多重規範,每一個規範可能有不一樣的配置。一個規範(報表集)對應一個執行目標 。例如, 有1,2,3,4,5,6,7,8,9個報表。1,2,5構成A報表集,對應一個執行目標。2,5,8構成B報 表集,對應另外一個執行目標 --> <reportSets> <!-- 表示報表的一個集合,以及產生該集合的配置 --> <reportSet> <!-- 報表集合的惟一標識符,POM繼承時用到 --> <id></id> <!-- 產生報表集合時,被使用的報表的配置 --> <configuration></configuration> <!-- 配置是否被繼承到子POMs --> <inherited>true/false</inherited> <!-- 這個集合裏使用到哪些報表 --> <reports></reports> </reportSet> </reportSets> </plugin> </plugins> </reporting> <!-- 繼承自該項目的全部子項目的默認依賴信息。這部分的依賴信息不會被當即解析,而是當子項目聲明一個依賴 (必須描述group ID和artifact ID信息),若是group ID和artifact ID之外的一些信息沒有描述,則經過 group ID和artifact ID匹配到這裏的依賴,並使用這裏的依賴信息。 --> <dependencyManagement> <dependencies> <!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> </dependencyManagement> <!-- 項目分發信息,在執行mvn deploy後表示要發佈的位置。有了這些信息就能夠把網站部署到遠程服務器或者 把構件部署到遠程倉庫。 --> <distributionManagement> <!-- 部署項目產生的構件到遠程倉庫須要的信息 --> <repository> <!-- 是分配給快照一個惟一的版本號(由時間戳和構建流水號)?仍是每次都使用相同的版本號?參見 repositories/repository元素 --> <uniqueVersion /> <id> banseon-maven2 </id> <name> banseon maven2 </name> <url> file://${basedir}/target/deploy </url> <layout></layout> </repository> <!-- 構件的快照部署到哪裏?若是沒有配置該元素,默認部署到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></layout> </snapshotRepository> <!-- 部署項目的網站須要的信息 --> <site> <!-- 部署位置的惟一標識符,用來匹配站點和settings.xml文件裏的配置 --> <id> banseon-site </id> <!-- 部署位置的名稱 --> <name> business api website </name> <!-- 部署位置的URL,按protocol://hostname/path形式 --> <url> scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web </url> </site> <!-- 項目下載頁面的URL。若是沒有該元素,用戶應該參考主頁。使用該元素的緣由是:幫助定位 那些不在倉庫裏的構件(因爲license限制)。 --> <downloadUrl /> <!-- 若是構件有了新的group ID和artifact ID(構件移到了新的位置),這裏列出構件的重定位信息。 --> <relocation> <!-- 構件新的group ID --> <groupId></groupId> <!-- 構件新的artifact ID --> <artifactId></artifactId> <!-- 構件新的版本號 --> <version></version> <!-- 顯示給用戶的,關於移動的額外信息,例如緣由。 --> <message></message> </relocation> <!-- 給出該構件在遠程倉庫的狀態。不得在本地項目中設置該元素,由於這是工具自動更新的。有效的值 有:none(默認),converted(倉庫管理員從Maven 1 POM轉換過來),partner(直接從夥伴Maven 2倉庫同步過來),deployed(從Maven 2實例部署),verified(被覈實時正確的和最終的)。 --> <status></status> </distributionManagement> <!-- 以值替代名稱,Properties能夠在整個POM中使用,也能夠做爲觸發條件(見settings.xml配置文件裏 activation元素的說明)。格式是<name>value</name>。 --> <properties> <name>value</name> </properties> </project>
更多精彩敬請關注公衆號
Java極客思惟
微信掃一掃,關注公衆號