Maven讀書系列：Maven倉庫

時間 2019-11-08

標籤 maven 讀書系列倉庫欄目 Maven 简体版

原文原文鏈接

什麼是Maven倉庫

在不用Maven的時候，好比說之前咱們用Ant構建項目，在項目目錄下，每每會看到一個名爲/lib的子目錄，那裏存放着各種第三方依賴jar文件，如log4j.jar，junit.jar等等。每創建一個項目，你都須要創建這樣的一個/lib目錄，而後複製一對jar文件，這是很明顯的重複。重複永遠是噩夢的起點，多個項目不共用相同的jar文件，不只會形成磁盤資源的浪費，也使得版本的一致性管理變得困難。此外，若是你使用版本管理工具，如SVN（你沒有使用版本管理工具？立刻試試SVN吧，它能幫你解決不少頭疼的問題），你須要將大量的jar文件提交到代碼庫裏，但是版本管理工具在處理二進制文件方面並不出色。html

Maven倉庫就是放置全部JAR文件（WAR，ZIP，POM等等）的地方，全部Maven項目能夠從同一個Maven倉庫中獲取本身所須要的依賴JAR，這節省了磁盤資源。此外，因爲Maven倉庫中全部的JAR都有其本身的座標，該座標告訴Maven它的組ID，構件ID，版本，打包方式等等，所以Maven項目能夠方便的進行依賴版本管理。你也不在須要提交JAR文件到SCM倉庫中，你能夠創建一個組織層次的Maven倉庫，供全部成員使用。java

簡言之，Maven倉庫能幫助咱們管理構件（主要是JAR）。apache

本地倉庫 vs. 遠程倉庫

運行Maven的時候，Maven所須要的任何構件都是直接從本地倉庫獲取的。若是本地倉庫沒有，它會首先嚐試從遠程倉庫下載構件至本地倉庫，而後再使用本地倉庫的構件。maven

好比說，你的項目配置了junit-3.8的依賴，在你運行mvn test 的時候，Maven須要使用junit-3.8的jar文件，它首先根據座標查找本地倉庫，若是找到，就直接使用。若是沒有，Maven會檢查可用的遠程倉庫配置，而後逐個嘗試這些遠程倉庫去下載junit-3.8的jar文件，若是遠程倉庫存在該文件，Maven會將其下載到本地倉庫中，繼而使用。若是嘗試過全部遠程倉庫以後，Maven仍是沒可以下載到該文件，它就會報錯。ide

Maven缺省的本地倉庫地址爲${user.home}/.m2/repository 。也就是說，一個用戶會對應的擁有一個本地倉庫。工具

你也能夠自定義本地倉庫的位置，修改${user.home}/.m2/settings.xml ：ui

Xml代碼 url

<settings> spa
... .net
<localRepository>D:\java\repository</localRepository>
...
</settings>

你還能夠在運行時指定本地倉庫位置：

mvn clean install -Dmaven.repo.local=/home/juven/myrepo/

還有一點須要理解的是，當咱們運行install的時候，Maven其實是將項目生成的構件安裝到了本地倉庫，也就是說，只有install了以後，其它項目才能使用此項目生成的構件。

瞭解了本地倉庫，接着瞭解一下Maven缺省的遠程倉庫，即Maven中央倉庫。

安裝好Maven以後，咱們能夠創建一個簡單的項目，配置一些簡單的依賴，而後運行mvn clean install，項目就構建好了。咱們沒有手工的去下載任何jar文件，這一切都是由於Maven中央倉庫的存在，當Maven在本地倉庫找不到須要的jar文件時，它會查找遠程倉庫，而一個原始的Maven安裝就自帶了一個遠程倉庫——Maven中央倉庫。

這個Maven中央倉庫是在哪裏定義的呢？在個人機器上，我安裝了maven-2.0.10，我能夠找到這個文件：${M2_HOME}/lib/maven-2.0.10-uber.jar ，打開該文件，能找到超級POM：\org\apache\maven\project\pom-4.0.0.xml ，它是全部Maven POM的父POM，全部Maven項目繼承該配置，你能夠在這個POM中發現以下配置：

Xml代碼

<repositories>
<repository>
<id>central</id>
<name>Maven Repository Switchboard</name>
<layout>default</layout>
<url>http://repo1.maven.org/maven2</url>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>

關於遠程倉庫的配置，下面的小節我會詳細解釋，這裏咱們只要知道，中央倉庫的id爲central，遠程url地址爲http://repo1.maven.org/maven2，它關閉了snapshot版本構件下載的支持。

在POM中配置遠程倉庫

前面咱們看到超級POM配置了ID爲central的遠程倉庫，咱們能夠在POM中配置其它的遠程倉庫。這樣作的緣由有不少，好比你有一個局域網的遠程倉庫，使用該倉庫能大大提升下載速度，繼而提升構建速度，也有可能你依賴的一個jar在central中找不到，它只存在於某個特定的公共倉庫，這樣你也不得不添加那個遠程倉庫的配置。

這裏我配置一個遠程倉庫指向中央倉庫的中國鏡像：

Xml代碼

