文档章节

通过测试和代码告诉你Maven是如何使用mirror和repository的

程序员闪灵
 程序员闪灵
发布于 2017/08/16 11:03
字数 1264
阅读 11
收藏 0

我以前用maven的时候用的都是默认的配置,自己没有修改过。。虽然许多时候下载很慢,也没有深入了解过maven的配置。。

不过最近一段时间遇到了很多问题,把官方关于settings和pom的结构的文档看了一遍,收获不小。

我遇到问题的主要原因是因为我在不知道配置含义的条件下,按照《开源中国 Maven 库使用帮助》修改了配置,速度提升非常明显。但是该帮助有一个最大的问题。看下面的配置:

<mirror>  
    <id>nexus-osc</id>  
    <mirrorOf>*</mirrorOf>  
    <name>Nexus osc</name>  
    <url>http://maven.oschina.net/content/groups/public/</url>  
</mirror>  

请注意这里的mirrorOf,关于mirrorOf的作用请看:

 http://blog.csdn.net/isea533/article/details/21560089

这里配置为*(星号)后,会导致所有的仓库都会通过osc的这个源去访问jar,由于osc现在的maven仓库和中央仓库一样,但是不包含第三方的仓库,因而第三方仓库都会出错,都会从osc的主仓库去查找,肯定找不到,因而maven会构建失败或者各种问题。

虽然osc还不是maven的一个官方镜像,但是完全可以将mirrorOf设置为central,central是官网仓库的id。只有修改为central之后,才能完全兼容所有情况,其他配置的repository才能起到作用(测试过,大家可以尝试*和central两种)。

mirrorOf配置*(星号)的时候,一般都是针对自己私有库的时候(私有库和其他仓库配置)。而且如果存在多个mirror,一定要把*(星号)的放到最下面。

 

为了更深入的了解maven和mirror、repository的关系,粗略看了maven的源码,代码如下:

[java] view plain copy

  1. @Deprecated  
    public ArtifactRepository getMirrorRepository(ArtifactRepository repository) {  
        Mirror mirror = mirrorSelector.getMirror(repository, legacySupport.getSession().getSettings().getMirrors());  
        if (mirror != null) {  
            String id = mirror.getId();  
            if (id == null) {  
                // TODO: this should be illegal in settings.xml  
                id = repository.getId();  
            }  
            log.debug("Using mirror: " + mirror.getUrl() + " (id: " + id + ")");  
            repository = artifactRepositoryFactory.createArtifactRepository(id, mirror.getUrl(),  
                    repository.getLayout(), repository.getSnapshots(),  
                    repository.getReleases());  
        }  
        return repository;  
    }  

     

maven首先会去查找repository对于的镜像(查找逻辑看下一段代码),如果在settings里面找不到对应的mirror,就会返回传入的repository,也就是说,如果仓库没有对应的镜像(mirror),那么就会直接用repository的url去获取。

如果找到了mirror,就会执行artifactRepositoryFactory.createArtifactRepository(...)方法,这个方法用mirror去构造一个新的repository,会使用mirror配置的url去查找。

系统中定义了一个全匹配*和外部全匹配external:*

  1. private static final String WILDCARD = "*";  
    private static final String EXTERNAL_WILDCARD = "external:*";  

     

maven查找mirror的逻辑代码如下:

  1. public Mirror getMirror(ArtifactRepository repository, List<Mirror> mirrors) {  
        String repoId = repository.getId();  
        if (repoId != null && mirrors != null) {  
            for (Mirror mirror : mirrors) {  
                if (repoId.equals(mirror.getMirrorOf()) && matchesLayout(repository, mirror)) {  
                    return mirror;  
                }  
            }  
            for (Mirror mirror : mirrors) {  
                if (matchPattern(repository, mirror.getMirrorOf()) && matchesLayout(repository, mirror)) {  
                    return mirror;  
                }  
            }  
        }  
        return null;  
    }  

     

从代码可以看到,首先查找mirrorOf和repository的id一样并且Layout一致的镜像,由于layout很少配置,所以这里是第一条规则:

1.首先匹配mirrorOf和仓库id一样的镜像。

从第二个for循环可以看到这里使用规则来进行匹配,规则匹配代码:

  1. static boolean matchPattern(ArtifactRepository originalRepository, String pattern) {  
        boolean result = false;  
        String originalId = originalRepository.getId();  
        //首先匹配*号,如果mirrorOf是*号,就用当前的镜像  
        //或者如果当前的mirrorOf和repository的id一样也返回(这在前面的for循环处理过,所以这种情况基本不会出现)  
        if (WILDCARD.equals(pattern) || pattern.equals(originalId)) {  
            result = true;  
        } else {  
            //其次mirrorOf支持多个用逗号隔开,这里先拆分,逐个循环  
            String[] repos = pattern.split(",");  
            for (String repo : repos) {  
                //repo支持!(感叹号)来屏蔽一个repository的Id,这里先判断如果是排除的,就return false  
                if (repo.length() > 1 && repo.startsWith("!")) {  
                    if (repo.substring(1).equals(originalId)) {  
                        // explicitly exclude. Set result and stop processing.  
                        result = false;  
                        break;  
                    }  
                }  
                //逗号隔开中的一个值和repository的id一样就返回true  
                else if (repo.equals(originalId)) {  
                    result = true;  
                    break;  
                }  
                //检查外部匹配external:*  
                else if (EXTERNAL_WILDCARD.equals(repo) && isExternalRepo(originalRepository)) {  
                    result = true;  
                }  
                //最后检查*匹配  
                else if (WILDCARD.equals(repo)) {  
                    result = true;  
                }  
            }  
        }  
        return result;  
    }  

     

