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