天天看點

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"

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>

<repositories>

<repository>

<id>companyname.lib1</id>

<url>http://download.companyname.org/maven2/lib1</url>

</repository>

<id>companyname.lib2</id>

<url>http://download.companyname.org/maven2/lib2</url>

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

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

url 'https://maven.aliyun.com/repository/spring/'

加入你要引用的檔案資訊:

dependencies {

compile '[GROUP_ID]:[ARTIFACT_ID]:[VERSION]'

執行以下指令安裝依賴:

gradle dependencies 
或 
./gradlew dependencies