項(xiàng)目的依賴關(guān)系主要分為三種:依賴,繼承,聚合
依賴關(guān)系
依賴關(guān)系是最常用的一種,就是你的項(xiàng)目需要依賴其他項(xiàng)目,比如Apache-common包,Spring包等等。
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
<type >jar</ type >
<optional >true</ optional >
</dependency>
任意一個(gè)外部依賴說(shuō)明包含如下幾個(gè)要素:groupId, artifactId, version, scope, type, optional。其中前3個(gè)是必須的。
這里的version可以用區(qū)間表達(dá)式來(lái)表示,比如(2.0,)表示>2.0,[2.0,3.0)表示2.0<=ver<3.0;多個(gè)條件之間用逗號(hào)分隔,比如[1,3],[5,7]。
type 一般在pom引用依賴時(shí)候出現(xiàn),其他時(shí)候不用。
maven認(rèn)為,程序?qū)ν獠康囊蕾嚂?huì)隨著程序的所處階段和應(yīng)用場(chǎng)景而變化,所以maven中的依賴關(guān)系有作用域(scope)的限制。在maven中,scope包含如下的取值:
| Scope選項(xiàng) | 描述 |
|---|---|
| compile(編譯范圍) | compile是默認(rèn)的范圍;如果沒(méi)有提供一個(gè)范圍,那該依賴的范圍就是編譯范圍。編譯范圍依賴在所有的classpath中可用,同時(shí)它們也會(huì)被打包。 |
| provided(已提供范圍) | provided依賴只有在當(dāng)JDK或者一個(gè)容器已提供該依賴之后才使用。例如,如果你開(kāi)發(fā)了一個(gè)web應(yīng)用,你可能在編譯classpath中需要可用 的Servlet API來(lái)編譯一個(gè)servlet,但是你不會(huì)想要在打包好的WAR中包含這個(gè)Servlet API;這個(gè)Servlet API JAR由你的應(yīng)用服務(wù)器或者servlet容器提供。已提供范圍的依賴在編譯classpath(不是運(yùn)行時(shí))可用。它們不是傳遞性的,也不會(huì)被打包。 |
| runtime(運(yùn)行時(shí)范圍) | runtime依賴在運(yùn)行和測(cè)試系統(tǒng)的時(shí)候需要,但在編譯的時(shí)候不需要。比如,你可能在編譯的時(shí)候只需要JDBC API JAR,而只有在運(yùn)行的時(shí)候才需要JDBC驅(qū)動(dòng)實(shí)現(xiàn) |
| test(測(cè)試范圍) | test范圍依賴在編譯和運(yùn)行時(shí)都不需要,它們只有在測(cè)試編譯和測(cè)試運(yùn)行階段可用。 |
| system(系統(tǒng)范圍) | system范圍依賴與provided類似,但是你必須顯式的提供一個(gè)對(duì)于本地系統(tǒng)中JAR文件的路徑。這么做是為了允許基于本地對(duì)象編譯,而這些對(duì)象是系統(tǒng)類庫(kù)的一部分。這樣的構(gòu)件應(yīng)該是一直可用的,Maven也不會(huì)在倉(cāng)庫(kù)中去尋找它。 如果你將一個(gè)依賴范圍設(shè)置成系統(tǒng)范圍,你必須同時(shí)提供一個(gè)systemPath元素 。注意該范圍是不推薦使用的(應(yīng)該一直盡量去從公共或定制的Maven倉(cāng)庫(kù)中引用依賴)。 |
dependency中的type一般不用配置,默認(rèn)是jar。當(dāng)type為pom時(shí),代表引用關(guān)系:
此時(shí),本項(xiàng)目會(huì)將persistence-deps的所有jar包導(dǎo)入依賴庫(kù)。
可以創(chuàng)建一個(gè)打包方式為pom項(xiàng)目來(lái)將某些通用的依賴歸在一起,供其他項(xiàng)目直接引用,不要忘了指定依賴類型為pom(<type>pom</type>)。
繼承關(guān)系
繼承就是避免重復(fù),maven的繼承也是這樣,它還有一個(gè)好處就是讓項(xiàng)目更加安全。項(xiàng)目之間存在上下級(jí)關(guān)系時(shí)就屬于繼承關(guān)系。
父項(xiàng)目的配置如下:
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>org.clf.parent</groupId>
<artifactId>my-parent</artifactId>
<version>2.0</version>
<packaging>pom</packaging>
<!-- 該節(jié)點(diǎn)下的依賴會(huì)被子項(xiàng)目自動(dòng)全部繼承 -->
<dependencies>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.7</version>
<type>jar</type>
<scope>compile</scope>
</dependency>
</dependencies>
<dependencyManagement>
<!-- 該節(jié)點(diǎn)下的依賴關(guān)系只是為了統(tǒng)一版本號(hào),不會(huì)被子項(xiàng)目自動(dòng)繼承,-->
<!--除非子項(xiàng)目主動(dòng)引用,好處是子項(xiàng)目可以不用寫(xiě)版本號(hào) -->
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-orm</artifactId>
<version>4.2.5.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>4.2.5.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context-support</artifactId>
<version>4.2.5.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-beans</artifactId>
<version>4.2.5.RELEASE</version>
</dependency>
</dependencies>
</dependencyManagement>
<!-- 這個(gè)元素和dependencyManagement相類似,它是用來(lái)進(jìn)行插件管理的-->
<pluginManagement>
......
</pluginManagement>
</project>
注意,此時(shí)<packaging>必須為pom。
為了項(xiàng)目的正確運(yùn)行,必須讓所有的子項(xiàng)目使用依賴項(xiàng)的統(tǒng)一版本,必須確保應(yīng)用的各個(gè)項(xiàng)目的依賴項(xiàng)和版本一致,才能保證測(cè)試的和發(fā)布是相同的結(jié)果。
Maven 使用dependencyManagement 元素來(lái)提供了一種管理依賴版本號(hào)的方式。通常會(huì)在一個(gè)組織或者項(xiàng)目的最頂層的父POM 中看到dependencyManagement 元素。使用pom.xml 中的dependencyManagement 元素能讓所有在子項(xiàng)目中引用一個(gè)依賴而不用顯式的列出版本號(hào)。Maven 會(huì)沿著父子層次向上走,直到找到一個(gè)擁有dependencyManagement元素的項(xiàng)目,然后它就會(huì)使用在這個(gè)dependencyManagement 元素中指定的版本號(hào)。
父項(xiàng)目在dependencies聲明的依賴,子項(xiàng)目會(huì)從全部自動(dòng)地繼承。而父項(xiàng)目在dependencyManagement里只是聲明依賴,并不實(shí)現(xiàn)引入,因此子項(xiàng)目需要顯示的聲明需要用的依賴。如果不在子項(xiàng)目中聲明依賴,是不會(huì)從父項(xiàng)目中繼承下來(lái)的;只有在子項(xiàng)目中寫(xiě)了該依賴項(xiàng),并且沒(méi)有指定具體版本,才會(huì)從父項(xiàng)目中繼承該項(xiàng),并且version和scope都讀取自父pom另外如果子項(xiàng)目中指定了版本號(hào),那么會(huì)使用子項(xiàng)目中指定的jar版本。
如果某個(gè)項(xiàng)目需要繼承該父項(xiàng)目,基礎(chǔ)配置應(yīng)該這樣:
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>org.clf.parent.son</groupId>
<artifactId>my-son</artifactId>
<version>1.0</version>
<!-- 聲明將父項(xiàng)目的坐標(biāo) -->
<parent>
<groupId>org.clf.parent</groupId>
<artifactId>my-parent</artifactId>
<version>2.0</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-project/pom.xml</relativePath>
</parent>
<!-- 聲明父項(xiàng)目dependencyManagement的依賴,不用寫(xiě)版本號(hào) -->
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-beans</artifactId>
</dependency>
</dependencies>
</project>
聚合關(guān)系
隨著技術(shù)的飛速發(fā)展和各類用戶對(duì)軟件的要求越來(lái)越高,軟件本身也變得越來(lái)越復(fù)雜,然后軟件設(shè)計(jì)人員開(kāi)始采用各種方式進(jìn)行開(kāi)發(fā),于是就有了我們的分層架構(gòu)、分模塊開(kāi)發(fā),來(lái)提高代碼的清晰和重用。針對(duì)于這一特性,maven也給予了相應(yīng)的配置。
maven的多模塊管理也是非常強(qiáng)大的。一般來(lái)說(shuō),maven要求同一個(gè)工程的所有模塊都放置到同一個(gè)目錄下,每一個(gè)子目錄代表一個(gè)模塊,比如
總項(xiàng)目/
? |--- pom.xml 總項(xiàng)目的pom配置文件
? |--- 子模塊1/
?? |--- pom.xml 子模塊1的pom文件
? |--- 子模塊2/
?? |--- pom.xml子模塊2的pom文件
總項(xiàng)目的配置如下:
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>org.clf.parent</groupId>
<artifactId>my-parent</artifactId>
<version>2.0</version>
<!-- 打包類型必須為pom -->
<packaging>pom</packaging>
<!-- 聲明了該項(xiàng)目的直接子模塊 -->
<modules>
<!-- 這里配置的不是artifactId,而是這個(gè)模塊的目錄名稱-->
<module>module-1</module>
<module>module-2</module>
<module>module-3</module>
</modules>
<!-- 聚合也屬于父子關(guān)系,總項(xiàng)目中的dependencies與dependencyManagement、pluginManagement用法與繼承關(guān)系類似 -->
<dependencies>
......
</dependencies>
<dependencyManagement>
......
</dependencyManagement>
<pluginManagement>
......
</pluginManagement>
</project>
子模塊的配置如下:
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>org.clf.parent.son</groupId>
<artifactId>my-son</artifactId>
<version>1.0</version>
<!-- 聲明將父項(xiàng)目的坐標(biāo) -->
<parent>
<groupId>org.clf.parent</groupId>
<artifactId>my-parent</artifactId>
<version>2.0</version>
</parent>
</project>
繼承與聚合的關(guān)系
首先,繼承與聚合都屬于父子關(guān)系,并且,聚合 POM與繼承關(guān)系中的父POM的packaging都是pom。
不同的是,對(duì)于聚合模塊來(lái)說(shuō),它知道有哪些被聚合的模塊,但那些被聚合的模塊不知道這個(gè)聚合模塊的存在。對(duì)于繼承關(guān)系的父 POM來(lái)說(shuō),它不知道有哪些子模塊繼承與它,但那些子模塊都必須知道自己的父 POM是什么。
在實(shí)際項(xiàng)目中,一個(gè) POM往往既是聚合POM,又是父 POM,它繼承了某個(gè)項(xiàng)目,本身包含幾個(gè)子模塊,同時(shí)肯定會(huì)存在普通的依賴關(guān)系,就是說(shuō),依賴、繼承、聚合這三種關(guān)系是并存的。
Maven可繼承的POM 元素列表如下:
groupId :項(xiàng)目組 ID ,項(xiàng)目坐標(biāo)的核心元素;
version :項(xiàng)目版本,項(xiàng)目坐標(biāo)的核心元素;
description :項(xiàng)目的描述信息;
organization :項(xiàng)目的組織信息;
inceptionYear :項(xiàng)目的創(chuàng)始年份;
url :項(xiàng)目的 url 地址
develoers :項(xiàng)目的開(kāi)發(fā)者信息;
contributors :項(xiàng)目的貢獻(xiàn)者信息;
distributionManagerment:項(xiàng)目的部署信息;
issueManagement :缺陷跟蹤系統(tǒng)信息;
ciManagement :項(xiàng)目的持續(xù)繼承信息;
scm :項(xiàng)目的版本控制信息;
mailingListserv :項(xiàng)目的郵件列表信息;
properties :自定義的 Maven 屬性;
dependencies :項(xiàng)目的依賴配置;
dependencyManagement:醒目的依賴管理配置;
repositories :項(xiàng)目的倉(cāng)庫(kù)配置;
build :包括項(xiàng)目的源碼目錄配置、輸出目錄配置、插件配置、插件管理配置等;
reporting :包括項(xiàng)目的報(bào)告輸出目錄配置、報(bào)告插件配置等。