由于代码比较长,因而写成代码注释了,代码很容易理解,可以参考注释。

从这段代码可以得到如下规则:

2.如果mirrorOf是*(星号)或者和repo的id一样就使用该mirror

3.对于mirrorOf多个或一个的情况,从第一个开始判断

    3.1如果是一个排除选项,就不使用这个mirror

    3.2如果正好和repo的id一样就使用这个mirror

    3.3判断是否外部匹配(这里还有一个isExternalRepo方法,判断是否为本地库),如果不是本地仓库,就用该mirror

    3.4判断是否为*(星号),如果是,就用该镜像。

除了1,2,3(1~4)几条规则外,还需要注意最外层的循环,首先会从settings配置的第一个mirror开始循环,其次从mirrorOf逗号隔开的内容循环。

 

通过以上测试和了解代码,终于弄明白maven如何处理mirror和repository关系。也希望对此不明白的人有所帮助。

本文转载自:http://blog.csdn.net/isea533/article/details/22437511

程序员闪灵
粉丝 1
博文 8
码字总数 3849
作品 0
兰州
架构师
私信 提问
maven repository

maven repository 什么是Maven仓库 在不用Maven的时候,比如说以前我们用Ant构建项目,在项目目录下,往往会看到一个名为/lib的子目录,那里存放着各类第三方依赖 jar文件,如log4j.jar,jun...

squanchao
2016/08/15
56
0
Maven读书系列:Maven仓库

什么是Maven仓库 在不用Maven的时候,比如说以前我们用Ant构建项目,在项目目录下,往往会看到一个名为/lib的子目录,那里存放着各类第三方依赖jar文件,如log4j.jar,junit.jar等等。每建立...

-鹏
2015/09/16
44
0
Maven最佳实践:Maven仓库

什么是Maven仓库 在不用Maven的时候,比如说以前我们用Ant构建项目,在项目目录下,往往会看到一个名为/lib的子目录,那里存放着各类第三方依赖jar文件,如log4j.jar,junit.jar等等。每建立...

开源中国首席撸码官
2015/09/30
267
0
Maven配置 settings.xml

本地仓库是远程仓库的一个缓冲和子集,当你构建Maven项目的时候,首先会从本地仓库查找资源,如果没有,那么Maven会从远程仓库下载到你本地仓库。这样在你下次使用的时候就不需要从远程下载了...

咖啡杯
2014/02/19
45.7K
0
Maven应用

1.Maven的安装 1.1Windows 2000/xp下的安装 1. 解压缩maven-2.0.2-bin.zip到你希望安装Maven 2.0.2的所在目录。这里假设你选择了C:/ProgramFiles/Apache Software Foundation/maven-2.0.2. 2...

长平狐
2012/11/28
747
0

没有更多内容

加载失败,请刷新页面

加载更多

记一次项目启动报java.lang.StackOverflowError

项目是spring boot,之前没有问题,突然有一次debug方式启动的时候报这个错误。 因为其他同事没有问题,线上也没有问题,所以先排除了是代码问题。 开始以为电脑开的软件太多,然后给jvm的内存...

chro008
17分钟前
12
0
idea 2019.2免费激活码

亲测有效到2020.6 812LFWMRSH-eyJsaWNlbnNlSWQiOiI4MTJMRldNUlNIIiwibGljZW5zZWVOYW1lIjoi5q2j54mIIOaOiOadgyIsImFzc2lnbmVlTmFtZSI6IiIsImFzc2lnbmVlRW1haWwiOiIiLCJsaWNlbnNlUmVzdHJpY3Rpb......

Iverson58
25分钟前
7
0
移动APP开发中的重要注意事项

您的移动app在变化吗?如果没有,请确保遵循这些提示进行移动app开发。大多数行业的IT领导者都优先考虑劳动力和消费者的移动性。实现成功的移动app开发具有挑战性,涉及在app功能开发的基础上...

a429011717
32分钟前
6
0
Qt编写自定义控件69-代码行数统计

一、前言 代码行数统计主要用来统计项目中的所有文件的代码行数,其中包括空行、注释行、代码行,可以指定过滤拓展名,比如只想统计.cpp的文件,也可以指定文件或者指定目录进行统计。写完这...

飞扬青云
50分钟前
10
0
驰骋工作流引擎-ccflow关于 “ 是否自动计算未来的处理人”的功能变更

关键字:流程未来节点处理人 工作流快速开发平台 工作流流设计 业务流程管理 asp.net 开源工作流 业务背景:一个流程在启动起来后,是可以对一些节点计算出来处理人是谁,流程的走向。对于另...

孟娟
今天
5
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部