Maven 倉庫

在 Maven 的術語中,倉庫是一個位置(place)。

Maven 倉庫是項目中依賴的第三方庫,這個庫所在的位置叫做倉庫。

在 Maven 中,任何一個依賴、插件或者項目構建的輸出,都可以稱之為構件。

Maven 倉庫能幫助我們管理構件(主要是JAR),它就是放置所有JAR文件(WAR,ZIP,POM等等)的地方。

Maven 倉庫有三種類型:

  • 本地(local)
  • 中央(central)
  • 遠程(remote)

本地倉庫

Maven 的本地倉庫,在安裝 Maven 後並不會創建,它是在第一次執行 maven 命令的時候才被創建。

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

默認情況下,不管Linux還是 Windows,每個用戶在自己的用戶目錄下都有一個路徑名為 .m2/repository/ 的倉庫目錄。

Maven 本地倉庫默認被創建在 %USER_HOME% 目錄下。要修改默認位置,在 %M2_HOME%\conf 目錄中的 Maven 的 settings.xml 文件中定義另一個路徑。

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> <localRepository>C:/MyLocalRepository</localRepository> </settings>

當你運行 Maven 命令,Maven 將下載依賴的文件到你指定的路徑中。


中央倉庫

Maven 中央倉庫是由 Maven 社區提供的倉庫,其中包含了大量常用的庫。

中央倉庫包含了絕大多數流行的開源Java構件,以及源碼、作者信息、SCM、信息、許可證信息等。一般來說,簡單的Java項目依賴的構件都可以在這裏下載到。

中央倉庫的關鍵概念:

  • 這個倉庫由 Maven 社區管理。
  • 不需要配置。
  • 需要通過網絡才能訪問。

要瀏覽中央倉庫的內容,maven 社區提供了一個 URL:http://search.maven.org/#browse。使用這個倉庫,開發人員可以搜索所有可以獲取的代碼庫。


遠程倉庫

如果 Maven 在中央倉庫中也找不到依賴的文件,它會停止構建過程並輸出錯誤信息到控製台。為避免這種情況,Maven 提供了遠程倉庫的概念,它是開發人員自己定製倉庫,包含了所需要的代碼庫或者其他工程中用到的 jar 文件。

舉例說明,使用下麵的 pom.xml,Maven 將從遠程倉庫中下載該 pom.xml 中聲明的所依賴的(在中央倉庫中獲取不到的)文件。

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.companyname.projectgroup</groupId> <artifactId>project</artifactId> <version>1.0</version> <dependencies> <dependency> <groupId>com.companyname.common-lib</groupId> <artifactId>common-lib</artifactId> <version>1.0.0</version> </dependency> <dependencies> <repositories> <repository> <id>companyname.lib1</id> <url>http://download.companyname.org/maven2/lib1</url> </repository> <repository> <id>companyname.lib2</id> <url>http://download.companyname.org/maven2/lib2</url> </repository> </repositories> </project>

Maven 依賴搜索順序

當我們執行 Maven 構建命令時,Maven 開始按照以下順序查找依賴的庫:

  • 步驟 1 - 在本地倉庫中搜索,如果找不到,執行步驟 2,如果找到了則執行其他操作。
  • 步驟 2 - 在中央倉庫中搜索,如果找不到,並且有一個或多個遠程倉庫已經設置,則執行步驟 4,如果找到了則下載到本地倉庫中以備將來引用。
  • 步驟 3 - 如果遠程倉庫沒有被設置,Maven 將簡單的停滯處理並拋出錯誤(無法找到依賴的文件)。
  • 步驟 4 - 在一個或多個遠程倉庫中搜索依賴的文件,如果找到則下載到本地倉庫以備將來引用,否則 Maven 將停止處理並拋出錯誤(無法找到依賴的文件)。

Maven 阿裏雲(Aliyun)倉庫

Maven 倉庫默認在國外, 國內使用難免很慢,我們可以更換為阿裏雲的倉庫。

修改 maven 根目錄下的 conf 文件夾中的 settings.xml 文件,在 mirrors 節點上,添加內容如下:

<mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>阿裏雲公共倉庫</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>

如果想使用其它代理倉庫,可在 <repositories></repositories> 節點中加入對應的倉庫使用地址。以使用 spring 代理倉為例:

<repository> <id>spring</id> <url>https://maven.aliyun.com/repository/spring</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository>

在你的 pom.xml 文件 <denpendencies></denpendencies> 節點中加入你要引用的文件信息:

<dependency> <groupId>[GROUP_ID]</groupId> <artifactId>[ARTIFACT_ID]</artifactId> <version>[VERSION]</version> </dependency>

執行拉取命令:

mvn install

gradle 配置指南

在 build.gradle 文件中加入以下代碼:

allprojects { repositories { maven { url 'https://maven.aliyun.com/repository/public/' } mavenLocal() mavenCentral() } }

如果想使用其它代理倉,以使用spring倉為例,代碼如下:

allProjects { repositories { maven { url 'https://maven.aliyun.com/repository/public/' } maven { url 'https://maven.aliyun.com/repository/spring/' } mavenLocal() mavenCentral() } }

加入你要引用的文件信息:

dependencies { compile '[GROUP_ID]:[ARTIFACT_ID]:[VERSION]' }

執行以下命令安裝依賴:

gradle dependencies 
或 
./gradlew dependencies