maven如何修改本地倉庫與中央倉庫

什麼是Maven倉庫

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

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

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

 

本地倉庫 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 ：

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中發現以下配置：

Xml代碼 

1. <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>的更詳細的配置及相關解釋，請參考：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>  
      <!-- repositories and pluginRepositories here-->  
    </profile>  
  </profiles>  
  <activeProfiles>  
    <activeProfile>dev</activeProfile>  
  </activeProfiles>  
  ...  
</settings>

1. 使用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>

1. Xml代碼

2.  

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

1. 關於更加高級的鏡像配置，能夠參考：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>

通常來講，分發構件到遠程倉庫須要認證，若是你沒有配置任何認證信息，你每每會獲得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>

 

小結

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