Maven中配置mirrorOf
当maven需要到的依赖jar包不在本地仓库时, 就需要到远程仓库下载 .
这个时候如果mavensetting.xml中配置了镜像 , 而且镜像配置的规则中匹配到目标仓库时 ,
maven认为目标仓库被镜像了, 不会再去被镜像仓库下载依赖jar包, 而是直接去镜像仓库下载.
简单而言, mirror可以拦截对远程仓库的请求 , 改变对目标仓库的下载地址。
在java的maven项目中编译时经常会配置maven的mirrorOf,
例如在settings文件中配置aliyun的仓库:
<mirror> <id>nexus-aliyun</id> <mirrorOf>*</mirrorOf> //代理仓库配置 <name>Nexus aliyun</name> <url>http://maven.aliyun.com/nexus/content/groups/public</url> </mirror>
mirrorOf可以理解“为某个仓库(repository)的做镜像”,填写的是repostoryId。”*“ 的意思就是匹配所有的仓库(repository)。相当于一个拦截器,它会拦截maven对remote repository的相关请求,把请求里的remote repository地址,重定向到mirror里配置的地址。
我们知道maven仓库有jar仓库和plugin仓库,例如pom中配置仓库,如下:<repositories> <repository> <id>repo.jenkins-ci.org</id> //repostoryId <url>https://repo.jenkins-ci.org/public/</url> </repository> </repositories>
也可以配置在settings.xml中,settings.xml中的profile元素是pom.xml中profile元素的裁剪版本。它包含了id、activation、repositories、pluginRepositories和 properties元素。例如<profiles>节点中配置如下:
<id>my-repo-id</id> //repostoryId <name>repo name</name> <url>http://maven.aliyun.com/nexus/content/groups/public</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> <layout>default</layout> </repository>
mirrorOf=“*”时镜像所有的repositoryId,包括repositories和pluginRepositories。如果你需要某个jar就会从镜像mirrorOd配置的地址去下载这个jar。其他配置的repostory都没用。
当然你也可以配置mirrorOf镜像你自己的repository仓库,例如你想镜像my-repo-id,你把mirrorOf配置成my-repo-id,那么你配置的my-repo-id这个仓库的url就没用了,被镜像代表了
在maven中配置一个mirror时,有多种形式,例如mirrorOf=“*” //刚才经过,mirror一切,你配置的repository不起作用了
mirrorOf=my-repo-id //镜像my-repo-id,你配置的my-repo-id仓库不起作用了
mirrorOf=*,!my-repo-id //!表示非运算,排除你配置的my-repo-id仓库,其他仓库都被镜像了。就是请求下载my-repo-id的仓库的jar不使用mirror的url下载,其他都是用mirror配置的url下载
mirrorOf=external:* //如果本地库存在就用本地库的,如果本地没有所有下载就用mirror配置的url下载
我们知道apache-maven的settings.xml不做任何配置时是有默认的仓库的,这个仓库就是central仓库,默认值是https://repo.maven.apache.org/maven2/,我们可以配置mirrorOf=central只镜像默认的central仓库。
如果你只配置了mirrorOf=”my-repo-id“没有配置central或*,那么请求maven会判断,首先在默认的central仓库https://repo.maven.apache.org/maven2/找依赖,如果找不到就去my-repo-id对应的仓库找,遍历所有仓库后找不到就报错。
例子
个人的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>
https://www.jianshu.com/p/c4f02c5bdfc7
https://www.jianshu.com/p/274c363ffd7c