Maven学习(二)————Maven核心概念(一)
引言
Maven 作為項目構建工具,學習成本并不大,但是如果搞不懂它的一些核心概念,使用起來還是不能特別得心應手。
Maven的核心概念包括以下這些:
1、約定的目錄結構? 2、POM? 3、坐標? ?4、依賴? ?5、倉庫? ?6、生命周期/插件/目標? ?7、繼承? ?8、聚合?
這些概念我會分兩篇文章進行講解,這是核心概念第一篇。
一、約定的目錄結構
1.1 如何理解約定的結構
在Maven 項目中,會有一個約定的目錄結構。
為什么會有固定的目錄結構呢?是因為 maven 如果想要完成自動化的構建過程如編譯、測試等,就必須能夠找到項目的源文件的位置,通過配置的方式可以達成,但是使用默認的可以省去大量的配置屬性的學習,且友好。
這種解決方案也是目前 Java EE 的配置主流方案—— 約定 > 配置 > 編碼。
1.2 具體結構展示
Maven 約定的目錄結構包含以下內容:
1、根目錄:工程名文件夾
2、src目錄:存放源碼
3、pom.xml 文件:Maven 的核心配置文件
4、main 目錄:存放主程序
5、test 目錄:存放測試程序
6、java 目錄:存放java 源碼
7、resources 目錄:存放框架配置文件或其他類型文件
8、target 目錄:執行 Maven install 等相關命令所產生的文件存放的目錄
二、項目對象模型——POM
項目對象模型(Project Object Model:POM),類似于DOM,是將項目作為一個對象進行管理,是 Maven 工程的基本工作單元。
pom.xml 文件是 Maven 工程的核心配置文件,與構建過程相關的一切設置都在這個文件中配置,其中包括項目的基本信息以及 jar 包依賴等。重要程度相當于 web.xml 之于動態 web 項目。
具體在 pom 中可以指定以下配置:
1、項目依賴
2、插件
3、執行目標
4、項目構建 profile?
5、項目版本
6、項目開發者列表
7、相關郵件列表信息
三、坐標、倉庫、依賴
坐標是 pom 中的一個概念,maven 的一個主要功能之一就是管理依賴,為了能夠統一的管理 jar 包依賴,maven 有一個專門用于存儲 jar 文件的“倉庫”。
倉庫中不僅可以管理第三方的 jar 包,也能將我們自己創建的 maven 項目變為倉庫中的 jar 包,并通過同種依賴的配置方式,把多個 maven 項目組織起來。
為了能夠在 maven 倉庫中定位到依賴,maven 規定,在 pom.xml 中,必須首先寫明 maven 項目的坐標,即:
<!-- 公司或組織的唯一標識,并且配置時生成的路徑也是由此生成 --> <groupId>com.example</groupId> <!-- 項目的唯一ID,一個groupId下面可能多個項目,就是靠artifactId來區分的 --> <artifactId>demo</artifactId> <!-- 項目的版本號 --> <version>0.0.1-SNAPSHOT</version>這三個標簽是項目的坐標,簡稱 GAV,是 maven 項目必須指定的三個項目信息相關的標簽。之所以稱這三個標簽為依賴(maven 工程有時候也會變成其他maven 項目的依賴)的坐標,就是因為,在 maven 倉庫中,會以 groupId——>artifactId——>version 的順序建立目錄結構,其他的項目也會通過這個目錄結構找到被唯一標識的依賴 jar 包。
默認的倉庫位置是個人用戶家目錄下的 .m2目錄下的 repository 文件夾。
在pom 中,依賴是通過一個<dependencies>標簽組來管理依賴信息的,例如:
<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency><dependency><groupId>org.apache.commons</groupId><artifactId>commons-lang3</artifactId></dependency><dependency><groupId>dom4j</groupId><artifactId>dom4j</artifactId></dependency> </dependencies>【說明】如果不指定版本號,是因為該 maven 項目依賴的父工程已經指定過版本號,是的,你沒有看錯,maven 工程之間不僅可以相互依賴,還可以實現父子的繼承關系,主要就是用于控制某些通用 jar 包的版本號。
maven 項目會在 pom 中添加新的<dependency> 依賴坐標后自動去本地倉庫中(.m2/repository)查找是否已經存在,如果不存在,則會到中央倉庫(http://repo1.maven.org/maven2)中去下載 jar 包。
【說明】下載 jar 包的中央倉庫地址為什么是:http://repo1.maven.org/maven2?
這里需要簡單說明一個 SUPER POM 的概念,父 POM 是Maven 默認的 POM(注意:這里的父POM并非是我們自定義的<parent>標簽項,可以理解為Java 中的Object 超類,是默認繼承的),所有的 POM 都繼承自 父POM(大多為隱式繼承),父POM包含了一系列可以被繼承的默認設置,其中就包含中央倉庫的 url 信息。可以在項目 pom文件所在目錄打開cmd 查看父POM信息:mvn help:effective-pom
通常我們在網上的中央倉庫尋找一個jar 包的依賴信息,會去:https://mvnrepository.com/?中查找,但實際上,我們將依賴的xml信息添加到 pom 中后,maven 實際上會到http://repo1.maven.org/maven2?中去下載真正需要用到的jar 包文件。一個簡單的操作就可以驗證這個問題,比如你找到一個 Spring 的依賴信息,然后在 Files 一欄點擊 jar (或者 View All),觀察實際的 url地址:
倉庫可以分為以下幾類:
1、本地倉庫:當前計算機上部署的倉庫目錄,默認是 .m2/repository,為當前電腦上所有的 Maven 服務。
2、私服:搭建在局域網環境中,為局域網范圍內的所有 Maven 項目服務。
3、中央倉庫:上面提到的 maven 倉庫,架設在 因特網上,為全世界 Maven 工程服務。
4、中央倉庫鏡像:分擔中央倉庫流量,內容完全鏡像,一般搭設在各個國家或地區,為本地區 Maven 項目服務。
依賴的搜索順序?:
當我們構建maven 項目的時候,maven 開始按照以下順序查找依賴的庫:
- 步驟 1?- 在本地倉庫中搜索,如果找不到,執行步驟 2,如果找到了則執行其他操作。
- 步驟 2?- 在中央倉庫中搜索,如果找不到,并且有一個或多個遠程倉庫已經設置,則執行步驟 4,如果找到了則下載到本地倉庫中以備將來引用。
- 步驟 3?- 如果遠程倉庫沒有被設置,Maven 將簡單的停滯處理并拋出錯誤(無法找到依賴的文件)。
- 步驟 4?- 在一個或多個遠程倉庫中搜索依賴的文件,如果找到則下載到本地倉庫以備將來引用,否則 Maven 將停止處理并拋出錯誤(無法找到依賴的文件)。
附錄:pom 標簽含義
Maven 的 pom.xml 文件不需要手動創建,Maven 提供了大量的原型插件來創建工程,包括工程結構和 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.0http://maven.apache.org/maven-v4_0_0.xsd"><!--父項目的坐標。如果項目中沒有規定某個元素的值,那么父項目中的對應值即為項目的默認值。 坐標包括group ID,artifact ID和 version。 --><parent><!--被繼承的父項目的構件標識符 --><artifactId /><!--被繼承的父項目的全球唯一標識符 --><groupId /><!--被繼承的父項目的版本 --><version /><!-- 父項目的pom.xml文件的相對路徑。相對路徑允許你選擇一個不同的路徑。默認值是../pom.xml。Maven首先在構建當前項目的地方尋找父項 目的pom,其次在文件系統的這個位置(relativePath位置),然后在本地倉庫,最后在遠程倉庫尋找父項目的pom。 --><relativePath /></parent><!--聲明項目描述符遵循哪一個POM模型版本。模型本身的版本很少改變,雖然如此,但它仍然是必不可少的,這是為了當Maven引入了新的特性或者其他模型變更的時候,確保穩定性。 --><modelVersion>4.0.0</modelVersion><!--項目的全球唯一標識符,通常使用全限定的包名區分該項目和其他項目。并且構建時生成的路徑也是由此生成, 如com.mycompany.app生成的相對路徑為:/com/mycompany/app --><groupId>asia.banseon</groupId><!-- 構件的標識符,它和group ID一起唯一標識一個構件。換句話說,你不能有兩個不同的項目擁有同樣的artifact ID和groupID;在某個 特定的group ID下,artifact ID也必須是唯一的。構件是項目產生的或使用的一個東西,Maven為項目產生的構件包括:JARs,源 碼,二進制發布和WARs等。 --><artifactId>banseon-maven2</artifactId><!--項目產生的構件類型,例如jar、war、ear、pom。插件可以創建他們自己的構件類型,所以前面列的不是全部構件類型 --><packaging>jar</packaging><!--項目當前版本,格式為:主版本.次版本.增量版本-限定版本號 --><version>1.0-SNAPSHOT</version><!--項目的名稱, Maven產生的文檔用 --><name>banseon-maven</name><!--項目主頁的URL, Maven產生的文檔用 --><url>http://www.baidu.com/banseon</url><!-- 項目的詳細描述, Maven 產生的文檔用。 當這個元素能夠用HTML格式描述時(例如,CDATA中的文本會被解析器忽略,就可以包含HTML標 簽), 不鼓勵使用純文本描述。如果你需要修改產生的web站點的索引頁面,你應該修改你自己的索引頁文件,而不是調整這里的文檔。 --><description>A maven project to study maven.</description><!--描述了這個項目構建環境中的前提條件。 --><prerequisites><!--構建該項目或使用該插件所需要的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 /><!--該項目使用的持續集成系統的URL(如果持續集成系統有web接口的話)。 --><url /><!--構建完成時,需要通知的開發者/用戶的配置項。包括被通知者信息和通知條件(錯誤,失敗,成功,警告) --><notifiers><!--配置一種方式,當構建中斷時,以該方式通知用戶/開發者 --><notifier><!--傳送通知的途徑 --><type /><!--發生錯誤時是否通知 --><sendOnError /><!--構建失敗時是否通知 --><sendOnFailure /><!--構建成功時是否通知 --><sendOnSuccess /><!--發生警告時是否通知 --><sendOnWarning /><!--不贊成使用。通知發送到哪里 --><address /><!--擴展配置項 --><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 /><!--項目開發者在項目中扮演的角色,角色元素描述了各種角色 --><roles><role>Project Manager</role><role>Architect</role></roles><!--項目開發者所屬組織 --><organization>demo</organization><!--項目開發者所屬組織的URL --><organizationUrl>http://hi.baidu.com/banseon</organizationUrl><!--項目開發者屬性,如即時消息如何處理等 --><properties><dept>No</dept></properties><!--項目開發者所在時區, -11到12范圍內的整數。 --><timezone>-5</timezone></developer></developers><!--項目的其他貢獻者列表 --><contributors><!--項目的其他貢獻者。參見developers/developer元素 --><contributor><name /><email /><url /><organization /><organizationUrl /><roles /><timezone /><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 /><!--指向項目的可瀏覽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 /><!--該元素設置了項目腳本源碼目錄,該目錄和源碼目錄不同:絕大多數情況下,該目錄下的內容 會被拷貝到輸出目錄(因為腳本是被解釋的,而不是被編譯的)。 --><scriptSourceDirectory /><!--該元素設置了項目單元測試使用的源碼目錄,當測試項目的時候,構建系統會編譯目錄里的源碼。該路徑是相對于pom.xml的相對路徑。 --><testSourceDirectory /><!--被編譯過的應用程序class文件存放的目錄。 --><outputDirectory /><!--被編譯過的測試class文件存放的目錄。 --><testOutputDirectory /><!--使用來自該項目的一系列構建擴展 --><extensions><!--描述使用到的構建擴展。 --><extension><!--構建擴展的groupId --><groupId /><!--構建擴展的artifactId --><artifactId /><!--構建擴展的版本 --><version /></extension></extensions><!--當項目沒有規定目標(Maven2 叫做階段)時的默認值 --><defaultGoal /><!--這個元素描述了項目相關的所有資源路徑列表,例如和項目相關的屬性文件,這些資源被包含在最終的打包文件里。 --><resources><!--這個元素描述了項目相關或測試相關的所有資源路徑 --><resource><!-- 描述了資源的目標路徑。該路徑相對target/classes目錄(例如${project.build.outputDirectory})。舉個例 子,如果你想資源在特定的包里(org.apache.maven.messages),你就必須該元素設置為org/apache/maven /messages。然而,如果你只是想把資源放到源碼目錄結構里,就不需要該配置。 --><targetPath /><!--是否使用參數值代替參數名。參數值取自properties元素或者文件里配置的屬性,文件在filters元素里列出。 --><filtering /><!--描述存放資源的目錄,該路徑相對POM路徑 --><directory /><!--包含的模式列表,例如**/*.xml. --><includes /><!--排除的模式列表,例如**/*.xml --><excludes /></resource></resources><!--這個元素描述了單元測試相關的所有資源路徑,例如和單元測試相關的屬性文件。 --><testResources><!--這個元素描述了測試相關的所有資源路徑,參見build/resources/resource元素的說明 --><testResource><targetPath /><filtering /><directory /><includes /><excludes /></testResource></testResources><!--構建產生的所有文件存放的目錄 --><directory /><!--產生的構件的文件名,默認值是${artifactId}-${version}。 --><finalName /><!--當filtering開關打開時,使用到的過濾器屬性文件列表 --><filters /><!--子項目可以引用的默認插件信息。該插件配置項直到被引用時才會被解析或綁定到生命周期。給定插件的任何本地配置都會覆蓋這里的配置 --><pluginManagement><!--使用的插件列表 。 --><plugins><!--plugin元素包含描述插件所需要的信息。 --><plugin><!--插件在倉庫里的group ID --><groupId /><!--插件在倉庫里的artifact ID --><artifactId /><!--被使用的插件的版本(或版本范圍) --><version /><!--是否從該插件下載Maven擴展(例如打包和類型處理器),由于性能原因,只有在真需要下載時,該元素才被設置成enabled。 --><extensions /><!--在構建生命周期中執行一組目標的配置。每個目標可能有不同的配置。 --><executions><!--execution元素包含了插件執行需要的信息 --><execution><!--執行目標的標識符,用于標識構建過程中的目標,或者匹配繼承過程中需要合并的執行目標 --><id /><!--綁定了目標的構建生命周期階段,如果省略,目標會被綁定到源數據里配置的默認階段 --><phase /><!--配置的執行目標 --><goals /><!--配置是否被傳播到子POM --><inherited /><!--作為DOM對象的配置 --><configuration /></execution></executions><!--項目引入插件所需要的額外依賴 --><dependencies><!--參見dependencies/dependency元素 --><dependency>......</dependency></dependencies><!--任何配置是否被傳播到子項目 --><inherited /><!--作為DOM對象的配置 --><configuration /></plugin></plugins></pluginManagement><!--使用的插件列表 --><plugins><!--參見build/pluginManagement/plugins/plugin元素 --><plugin><groupId /><artifactId /><version /><extensions /><executions><execution><id /><phase /><goals /><inherited /><configuration /></execution></executions><dependencies><!--參見dependencies/dependency元素 --><dependency>......</dependency></dependencies><goals /><inherited /><configuration /></plugin></plugins></build><!--在列的項目構建profile,如果被激活,會修改構建處理 --><profiles><!--根據環境參數或命令行參數激活某個構建處理 --><profile><!--構建配置的唯一標識符。即用于命令行激活,也用于在繼承時合并具有相同標識符的profile。 --><id /><!--自動觸發profile的條件邏輯。Activation是profile的開啟鑰匙。profile的力量來自于它 能夠在某些特定的環境中自動使用某些特定的值;這些環境通過activation元素指定。activation元素并不是激活profile的唯一方式。 --><activation><!--profile默認是否激活的標志 --><activeByDefault /><!--當匹配的jdk被檢測到,profile被激活。例如,1.4激活JDK1.4,1.4.0_2,而!1.4激活所有版本不是以1.4開頭的JDK。 --><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 /><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><!--模塊(有時稱作子項目) 被構建成項目的一部分。列出的每個模塊元素是指向該模塊的目錄的相對路徑 --><modules /><!--發現依賴和擴展的遠程倉庫列表。 --><repositories><!--參見repositories/repository元素 --><repository><releases><enabled /><updatePolicy /><checksumPolicy /></releases><snapshots><enabled /><updatePolicy /><checksumPolicy /></snapshots><id /><name /><url /><layout /></repository></repositories><!--發現插件的遠程倉庫列表,這些插件用于構建和報表 --><pluginRepositories><!--包含需要連接到遠程插件倉庫的信息.參見repositories/repository元素 --><pluginRepository><releases><enabled /><updatePolicy /><checksumPolicy /></releases><snapshots><enabled /><updatePolicy /><checksumPolicy /></snapshots><id /><name /><url /><layout /></pluginRepository></pluginRepositories><!--該元素描述了項目相關的所有依賴。 這些依賴組成了項目構建過程中的一個個環節。它們自動從項目定義的倉庫中下載。要獲取更多信息,請看項目依賴機制。 --><dependencies><!--參見dependencies/dependency元素 --><dependency>......</dependency></dependencies><!--不贊成使用. 現在Maven忽略該元素. --><reports /><!--該元素包括使用報表插件產生報表的規范。當用戶執行"mvn site",這些報表就會運行。 在頁面導航欄能看到所有報表的鏈接。參見reporting元素 --><reporting>......</reporting><!--參見dependencyManagement元素 --><dependencyManagement><dependencies><!--參見dependencies/dependency元素 --><dependency>......</dependency></dependencies></dependencyManagement><!--參見distributionManagement元素 --><distributionManagement>......</distributionManagement><!--參見properties元素 --><properties /></profile></profiles><!--模塊(有時稱作子項目) 被構建成項目的一部分。列出的每個模塊元素是指向該模塊的目錄的相對路徑 --><modules /><!--發現依賴和擴展的遠程倉庫列表。 --><repositories><!--包含需要連接到遠程倉庫的信息 --><repository><!--如何處理遠程倉庫里發布版本的下載 --><releases><!--true或者false表示該倉庫是否為下載某種類型構件(發布版,快照版)開啟。 --><enabled /><!--該元素指定更新發生的頻率。Maven會比較本地POM和遠程POM的時間戳。這里的選項是:always(一直),daily(默認,每日),interval:X(這里X是以分鐘為單位的時間間隔),或者never(從不)。 --><updatePolicy /><!--當Maven驗證構件校驗文件失敗時該怎么做:ignore(忽略),fail(失敗),或者warn(警告)。 --><checksumPolicy /></releases><!-- 如何處理遠程倉庫里快照版本的下載。有了releases和snapshots這兩組配置,POM就可以在每個單獨的倉庫中,為每種類型的構件采取不同的 策略。例如,可能有人會決定只為開發目的開啟對快照版本下載的支持。參見repositories/repository/releases元素 --><snapshots><enabled /><updatePolicy /><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 /><!--報表插件在倉庫里的artifact ID --><artifactId /><!--被使用的報表插件的版本(或版本范圍) --><version /><!--任何配置是否被傳播到子項目 --><inherited /><!--報表插件的配置 --><configuration /><!--一組報表的多重規范,每個規范可能有不同的配置。一個規范(報表集)對應一個執行目標 。例如,有1,2,3,4,5,6,7,8,9個報表。1,2,5構成A報表集,對應一個執行目標。2,5,8構成B報表集,對應另一個執行目標 --><reportSets><!--表示報表的一個集合,以及產生該集合的配置 --><reportSet><!--報表集合的唯一標識符,POM繼承時用到 --><id /><!--產生報表集合時,被使用的報表的配置 --><configuration /><!--配置是否被繼承到子POMs --><inherited /><!--這個集合里使用到哪些報表 --><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 /></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 /></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 /><!--構件新的artifact ID --><artifactId /><!--構件新的版本號 --><version /><!--顯示給用戶的,關于移動的額外信息,例如原因。 --><message /></relocation><!-- 給出該構件在遠程倉庫的狀態。不得在本地項目中設置該元素,因為這是工具自動更新的。有效的值有:none(默認),converted(倉庫管理員從 Maven 1 POM轉換過來),partner(直接從伙伴Maven 2倉庫同步過來),deployed(從Maven 2實例部 署),verified(被核實時正確的和最終的)。 --><status /></distributionManagement><!--以值替代名稱,Properties可以在整個POM中使用,也可以作為觸發條件(見settings.xml配置文件里activation元素的說明)。格式是<name>value</name>。 --><properties /> </project>(鳴謝菜鳥教程提供的標簽含義說明)
?
總結
以上是生活随笔為你收集整理的Maven学习(二)————Maven核心概念(一)的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Maven学习(五)————依赖的特性辨
- 下一篇: GitBlit使用安装教程~