一文詳解Maven的setting文件
前言
maven 是目前java 常見(jiàn)的一款包管理工具,通過(guò) maven 我們可以很方便的對(duì)項(xiàng)目進(jìn)行編譯、打包、部署等操作。
setting.xml 文件是 Maven 的主要配置文件,它包含了 Maven 運(yùn)行時(shí)需要的配置信息。這個(gè)文件通常位于~/.m2/目錄下。我們也可以手動(dòng)指定,如下(idea舉例):

通過(guò) setting 配置文件,我們可以改變參數(shù)項(xiàng),來(lái)控制以上操作的具體行為,接下來(lái)我們將具體講講 settting 配置文件
結(jié)構(gòu)
setting.xml 整體結(jié)構(gòu)如下:
<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/>
<interactiveMode/>
<usePluginRegistry/>
<offline/>
<pluginGroups/>
<servers/>
<mirrors/>
<proxies/>
<profiles/>
<activeProfiles/>
</settings>
下面是各個(gè)元素的含義:
- localRepository:本地倉(cāng)庫(kù)的位置,如果沒(méi)有設(shè)置,Maven會(huì)使用默認(rèn)的~/.m2/repository。
- interactiveMode:交互模式的開(kāi)關(guān),如果設(shè)置為true,Maven會(huì)在需要輸入時(shí)提示用戶(hù)。
- usePluginRegistry:是否使用插件注冊(cè)表,如果設(shè)置為true,Maven會(huì)使用~/.m2/plugin-registry.xml文件。
- offline:離線模式的開(kāi)關(guān),如果設(shè)置為true,Maven不會(huì)嘗試連接網(wǎng)絡(luò)。
- pluginGroups:插件組列表,Maven會(huì)在這些組中搜索插件。
- servers:定義了一些服務(wù)器的配置,包括服務(wù)器的 ID、用戶(hù)名和密碼。這些服務(wù)器通常用于發(fā)布(deploy)項(xiàng)目。
- mirrors:鏡像配置,可以設(shè)置Maven從哪個(gè)鏡像站點(diǎn)下載依賴(lài)。
- proxies:代理配置,可以設(shè)置Maven通過(guò)哪個(gè)代理服務(wù)器連接網(wǎng)絡(luò)。
- profiles:配置文件,可以包含一組特定的設(shè)置,如特定的代理服務(wù)器、鏡像站點(diǎn)等。
- activeProfiles:激活的配置文件列表,Maven會(huì)使用這些配置文件中的設(shè)置。
值得注意的是,settings.xml文件中的設(shè)置可以被pom.xml文件中的設(shè)置覆蓋。
重點(diǎn)結(jié)構(gòu)說(shuō)明
localRepository
用于指定本地倉(cāng)庫(kù)位置,即 jar 包下載存儲(chǔ)的位置(使用時(shí)優(yōu)先從本地倉(cāng)庫(kù)加載,沒(méi)有時(shí)再去遠(yuǎn)程倉(cāng)庫(kù)加載)
<localRepository>D:\xxx\mvn\repository</localRepository>
server
一般用于定義遠(yuǎn)程私服的認(rèn)證信息:
<server>
<id>releases</id>
<username>zhangsan</username>
<password>123456</password>
</server>
在這個(gè)示例中,我們定義了一個(gè)服務(wù)器,其ID為releases,用戶(hù)名為zhangsan,密碼為123456。
然后,就可以在pom.xml文件中引用這個(gè)服務(wù)器。例如,如果你想從這個(gè)服務(wù)器下載依賴(lài),可以這樣配置:
<repositories>
<repository>
<id>releases</id>
<url>http://example.com/repo</url>
</repository>
</repositories>
或者,如果你想把項(xiàng)目部署到這個(gè)服務(wù)器,你可以這樣配置:
<distributionManagement>
<repository>
<id>releases</id>
<url>scp://example.com/path/to/repo</url>
</repository>
</distributionManagement>
在這兩個(gè)例子中,元素的值與settings.xml文件中的服務(wù)器ID相匹配,所以Maven會(huì)使用對(duì)應(yīng)的用戶(hù)名和密碼進(jìn)行身份驗(yàn)證。
注意:出于安全考慮,不建議在settings.xml文件中明文存儲(chǔ)密碼。你可以使用Maven的密碼加密功能來(lái)加密密碼。
如果定義了多個(gè) repository,maven 會(huì)如何選擇?
Maven會(huì)按照它們?cè)趐om.xml文件中的順序來(lái)使用這些倉(cāng)庫(kù)。
當(dāng)Maven需要下載一個(gè)依賴(lài)或插件時(shí),它會(huì)首先從第一個(gè)倉(cāng)庫(kù)嘗試下載。如果第一個(gè)倉(cāng)庫(kù)中沒(méi)有這個(gè)依賴(lài)或插件,或者下載失敗,那么Maven會(huì)嘗試從第二個(gè)倉(cāng)庫(kù)下載,以此類(lèi)推,直到下載成功或者所有的倉(cāng)庫(kù)都嘗試過(guò)。
mirrors
定義了一些鏡像的配置,包括鏡像的 ID、名稱(chēng)和 URL,通常用于下載依賴(lài):
<mirrors>
<mirror>
<id>alimaven</id>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<mirrorOf>central</mirrorOf>
</mirror>
</mirrors>
在這個(gè)示例中,我們定義了一個(gè)鏡像站點(diǎn),其ID為alimaven,URL為maven.aliyun.com/nexus/conte…
當(dāng)Maven需要從central倉(cāng)庫(kù)下載依賴(lài)時(shí),它會(huì)檢查settings.xml文件中的鏡像配置,如果找到了匹配的鏡像,它會(huì)從鏡像站點(diǎn)下載依賴(lài),而不是從原始倉(cāng)庫(kù)下載。
元素的值可以是一個(gè)倉(cāng)庫(kù)ID,也可以是一個(gè)倉(cāng)庫(kù)ID的列表,用逗號(hào)分隔。如果值為*,表示這個(gè)鏡像是所有倉(cāng)庫(kù)的鏡像。
值得注意的是:如果你定義了多個(gè)匹配的鏡像,Maven會(huì)使用第一個(gè)匹配的鏡像。
通常用于配置公開(kāi)的、不需要身份驗(yàn)證的鏡像站點(diǎn)。這些鏡像站點(diǎn)是公開(kāi)倉(cāng)庫(kù)的復(fù)制品,用于加快下載速度和提高可用性,然而,有些鏡像站點(diǎn)可能需要身份驗(yàn)證,如:
鏡像站點(diǎn)是私有的,只對(duì)特定的用戶(hù)或組織開(kāi)放。
鏡像站點(diǎn)提供了付費(fèi)的高級(jí)服務(wù),需要用戶(hù)登錄才能使用。
這里也借助 server 提供認(rèn)證信息:
<servers>
<server>
<id>alimaven</id>
<username>myuser</username>
<password>mypassword</password>
</server>
</servers>
Maven會(huì)根據(jù)mirror元素的id查找對(duì)應(yīng)的server元素,并使用其中的認(rèn)證信息。
profiles
profiles元素用于定義一組特定的項(xiàng)目設(shè)置,這些設(shè)置只有在特定的條件滿(mǎn)足時(shí)才會(huì)生效。
每個(gè)profile元素定義了一組設(shè)置,這些設(shè)置可以包括目標(biāo)環(huán)境的特定配置、依賴(lài)管理、插件配置等
<profiles>
<profile>
<id>development</id>
<repositories>
<repository>
<id>dev-repo</id>
<url>http://dev.example.com/maven2</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>dev-plugin-repo</id>
<url>http://dev.example.com/maven2</url>
</pluginRepository>
</pluginRepositories>
</profile>
</profiles>
在這個(gè)示例中,我們?cè)赿evelopment配置文件中定義了一個(gè)repositories元素和一個(gè)pluginRepositories元素。
repositories元素用于定義項(xiàng)目的依賴(lài)倉(cāng)庫(kù)。這里,我們定義了一個(gè)倉(cāng)庫(kù)dev-repo,其URL為dev.example.com/maven2 當(dāng)Maven處理項(xiàng)目的依賴(lài)時(shí),它會(huì)從這個(gè)倉(cāng)庫(kù)下載依賴(lài)。pluginRepositories元素用于定義項(xiàng)目的插件倉(cāng)庫(kù)。這里,我們定義了一個(gè)插件倉(cāng)庫(kù)dev-plugin-repo,其URL為dev.example.com/maven2 當(dāng)Maven處理項(xiàng)目的插件時(shí),它會(huì)從這個(gè)倉(cāng)庫(kù)下載插件。- 其中,
releases和snapshots用于控制Maven是否從這個(gè)倉(cāng)庫(kù)下載release版本和snapshot版
activeProfiles
結(jié)合 pofiles 元素,activeProfiles主要用于指定默認(rèn)激活的Profile:
<activeProfiles>
<activeProfile>development</activeProfile>
</activeProfiles>
到此這篇關(guān)于一文帶你深入了解Maven setting文件的文章就介紹到這了,更多相關(guān)Maven setting文件內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
java中用float時(shí),數(shù)字后面加f,這樣是為什么你知道嗎
這篇文章主要介紹了java用float時(shí),數(shù)字后面加f,這樣是為什么你知道嗎?具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2021-09-09
Sharding-Proxy分庫(kù)分表和數(shù)據(jù)加密使用場(chǎng)景分析
這篇文章主要介紹了Sharding-Proxy分庫(kù)分表和數(shù)據(jù)加密使用經(jīng)驗(yàn)分享,通過(guò)場(chǎng)景模擬分析結(jié)合示例代碼給大家介紹的非常詳細(xì),需要的朋友可以參考下2022-04-04
IDEA 2020.2 部署JSF項(xiàng)目的詳細(xì)過(guò)程
本文通過(guò)圖文并茂的形式教大家如何在IDEA中創(chuàng)建一個(gè)JSF項(xiàng)目及遇到問(wèn)題的解決方法,感興趣的朋友跟隨小編一起看看吧2021-09-09
Java 阻塞隊(duì)列的7種類(lèi)型小結(jié)
Java中的阻塞隊(duì)列是線程安全的隊(duì)列結(jié)構(gòu),包括ArrayBlockingQueue、LinkedBlockingQueue、PriorityBlockingQueue、DelayQueue、SynchronousQueue、LinkedTransferQueue和LinkedBl,下面就來(lái)具體介紹一下,感興趣的可以了解一下2025-07-07

