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

最新推荐文章于 2023-09-20 13:14:53 发布

hy_zzzzz

最新推荐文章于 2023-09-20 13:14:53 发布

阅读量340

点赞数

分类专栏： maven

maven 专栏收录该内容

3 篇文章 0 订阅

订阅专栏

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

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

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

nexus-osc
*
Nexusosc
http://maven.oschina.net/content/groups/public/

请注意这里的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 plaincopy

@Deprecated
publicArtifactRepositorygetMirrorRepository(ArtifactRepositoryrepository){
Mirrormirror=mirrorSelector.getMirror(repository,legacySupport.getSession().getSettings().getMirrors());
if(mirror!=null){
Stringid=mirror.getId();
if(id==null){
//TODO:thisshouldbeillegalinsettings.xml
id=repository.getId();
}
log.debug("Usingmirror:"+mirror.getUrl()+"(id:"+id+")");
repository=artifactRepositoryFactory.createArtifactRepository(id,mirror.getUrl(),
repository.getLayout(),repository.getSnapshots(),
repository.getReleases());
}
returnrepository;
}

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

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

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

privatestaticfinalStringWILDCARD="*";
privatestaticfinalStringEXTERNAL_WILDCARD="external:*";

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

publicMirrorgetMirror(ArtifactRepositoryrepository,List mirrors){
StringrepoId=repository.getId();
if(repoId!=null&;&;mirrors!=null){
for(Mirrormirror:mirrors){
if(repoId.equals(mirror.getMirrorOf())&;&;matchesLayout(repository,mirror)){
returnmirror;
}
}
for(Mirrormirror:mirrors){
if(matchPattern(repository,mirror.getMirrorOf())&;&;matchesLayout(repository,mirror)){
returnmirror;
}
}
}
returnnull;
}

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

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

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

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