Maven中的庫（repository）詳解

Maven中的庫（repository）是構件（artifact）的集合。構件以一定的布局存儲在庫中。

本地倉庫 vs. 遠程倉庫

運行Maven的時候，Maven所需要的任何構件都是直接從本地倉庫獲取的。如果本地倉庫沒有，它會首先嘗試從遠程倉庫下載構件至本地倉庫，然后再使用本地倉庫的構件。

比如說，你的項目配置了junit-3.8的依賴，在你運行mvn test 的時候，Maven需要使用junit-3.8的jar文件，它首先根據坐標查找本地倉庫，如果找到，就直接使用。如果沒有，Maven會檢查可用的遠程倉庫配置，然后逐個嘗試這些遠程倉庫去下載junit-3.8的jar文件，如果遠程倉庫存在該文件，Maven會將其下載到本地倉庫中，繼而使用。如果嘗試過所有遠程倉庫之后，Maven還是沒能夠下載到該文件，它就會報錯。

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

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

<settings> ... <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中發現如下配置：

<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中找不到，它只存在於某個特定的公共倉庫，這樣你也不得不添加那個遠程倉庫的配置。

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

<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，如下：

<settings> ... <profiles>  
    <profile>  
      <id>dev</id>  
      <!-- repositories and pluginRepositories here-->  
    </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：

<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唯一使用的倉庫：

<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>  

分發構件至遠程倉庫

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

我們需要配置POM的distributionManagement來指定Maven分發構件的位置，如下：

<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中配置認證信息：

<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是本地的。