<project>
...
<repositories>
<repository>
<id>maven-net-cn</id>
<name>Maven China Mirror</name>
<url>http://maven.net.cn/content/groups/public/</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>maven-net-cn</id>
<name>Maven China Mirror</name>
<url>http://maven.net.cn/content/groups/public/</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>
...
</project>

咱們先看一下<repositories>的配置，你能夠在它下面添加多個<repository> ，每一個<repository>都有它惟一的ID，一個描述性的name，以及最重要的，遠程倉庫的url。此外，<releases><enabled>true</enabled></releases>告訴Maven能夠從這個倉庫下載releases版本的構件，而<snapshots><enabled>false</enabled></snapshots>告訴Maven不要從這個倉庫下載snapshot版本的構件。禁止從公共倉庫下載snapshot構件是推薦的作法，由於這些構件不穩定，且不受你控制，你應該避免使用。固然，若是你想使用局域網內組織內部的倉庫，你能夠激活snapshot的支持。

關於<repositories>的更詳細的配置及相關解釋，請參考：http://www.sonatype.com/books/maven-book/reference_zh/apas02s08.html。

至於<pluginRepositories>，這是配置Maven從什麼地方下載插件構件（Maven的全部實際行爲都由其插件完成）。該元素的內部配置和<repository>徹底同樣，再也不解釋。

在settings.xml中配置遠程倉庫

咱們知道了如何在POM中配置遠程倉庫，但考慮這樣的狀況：在一個公司內部，同時進行這3個項目，並且之後隨着這幾個項目的結束，愈來愈多的項目會開始；同時，公司內部創建一個Maven倉庫。咱們統一爲全部這些項目配置該倉庫，因而不得不爲每一個項目提供一樣的配置。問題出現了，這是重複！

其實咱們能夠作到只配置一次，在哪裏配置呢？就是settings.xml。

不過事情沒有那麼簡單，不是簡單的將POM中的<repositories>及<pluginRepositories>元素複製到settings.xml中就能夠，setting.xml不直接支持這兩個元素。但咱們仍是有一個並不複雜的解決方案，就是利用profile，以下：

Xml代碼

<settings>
...
<profiles>
<profile>
<id>dev</id>
</profile>
</profiles>
<activeProfiles>
<activeProfile>dev</activeProfile>
</activeProfiles>
...
</settings>

這裏咱們定義一個id爲dev的profile，將全部repositories以及pluginRepositories元素放到這個profile中，而後，使用<activeProfiles>元素自動激活該profile。這樣，你就不用再爲每一個POM重複配置倉庫。

使用profile爲settings.xml添加倉庫提供了一種用戶全局範圍的倉庫配置。

鏡像

若是你的地理位置附近有一個速度更快的central鏡像，或者你想覆蓋central倉庫配置，或者你想爲全部POM使用惟一的一個遠程倉庫（這個遠程倉庫代理的全部必要的其它倉庫），你可使用settings.xml中的mirror配置。

如下的mirror配置用maven.net.cn覆蓋了Maven自帶的central：

Xml代碼

<settings>
...
<mirrors>
<mirror>
<id>maven-net-cn</id>
<name>Maven China Mirror</name>
<url>http://maven.net.cn/content/groups/public/</url>
<mirrorOf>central</mirrorOf>
</mirror>
</mirrors>
...
</settings>

這裏惟一須要解釋的是<mirrorOf>，這裏咱們配置central的鏡像，咱們也能夠配置一個全部倉庫的鏡像，以保證該鏡像是Maven惟一使用的倉庫：

Xml代碼

<settings>
...
<mirrors>
<mirror>
<id>my-org-repo</id>
<name>Repository in My Orgnization</name>
<url>http://192.168.1.100/maven2</url>
<mirrorOf>*</mirrorOf>
</mirror>
</mirrors>
...
</settings>

關於更加高級的鏡像配置，能夠參考：http://maven.apache.org/guides/mini/guide-mirror-settings.html。

分發構件至遠程倉庫

mvn install 會將項目生成的構件安裝到本地Maven倉庫，mvn deploy 用來將項目生成的構件分發到遠程Maven倉庫。本地Maven倉庫的構件只能供當前用戶使用，在分發到遠程Maven倉庫以後，全部能訪問該倉庫的用戶都能使用你的構件。

咱們須要配置POM的distributionManagement來指定Maven分發構件的位置，以下：

Xml代碼

<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區別對待release版本的構件和snapshot版本的構件，snapshot爲開發過程當中的版本，實時，但不穩定，release版本則比較穩定。Maven會根據你項目的版原本判斷將構件分發到哪一個倉庫。

通常來講，分發構件到遠程倉庫須要認證，若是你沒有配置任何認證信息，你每每會獲得401錯誤。這個時候，以下在settings.xml中配置認證信息：

Xml代碼

<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的值徹底一致。將認證信息放到settings下而非POM中，是由於POM每每是它人可見的，而settings.xml是本地的。

小結

本文介紹了Maven倉庫，它是什麼？本地倉庫，遠程倉庫，中央倉庫具體是指什麼？並介紹瞭如何在POM中配置項目層次的倉庫，在settings中配置用戶層次的倉庫，以及mirror。本文還介紹瞭如何安裝構件到本地倉庫，如何分發構件至倉庫。

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。