什么是Maven倉(cāng)庫(kù)
在不用Maven的時(shí)候,比如說(shuō)以前我們用Ant構(gòu)建項(xiàng)目身辨,在項(xiàng)目目錄下丐谋,往往會(huì)看到一個(gè)名為/lib的子目錄,那里存放著各類第三方依賴jar文件煌珊,如log4j.jar号俐,junit.jar等等。每建立一個(gè)項(xiàng)目怪瓶,你都需要建立這樣的一個(gè)/lib目錄萧落,然后復(fù)制一對(duì)jar文件践美,這是很明顯的重復(fù)洗贰。重復(fù)永遠(yuǎn)是噩夢(mèng)的起點(diǎn),多個(gè)項(xiàng)目不共用相同的jar文件陨倡,不僅會(huì)造成磁盤資源的浪費(fèi)敛滋,也使得版本的一致性管理變得困難。此外兴革,如果你使用版本管理工具绎晃,如git,你需要將大量的jar文件提交到代碼庫(kù)里杂曲,可是版本管理工具在處理二進(jìn)制文件方面并不出色庶艾。
Maven倉(cāng)庫(kù)就是放置所有JAR文件(WAR,ZIP擎勘,POM等等)的地方咱揍,所有Maven項(xiàng)目可以從同一個(gè)Maven倉(cāng)庫(kù)中獲取自己所需要的依賴JAR,這節(jié)省了磁盤資源棚饵。此外煤裙,由于Maven倉(cāng)庫(kù)中所有的JAR都有其自己的坐標(biāo)掩完,該坐標(biāo)告訴Maven它的組ID,構(gòu)件ID硼砰,版本且蓬,打包方式等等,因此Maven項(xiàng)目可以方便的進(jìn)行依賴版本管理题翰。你也不在需要提交JAR文件到SCM倉(cāng)庫(kù)中恶阴,你可以建立一個(gè)組織層次的Maven倉(cāng)庫(kù),供所有成員使用豹障。
簡(jiǎn)言之存淫,Maven倉(cāng)庫(kù)能幫助我們管理構(gòu)件(主要是JAR)。
本地倉(cāng)庫(kù) vs. 遠(yuǎn)程倉(cāng)庫(kù)
運(yùn)行Maven的時(shí)候沼填,Maven所需要的任何構(gòu)件都是直接從本地倉(cāng)庫(kù)獲取的桅咆。如果本地倉(cāng)庫(kù)沒有,它會(huì)首先嘗試從遠(yuǎn)程倉(cāng)庫(kù)下載構(gòu)件至本地倉(cāng)庫(kù)坞笙,然后再使用本地倉(cāng)庫(kù)的構(gòu)件岩饼。
比如說(shuō),你的項(xiàng)目配置了junit-3.8的依賴薛夜,在你運(yùn)行mvn test 的時(shí)候籍茧,Maven需要使用junit-3.8的jar文件,它首先根據(jù)坐標(biāo)查找本地倉(cāng)庫(kù)梯澜,如果找到寞冯,就直接使用。如果沒有晚伙,Maven會(huì)檢查可用的遠(yuǎn)程倉(cāng)庫(kù)配置吮龄,然后逐個(gè)嘗試這些遠(yuǎn)程倉(cāng)庫(kù)去下載junit-3.8的jar文件,如果遠(yuǎn)程倉(cāng)庫(kù)存在該文件咆疗,Maven會(huì)將其下載到本地倉(cāng)庫(kù)中漓帚,繼而使用。如果嘗試過(guò)所有遠(yuǎn)程倉(cāng)庫(kù)之后午磁,Maven還是沒能夠下載到該文件尝抖,它就會(huì)報(bào)錯(cuò)。
Maven缺省的本地倉(cāng)庫(kù)地址為${user.home}/.m2/repository
迅皇。也就是說(shuō)昧辽,一個(gè)用戶會(huì)對(duì)應(yīng)的擁有一個(gè)本地倉(cāng)庫(kù)。
你也可以自定義本地倉(cāng)庫(kù)的位置登颓,修改${user.home}/.m2/settings.xml
:
<settings>
...
<localRepository>D:\java\repository</localRepository>
...
</settings>
你還可以在運(yùn)行時(shí)指定本地倉(cāng)庫(kù)位置:
mvn clean install -Dmaven.repo.local=/home/juven/myrepo/
還有一點(diǎn)需要理解的是搅荞,當(dāng)我們運(yùn)行install的時(shí)候,Maven實(shí)際上是將項(xiàng)目生成的構(gòu)件安裝到了本地倉(cāng)庫(kù),也就是說(shuō)取具,只有install了之后脖隶,其它項(xiàng)目才能使用此項(xiàng)目生成的構(gòu)件。
了解了本地倉(cāng)庫(kù)暇检,接著了解一下Maven缺省的遠(yuǎn)程倉(cāng)庫(kù)产阱,即Maven中央倉(cāng)庫(kù)。
Maven中央倉(cāng)庫(kù)地址:https://mvnrepository.com/
Maven中央倉(cāng)庫(kù)源地址:https://repo.maven.apache.org/maven2/
安裝好Maven之后块仆,我們可以建立一個(gè)簡(jiǎn)單的項(xiàng)目构蹬,配置一些簡(jiǎn)單的依賴,然后運(yùn)行mvn clean install悔据,項(xiàng)目就構(gòu)建好了庄敛。我們沒有手工的去下載任何jar文件,這一切都是因?yàn)镸aven中央倉(cāng)庫(kù)的存在科汗,當(dāng)Maven在本地倉(cāng)庫(kù)找不到需要的jar文件時(shí)藻烤,它會(huì)查找遠(yuǎn)程倉(cāng)庫(kù),而一個(gè)原始的Maven安裝就自帶了一個(gè)遠(yuǎn)程倉(cāng)庫(kù)——Maven中央倉(cāng)庫(kù)头滔。
這個(gè)Maven中央倉(cāng)庫(kù)是在哪里定義的呢怖亭?
- maven的superpom, 每個(gè)項(xiàng)目都繼承的pom
- 位置:
$M2_HOME/lib/maven-model-builder.jar
在我的機(jī)器上,我安裝了maven-3.6.2坤检,
我可以找到這個(gè)文件:apache-maven-3.6.2\lib\maven-model-builder-3.6.2.jar
打開該文件兴猩,能找到超級(jí)POM:\org\apache\maven\model\pom-4.0.0.xml
,如下圖所示:
它是所有Maven POM的父POM早歇,所有Maven項(xiàng)目繼承該配置倾芝,你可以在這個(gè)POM中發(fā)現(xiàn)如下配置:
關(guān)于遠(yuǎn)程倉(cāng)庫(kù)的配置,下面的小節(jié)我會(huì)詳細(xì)解釋箭跳,這里我們只要知道晨另,中央倉(cāng)庫(kù)的id為central,遠(yuǎn)程url地址為
https://repo.maven.apache.org/maven2
衅码,它關(guān)閉了snapshot版本構(gòu)件下載的支持拯刁。
在POM中配置遠(yuǎn)程倉(cāng)庫(kù)
前面我們看到超級(jí)POM配置了ID為central的遠(yuǎn)程倉(cāng)庫(kù),我們可以在POM中配置其它的遠(yuǎn)程倉(cāng)庫(kù)逝段。這樣做的原因有很多,比如你有一個(gè)局域網(wǎng)的遠(yuǎn)程倉(cāng)庫(kù)割捅,使用該倉(cāng)庫(kù)能大大提高下載速度奶躯,繼而提高構(gòu)建速度,也有可能你依賴的一個(gè)jar在central中找不到亿驾,它只存在于某個(gè)特定的公共倉(cāng)庫(kù)嘹黔,這樣你也不得不添加那個(gè)遠(yuǎn)程倉(cāng)庫(kù)的配置。
我這里配置一個(gè)指向阿里云的倉(cāng)庫(kù):
<project>
...
<repositories>
<repository>
<id>spring</id>
<name>maven repository for spring</name>
<url>https://maven.aliyun.com/repository/spring</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>spring</id>
<name>maven repository for spring</name>
<url>https://maven.aliyun.com/repository/spring</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>
...
</project>
我們先看一下<repositories>
的配置,你可以在它下面添加多個(gè)<repository>
儡蔓,每個(gè)<repository>
都有它唯一的ID郭蕉,一個(gè)描述性的name,以及最重要的喂江,遠(yuǎn)程倉(cāng)庫(kù)的url召锈。此外,<releases><enabled>true</enabled></releases>
告訴Maven可以從這個(gè)倉(cāng)庫(kù)下載releases版本的構(gòu)件获询,而<snapshots><enabled>false</enabled></snapshots>
告訴Maven不要從這個(gè)倉(cāng)庫(kù)下載snapshot版本的構(gòu)件涨岁。禁止從公共倉(cāng)庫(kù)下載snapshot構(gòu)件是推薦的做法,因?yàn)檫@些構(gòu)件不穩(wěn)定吉嚣,且不受你控制梢薪,你應(yīng)該避免使用。當(dāng)然尝哆,如果你想使用局域網(wǎng)內(nèi)組織內(nèi)部的倉(cāng)庫(kù)秉撇,你可以激活snapshot的支持。
至于<pluginRepositories>
秋泄,這是配置Maven從什么地方下載插件構(gòu)件(Maven的所有實(shí)際行為都由其插件完成)畜疾。該元素的內(nèi)部配置和<repository>
完全一樣,不再解釋印衔。
在settings.xml中配置遠(yuǎn)程倉(cāng)庫(kù)
我們知道了如何在POM中配置遠(yuǎn)程倉(cāng)庫(kù)啡捶,但考慮這樣的情況:在一個(gè)公司內(nèi)部,同時(shí)進(jìn)行這3個(gè)項(xiàng)目奸焙,而且以后隨著這幾個(gè)項(xiàng)目的結(jié)束瞎暑,越來(lái)越多的項(xiàng)目會(huì)開始;同時(shí)与帆,公司內(nèi)部建立一個(gè)Maven倉(cāng)庫(kù)了赌。我們統(tǒng)一為所有這些項(xiàng)目配置該倉(cāng)庫(kù),于是不得不為每個(gè)項(xiàng)目提供同樣的配置玄糟。問題出現(xiàn)了勿她,這是重復(fù) !
其實(shí)我們可以做到只配置一次阵翎,在哪里配置呢逢并?就是settings.xml。
不過(guò)事情沒有那么簡(jiǎn)單郭卫,不是簡(jiǎn)單的將POM中的<repositories>及<pluginRepositories>元素復(fù)制到settings.xml中就可以砍聊,setting.xml不直接支持 這兩個(gè)元素。但我們還是有一個(gè)并不復(fù)雜的解決方案贰军,就是利用profile玻蝌,如下:
<settings>
...
<profiles>
<profile>
<id>dev</id>
<!-- repositories and pluginRepositories here-->
<id>spring</id>
<name>maven repository for spring</name>
<url>https://maven.aliyun.com/repository/spring</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</profile>
</profiles>
<activeProfiles>
<activeProfile>dev</activeProfile>
</activeProfiles>
...
</settings>
這里我們定義一個(gè)id為dev的profile,將所有repositories以及pluginRepositories元素放到這個(gè)profile中,然后俯树,使用<activeProfiles>
元素自動(dòng)激活該profile帘腹。這樣,你就不用再為每個(gè)POM重復(fù)配置倉(cāng)庫(kù)许饿。
使用profile為settings.xml添加倉(cāng)庫(kù)提供了一種用戶全局范圍的倉(cāng)庫(kù)配置阳欲。
鏡像
如果你的地理位置附近有一個(gè)速度更快的central鏡像,或者你想覆蓋central倉(cāng)庫(kù)配置米辐,或者你想為所有POM使用唯一的一個(gè)遠(yuǎn)程倉(cāng)庫(kù)(這個(gè)遠(yuǎn)程倉(cāng)庫(kù)代理的所有必要的其它倉(cāng)庫(kù))胸完,你可以使用settings.xml中的mirror配置。
以下的mirror配置阿里云的central倉(cāng)庫(kù)覆蓋了Maven自帶的central:
<mirrors>
<!-- mirror
| Specifies a repository mirror site to use instead of a given repository. The repository that
| this mirror serves has an ID that matches the mirrorOf element of this mirror. IDs are used
| for inheritance and direct lookup purposes, and must be unique across the set of mirrors.
|
<mirror>
<id>mirrorId</id>
<mirrorOf>repositoryId</mirrorOf>
<name>Human Readable Name for this Mirror.</name>
<url>http://my.repository.com/repo/path</url>
</mirror>
-->
<mirror>
<id>nexus-aliyun</id>
<mirrorOf>central</mirrorOf>
<name>Nexus aliyun</name>
<url>https://maven.aliyun.com/repository/central</url>
</mirror>
</mirrors>
這里唯一需要解釋的是<mirrorOf>
翘贮,這里我們配置central的鏡像赊窥,我們也可以配置一個(gè)所有倉(cāng)庫(kù)的鏡像,以保證該鏡像是Maven唯一使用的倉(cāng)庫(kù):
<mirrors>
<!-- mirror
| Specifies a repository mirror site to use instead of a given repository. The repository that
| this mirror serves has an ID that matches the mirrorOf element of this mirror. IDs are used
| for inheritance and direct lookup purposes, and must be unique across the set of mirrors.
|
<mirror>
<id>mirrorId</id>
<mirrorOf>repositoryId</mirrorOf>
<name>Human Readable Name for this Mirror.</name>
<url>http://my.repository.com/repo/path</url>
</mirror>
-->
<mirror>
<id>nexus-aliyun</id>
<mirrorOf>*</mirrorOf>
<name>Nexus aliyun</name>
<url>https://maven.aliyun.com/repository/central</url>
</mirror>
</mirrors>
分發(fā)構(gòu)件至遠(yuǎn)程倉(cāng)庫(kù)
mvn install 會(huì)將項(xiàng)目生成的構(gòu)件安裝到本地Maven倉(cāng)庫(kù)狸页,mvn deploy 用來(lái)將項(xiàng)目生成的構(gòu)件分發(fā)到遠(yuǎn)程Maven倉(cāng)庫(kù)锨能。本地Maven倉(cāng)庫(kù)的構(gòu)件只能供當(dāng)前用戶使用,在分發(fā)到遠(yuǎn)程Maven倉(cāng)庫(kù)之后芍耘,所有能訪問該倉(cāng)庫(kù)的用戶都能使用你的構(gòu)件址遇。
我們需要配置POM的<distributionManagement>
來(lái)指定Maven分發(fā)構(gòu)件的位置,如下:
<project>
...
<distributionManagement>
<repository>
<id>nexus-releases</id>
<name>Nexus Release Repository</name>
<url>http://127.0.0.1:8080/nexus/content/repositories/releases/</url>
</repository>
<snapshotRepository>
<id>nexus-snapshots</id>
<name>Nexus Snapshot Repository</name>
<url>http://127.0.0.1:8080/nexus/content/repositories/snapshots/</url>
</snapshotRepository>
</distributionManagement>
...
</project>
Maven區(qū)別對(duì)待release版本的構(gòu)件和snapshot版本的構(gòu)件斋竞,snapshot為開發(fā)過(guò)程中的版本倔约,實(shí)時(shí),但不穩(wěn)定坝初,release版本則比較穩(wěn)定浸剩。Maven會(huì)根據(jù)你項(xiàng)目的版本來(lái)判斷將構(gòu)件分發(fā)到哪個(gè)倉(cāng)庫(kù)。
一般來(lái)說(shuō)鳄袍,分發(fā)構(gòu)件到遠(yuǎn)程倉(cāng)庫(kù)需要認(rèn)證绢要,如果你沒有配置任何認(rèn)證信息,你往往會(huì)得到401錯(cuò)誤拗小。這個(gè)時(shí)候重罪,如下在settings.xml中配置認(rèn)證信息:
<settings>
...
<servers>
<server>
<id>nexus-releases</id>
<username>admin</username>
<password>admin123</password>
</server>
<server>
<id>nexus-snapshots</id>
<username>admin</username>
<password>admin123</password>
</server>
</servers>
...
</settings>
需要注意的是,settings.xml中server元素下id的值必須與POM中repository或snapshotRepository下id的值完全一致哀九。將認(rèn)證信息放到settings下而非POM中剿配,是因?yàn)镻OM往往是它人可見的,而settings.xml是本地的勾栗。
參考文章
https://www.cnblogs.com/shengulong/p/11167371.html
https://www.iteye.com/blog/juvenshun-359256