maven多個(gè)倉(cāng)庫(kù)查詢的優(yōu)先級(jí)順序案例講解
上一篇我們?cè)斀饬藄etttings.xml的配置項(xiàng),里面的配置項(xiàng)基本都和倉(cāng)庫(kù)有關(guān)系,我們使用maven更多的也是要從倉(cāng)庫(kù)下載jar包,然后也把我們自己公共的jar包上傳到倉(cāng)庫(kù)。由于我們是可以配置多個(gè)倉(cāng)庫(kù)的,這時(shí)候就涉及到了一個(gè)問題:下載一個(gè)jar包時(shí),怎么確定這些倉(cāng)庫(kù)的使用順序?
1、官網(wǎng)的解釋
maven官網(wǎng)對(duì)這個(gè)問題給了一定的解答,如下:
Remote repository URLs are queried in the following order for artifacts until one returns a valid result:
1. effective settings:
1. Global
settings.xml
2. User
settings.xml
2. local effective build POM:
1. Local
pom.xml
2. Parent POMs, recursively
3. Super POM
3. effective POMs from dependency path to the artifact.
For each of these locations, the repositories within the profiles are queried first in the order outlined at Introduction to build profiles.
Before downloading from a repository, mirrors configuration is applied.
All profile elements in a POM from active profiles overwrite the global elements with the same name of the POM or extend those in case of collections. In case multiple profiles are active in the same POM or external file, the ones which are defined later take precedence over the ones defined earlier (independent of their profile id and activation order).
If a profile is active from
settings
, its values will override any equivalently ID'd profiles in a POM orprofiles.xml
file.
Take note that profiles in the
settings.xml
takes higher priority than profiles in the POM.
簡(jiǎn)單翻譯一下,就是:
- • 全局配置文件settings.xml中的配置項(xiàng)的優(yōu)先級(jí)最高,也就是maven安裝目錄下的conf/settings.xml優(yōu)先級(jí)最高
- • 其次是用戶級(jí)別的配置文件優(yōu)先級(jí)次高,默認(rèn)是${user.home}/.m2/settings.xml
- • 最后就是本地的pom.xml文件優(yōu)先級(jí)次次高
- • 當(dāng)確定了要查詢某個(gè)倉(cāng)庫(kù)時(shí),會(huì)先看這個(gè)倉(cāng)庫(kù)有沒有對(duì)應(yīng)的鏡像倉(cāng)庫(kù),如果有的話,則轉(zhuǎn)向去查鏡像倉(cāng)庫(kù),也就是會(huì)查當(dāng)前倉(cāng)庫(kù)的替代品(鏡像倉(cāng)庫(kù)),跳過對(duì)本倉(cāng)庫(kù)的檢索
- • 如果同一個(gè)pom文件里面有多個(gè)激活的profile,則靠后面激活的profile的優(yōu)先級(jí)高
- • 針對(duì)pom文件,如果有激活的profile,且profile里面配置了repositories,則profile里面的repositories的倉(cāng)庫(kù)優(yōu)先級(jí)比標(biāo)簽下面的repositories的優(yōu)先級(jí)高
- • pom文件中無論是project標(biāo)簽下面直接定義的repositories,還是profile標(biāo)簽下面定義的repositories,repositories內(nèi)部的repository的查詢順序,都是按照倉(cāng)庫(kù)定義的順序查詢,也就是自上而下查詢。
- • 如果settings.xml中的profile的id和pom文件中的profile的id一樣,則以settings.xml中的profile中配置的值為準(zhǔn)
- • 如果同一個(gè)pom文件中有多個(gè)profile被激活,那么處于profiles內(nèi)部靠后面生效的profile優(yōu)先級(jí)比profiles中靠前的profile的優(yōu)先級(jí)高
也就是整體的優(yōu)先級(jí)方面:
conf/settings.xml > ${user.home}/.m2/settings.xml >本地的pom.xml文件
2、案例講解
考慮到我們常用的配置文件是conf/settings.xml和工程里面的pom.xml文件,我們針對(duì)這兩個(gè)文件的結(jié)合來分析倉(cāng)庫(kù)的使用順序。
假如我們有如下的全局配置文件:settings.xml
<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 http://maven.apache.org/xsd/settings-1.2.0.xsd"> <localRepository>D:/programs/.m2/repository</localRepository> <servers> <server> <id>dev</id> <username>repouser</username> <password>repopwd</password> </server> </servers> <mirrors> <mirror> <id>nexus-aliyun</id> <mirrorOf>central</mirrorOf> <name>Nexus aliyun</name> <url>http://maven.aliyun.com/nexus/content/groups/public</url> </mirror> <mirror> <id>dev-mirror</id> <mirrorOf>dev1</mirrorOf> <name>第二套開發(fā)倉(cāng)庫(kù)</name> <url>http://192.168.1.2/repository/devM</url> </mirror> </mirrors> <profiles> <profile> <id>env-dev</id> <repositories> <repository> <id>dev5</id> <name>Repository for JDK 1.4 builds</name> <url>http://192.168.1.1/repository/dev5</url> </repository> </repositories> </profile> <profile> <id>env-test</id> <repositories> <repository> <id>test</id> <name>test</name> <url>http://192.168.1.1/repository/test</url> </repository> </repositories> </profile> </profiles> <activeProfiles> <activeProfile>env-dev</activeProfile> </activeProfiles> </settings>
工程的配置文件如下:
<?xml version="1.0" encoding="UTF-8"?> <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"> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.2.6.RELEASE</version> <relativePath/> <!-- lookup parent from repository --> </parent> <modelVersion>4.0.0</modelVersion> <groupId>org.example</groupId> <artifactId>test</artifactId> <version>${revision}</version> <packaging>pom</packaging> <properties> <maven.compiler.source>8</maven.compiler.source> <maven.compiler.target>8</maven.compiler.target> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <revision>1.0.0</revision> </properties> <repositories> <repository> <id>dev4</id> <name>dev4</name> <url>http://192.168.1.1/repository/dev4</url> </repository> </repositories> <profiles> <profile> <id>profile-1</id> <activation> <activeByDefault>true</activeByDefault> </activation> <repositories> <repository> <id>dev1</id> <name>dev1</name> <url>http://192.168.1.1/repository/dev1</url> </repository> <repository> <id>dev2</id> <name>dev2</name> <url>http://192.168.1.1/repository/dev2</url> </repository> </repositories> </profile> <profile> <id>profile-2</id> <activation> <activeByDefault>true</activeByDefault> </activation> <repositories> <repository> <id>dev3</id> <name>dev3</name> <url>http://192.168.1.1/repository/dev3</url> </repository> </repositories> </profile> </profiles> </project>
2.1、settings.xml和pom都配置激活了各自的profile
pom.xml文件默認(rèn)激活了profile-1和profile-2,settings中默認(rèn)激活了env-dev。按照在同一文件的profile的生效順序規(guī)則,pom文件中的倉(cāng)庫(kù)使用順序?yàn)?/p>
dev5->dev3->dev1->dev2->dev4->central(超級(jí)pom中定義的中央倉(cāng)庫(kù)),
而由于在setttings.xml中為dev1和central配置了鏡像倉(cāng)庫(kù),所以最終倉(cāng)庫(kù)的優(yōu)先查詢順序?yàn)椋?/p>
dev5->dev3->dev-mirror->dev2->dev4->nexus-aliyun
2.2、settings.xml沒有配置激活的profile,pom中配置了激活的profile
這種情況下,settings中沒有設(shè)置activeProfiles,我們只需要考慮pom文件中倉(cāng)庫(kù)的查詢順序,按照先前說的規(guī)則:
- • 如果同一個(gè)pom文件里面有多個(gè)激活的profile,則靠后面激活的profile的優(yōu)先級(jí)高
- • 針對(duì)pom文件,如果有激活的profile,且profile里面配置了repositories,則profile里面的repositories的倉(cāng)庫(kù)優(yōu)先級(jí)比標(biāo)簽下面的repositories的優(yōu)先級(jí)高
- • pom文件中無論是project標(biāo)簽下面直接定義的repositories,還是profile標(biāo)簽下面定義的repositories,repositories內(nèi)部的repository的查詢順序,都是按照倉(cāng)庫(kù)定義的順序查詢,也就是自上而下查詢。
則倉(cāng)庫(kù)使用順序?yàn)?/p>
dev3->dev1->dev2->dev4->central(超級(jí)pom中定義的中央倉(cāng)庫(kù)),
而由于在setttings.xml中為dev1和central配置了鏡像倉(cāng)庫(kù),所以最終倉(cāng)庫(kù)的優(yōu)先查詢順序?yàn)椋?/p>
dev3->dev-mirror->dev2->dev4->nexus-aliyun
3、倉(cāng)庫(kù)配置建議
maven官方不建議在settings中配置profile,因?yàn)閜rofile中配置的一些屬性或者倉(cāng)庫(kù)基本都是為項(xiàng)目服務(wù)的,我們的項(xiàng)目可以通過代碼倉(cāng)庫(kù)(比如gitlab)進(jìn)行共享,但是settings配置文件一般很難共享。如果我們的項(xiàng)目依賴了自己本地的settings文件中的一些配置信息,但是其他同事本地的settings文件又沒這些信息,那么其他同事就無法正常的運(yùn)行項(xiàng)目。而且profile中定義的信息一般都和項(xiàng)目運(yùn)行的環(huán)境有關(guān),比如有開發(fā)環(huán)境的配置,測(cè)試環(huán)境的配置,還有生產(chǎn)環(huán)境的配置。既然和項(xiàng)目有直接的緊密關(guān)系,就應(yīng)該將其配置到項(xiàng)目里面。
3.1 針對(duì)倉(cāng)庫(kù)配置的建議
- • 如果倉(cāng)庫(kù)和環(huán)境無關(guān),可以將倉(cāng)庫(kù)配置到pom文件的結(jié)點(diǎn)下面
- • 如果不同環(huán)境使用不同的倉(cāng)庫(kù),則可以通過在pom文件中定義profile,并在profile結(jié)點(diǎn)下面配置倉(cāng)庫(kù)
3.2、針對(duì)settings文件的配置
seetings文件建議用來配置下列幾項(xiàng)
- • 配置本地倉(cāng)庫(kù)路徑,即配置localRepository
- • 配置中央倉(cāng)庫(kù)的鏡像,即配置mirrors
- • 配置訪問倉(cāng)庫(kù)的認(rèn)證信息,即配置servers
到此這篇關(guān)于maven多個(gè)倉(cāng)庫(kù)查詢的優(yōu)先級(jí)順序的文章就介紹到這了,更多相關(guān)maven多個(gè)倉(cāng)庫(kù)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
詳解spring boot實(shí)現(xiàn)websocket
這篇文章主要介紹了詳解spring boot實(shí)現(xiàn)websocket,小編覺得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過來看看吧2017-06-06詳解java倒計(jì)時(shí)三種簡(jiǎn)單實(shí)現(xiàn)方式
這篇文章主要介紹了詳解java倒計(jì)時(shí)三種簡(jiǎn)單實(shí)現(xiàn)方式,小編覺得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過來看看吧2017-09-09Java基礎(chǔ)知識(shí)之ByteArrayOutputStream流的使用
這篇文章主要介紹了Java基礎(chǔ)知識(shí)之ByteArrayOutputStream流的使用,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2021-12-12使用spring mail發(fā)送html郵件的示例代碼
本篇文章主要介紹了使用spring mail發(fā)送html郵件的示例代碼,這里整理了詳細(xì)的示例代碼,具有一定的參考價(jià)值,有興趣的可以了解一下2017-09-09Java long 轉(zhuǎn)成 String的實(shí)現(xiàn)
這篇文章主要介紹了Java long 轉(zhuǎn)成 String的實(shí)現(xiàn),具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過來看看吧2020-09-09Spring AOP與代理類的執(zhí)行順序級(jí)別淺析
這篇文章主要介紹了Spring AOP與代理類的執(zhí)行順序級(jí)別,關(guān)于 Spring AOP和Aspectj的關(guān)系,兩個(gè)都實(shí)現(xiàn)了切面編程,Spring AOP更多地是為了Spring框架本身服務(wù)的,而Aspectj具有更強(qiáng)大、更完善的切面功能2023-03-03Retrofit+Rxjava實(shí)現(xiàn)文件上傳和下載功能
這篇文章主要介紹了Retrofit+Rxjava實(shí)現(xiàn)文件上傳和下載功能,文中提到了單文件上傳和多文件上傳及相關(guān)參數(shù)的請(qǐng)求,需要的朋友參考下吧2017-11-11springboot如何為web層添加統(tǒng)一請(qǐng)求前綴
這篇文章主要介紹了springboot如何為web層添加統(tǒng)一請(qǐng)求前綴,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2022-02-02