详解maven的setting配置文件中mirror和repository的区别

程序员文章站 2024-03-04 08:06:05

当maven需要到的依赖jar包不在本地仓库时, 就需要到远程仓库下载 . 这个时候如果mavensetting.xml中配置了镜像 , 而且镜像配置的规则中匹配到目...

当maven需要到的依赖jar包不在本地仓库时, 就需要到远程仓库下载 .

这个时候如果mavensetting.xml中配置了镜像 , 而且镜像配置的规则中匹配到目标仓库时 ,

maven认为目标仓库被镜像了, 不会再去被镜像仓库下载依赖jar包, 而是直接去镜像仓库下载.

简单而言, mirror可以拦截对远程仓库的请求 , 改变对目标仓库的下载地址

repository

repository就是个仓库.

maven里有两种仓库，本地仓库和远程仓库。

远程仓库相当于公共的仓库，大家都能看到。

本地仓库是你本地的缓存副本，只有你看的到，主要起缓存作用。

当你向仓库请求插件或依赖的时候，会先检查本地仓库里是否有。

如果有则直接返回，否则会向远程仓库请求，并被缓存到本地仓库。

远程仓库可以在工程的pom.xml文件里指定。

如果没指定,默认会到这个地方去请求插件和依赖包。

*<repository> *

*  <snapshots> *

*  <enabled>false</enabled> *

*  </snapshots> *

*  <id>central</id> *

*  <name>maven repository switchboard</name> *

*  <url>**[http://repo1.maven.org/maven2</url>*

* </repository> *

本地仓库默认在你本地的用户目录下的.m2/repository目录下。

mirror

mirror就是镜像，主要提供一个方便地切换远程仓库地址的途径。

比如，上班的时候在公司，用电信的网络，连的是电信的仓库。

回到家后，是网通的网络，我想连网通的仓库，就可以通过mirror配置，统一把我工程里的仓库地址都改成联通的，而不用到具体工程配置文件里一个一个地改地址。

mirror的配置在.m2/settings.xml里。如：

*<mirrors> *

* <mirror> *

* <id>uk</id> *

* <name>uk central</name> *

* <url>**[http://uk.maven.org/maven2</url> ](http://uk.maven.org/maven2%3c/url%3e%c2%a0%c2%a0)*

* <mirrorof>central</mirrorof> *

* </mirror> *

*</mirrors> *

这样的话，就会给上面id为central的远程仓库做了个镜像。

以后向central这个仓库发的请求都会发到http://uk.maven.org/maven2而不是http://repo1.maven.org/maven2了。

<mirrorof>central</mirrorof>里是要替代的仓库的id。

如果填*，就会替代所有仓库。

高级镜像配置

为了满足一些复杂的需求，maven还支持更高级的镜像配置：

1.<mirrorof>*</mirrorof>
匹配所有远程仓库。

2.<mirrorof>external:*</mirrorof>
匹配所有远程仓库，使用localhost的除外，使用file://协议的除外。也就是说，匹配所有不在本机上的远程仓库。

3.<mirrorof>repo1,repo2</mirrorof>
匹配仓库repo1和repo2，使用逗号分隔多个远程仓库。

4.<mirrorof>*,!repo1</miiroof>
匹配所有远程仓库，repo1除外，使用感叹号将仓库从匹配中排除。

需要注意的是，由于镜像仓库完全屏蔽了被镜像仓库，当镜像仓库不稳定或者停止服务的时候，maven仍将无法访问被镜像仓库，因而将无法下载构件。

例子

个人的maven配置了阿里的镜像 , 而项目中需要使用到一些第三方jar包, 为了方便引入 , 已上传到192.168.0.201的nexus私服下.
但由于个人maven阿里的镜像使用默认mirrorof规则=*, 所有的仓库都被镜像 , 不会再去192.168.0.201下下载第三方jar包
上传的第三方jar包目标路径 :
http://192.168.0.201:8081/nexus/content/groups/public/com/alipay/sdk-java/20170615110434/sdk-java-20170615110434.pom

被镜像后路径 :
http://maven.aliyun.com/nexus/content/groups/public/com/alipay/sdk-java/20170615110434/sdk-java-20170615110434.pom
所以需要修改镜像的mirrorof规则 , 避免默认从镜像中下载

maven的conf/setting.xml

 <mirrors>
  <!--国内阿里云提供的镜像，非常不错-->
 <mirror>
  <!--this sends everything else to /public -->
  <id>aliyun_nexus</id>
  <!--对所有仓库使用该镜像,除了一个名为maven_nexus_201的仓库除外-->
  <!--这个名为maven_nexus_201的仓库可以在javamaven项目中配置一个repository-->
  <mirrorof>*,!maven_nexus_201</mirrorof> 
  <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
 </mirror>
 </mirrors>

maven项目下的pom.xml配置一个远程仓库

<repositories>
  <!-- 192.168.0.201远程仓库 -->
  <repository>
   <id>maven_nexus_201</id>
   <name>maven_nexus_201</name>
   <layout>default</layout>
   <url>http://192.168.0.201:8081/nexus/content/groups/public/</url>
   <snapshots> 
    <enabled>true</enabled> 
    </snapshots>
  </repository>
</repositories>

在下上传第三方jar包依赖

登陆已经安装好的nexus私有仓库，如图：