Maven配置 settings.xml

摘要 记录settings.xml的配置，理解mirror、repository、profile的关系

 

本地仓库是远程仓库的一个缓冲和子集，当你构建Maven项目的时候，首先会从本地仓库查找资源，如果没有，那么Maven会从远程仓库下载到你本地仓库。这样在你下次使用的时候就不需要从远程下载了。如果你所需要的jar包版本在本地仓库没有，而且也不存在于远程仓库，Maven在构建的时候会报错，这种情况可能发生在有些jar包的新版本没有在Maven仓库中及时更新。

Maven缺省的本地仓库地址为${user.home}/.m2/repository 。也就是说，一个用户会对应的拥有一个本地仓库。当然你可以通过修改${user.home}/.m2/settings.xml 配置这个地址：

Xml代码

1. <settings>   

2.   …   

3.   <localRepository> D:/java/repository</localRepository>   

4.   …   

5. </settings>   

如果你想让所有的用户使用统一的配置那么你可以修改Maven主目录下的setting.xml:

${M2_HOME}/conf/setting.xml

repository是指在局域网内部搭建的repository，它跟central repository, jboss repository等的区别仅仅在于其URL是一个内部网址 
mirror则相当于一个代理，它会拦截去指定的远程repository下载构件的请求，然后从自己这里找出构件回送给客户端。配置mirror的目的一般是出于网速考虑。 

不过，很多internal repository搭建工具往往也提供mirror服务，比如Nexus就可以让同一个URL,既用作internal repository，又使它成为所有repository的mirror。

高级的镜像配置： 
1.<mirrorOf>*</mirrorOf> 
匹配所有远程仓库。 这样所有pom中定义的仓库都不生效
2.<mirrorOf>external:*</mirrorOf> 
匹配所有远程仓库，使用localhost的除外，使用file://协议的除外。也就是说，匹配所有不在本机上的远程仓库。 
3.<mirrorOf>repo1,repo2</mirrorOf> 
匹配仓库repo1和repo2，使用逗号分隔多个远程仓库。 
4.<mirrorOf>*,!repo1</miiroOf> 
匹配所有远程仓库，repo1除外，使用感叹号将仓库从匹配中排除。 

 

 

mirrors可以配置多个mirror，每个mirror有id,name,url,mirrorOf属性，id是唯一标识一个mirror就不多说了，name貌似没多大用，相当于描述，url是官方的库地址，mirrorOf代表了一个镜像的替代位置，例如central就表示代替官方的中央库。

 

我本以为镜像库是一个分库的概念，就是说当a.jar在第一个mirror中不存在的时候，maven会去第二个mirror中查询下载。但事实却不是这样，当第一个mirror中不存在a.jar的时候，并不会去第二个mirror中查找，甚至于，maven根本不会去其他的mirror地址查询。

 

后来终于知道，maven的mirror是镜像，而不是“分库”，只有当前一个mirror无法连接的时候，才会去找后一个，类似于备份和容灾。

还有，mirror也不是按settings.xml中写的那样的顺序来查询的。

所谓的第一个并不一定是最上面的那个。

 

当有id为B,A,C的顺序的mirror在mirrors节点中，maven会根据字母排序来指定第一个，所以不管怎么排列，一定会找到A这个mirror来进行查找，当A无法连接，出现意外的情况下，才会去B查询。

view source

 

print?

001	<?xml version="1.0" encoding="UTF-8"?>

002	<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"

003	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

004	xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

005

006

<servers>

007

<server>

008	<id>repo-iss</id>

009	<username>deployment</username>

010	<password>deployment123</password>

011

</server>

012	</servers>

013

014

<mirrors>

015	<!-- osc镜像 -->

016

<mirror>

017	<!-- 镜像所有远程仓库，但不包括指定的仓库 -->

018	<id>mirror-osc</id>

019	<mirrorOf>external:*,!repo-osc-thirdparty,!repo-iss</mirrorOf>

020	<url>http://maven.oschina.net/content/groups/public/</url>

021

</mirror>

022

<!--

023

<mirror>

024	<id>mirror-iss</id>

025	<mirrorOf>external:*</mirrorOf>

026	<url>http://10.24.16.99:5555/nexus/content/groups/public/</url>

027

</mirror>

028

-->

029	</mirrors>

030

031	<profiles>

032

<profile>

033	<id>profile-default</id>

034	<repositories>

035	<repository>

036	<id>central</id>

037	<url>http://central</url>

038	<releases>

039	<enabled>true</enabled>

040	</releases>

041	<snapshots>

042	<enabled>false</enabled>

043	</snapshots>

044	</repository>

045	<repository>

046	<id>repo-osc-thirdparty</id>

047	<url>http://maven.oschina.net/content/repositories/thirdparty/</url>

048	<releases>

049	<enabled>true</enabled>

050	</releases>

051	<snapshots>

052	<enabled>false</enabled>

053	</snapshots>

054	</repository>

055	</repositories>

056	<pluginRepositories>

057	<pluginRepository>

058	<id>central</id>

059	<url>http://central</url>

060	<releases>

061	<enabled>true</enabled>

062	</releases>

063	<snapshots>

064	<enabled>false</enabled>

065	</snapshots>

066	</pluginRepository>

067	</pluginRepositories>

068	</profile>

069

<profile>

070	<id>profile-iss</id>

071	<repositories>

072	<repository>

073	<id>repo-iss</id>

074	<url>http://10.24.16.99:5555/nexus/content/groups/public/</url>

075	<releases>

076	<enabled>true</enabled>

077	</releases>

078	<snapshots>

079	<enabled>true</enabled>

080	</snapshots>

081	</repository>

082	</repositories>

083	<pluginRepositories>

084	<pluginRepository>

085	<id>repo-iss</id>

086	<url>http://10.24.16.99:5555/nexus/content/groups/public/</url>

087	<releases>

088	<enabled>true</enabled>

089	</releases>

090	<snapshots>

091	<enabled>true</enabled>

092	</snapshots>

093	</pluginRepository>

094	</pluginRepositories>

095	</profile>

096	</profiles>

097

098	<activeProfiles>

099	<activeProfile>profile-default</activeProfile>

100	<!--<activeProfile>profile-iss</activeProfile>-->

101	</activeProfiles>

102

103

<!--

104

<proxies>

105

<proxy>

106	<active>true</active>

107	<protocol>http</protocol>

108	<host>10.10.204.160</host>

109	<port>80</port>

110

</proxy>

111	</proxies>

112

-->

113	</settings>