maven仓库配置及搜索顺序

今天在构建 IBPMS(Java Business Process Management,业务流程管理)demo 时,出现依赖的包无法下载,运行环境时公网内网环境,趁此梳理一下 maven 仓库的配置方式,并解一下自己的疑惑。

1. maven 仓库配置方式

1.1 maven setting.xml 文件配置

下面的 setting.xml 文件是最常用的配置,示例中仓库地址配置是公司的私服仓库,只配置了 profile 和镜像 mirror,下面简要介绍一下 profile 和 mirror 两个配置标签的作用。


     
         
            tbmirror-all 
            *  
            taobao mirror
            http://mvnrepo.abc.com/mvn/repository
        
     
    
    
    
         
            test 
             
                 
                    central 
                    http://mvnrepo.abc.com/mvn/repository 
                 
             
            
            
             
                 
                    central 
                    http://mvnrepo.abc.com/mvn/repository 
                 
             
         
     

    
        com.alibaba.org.apache.maven.plugins
        com.alibaba.maven.plugins
    
    
     
        test 
     

  • 镜像 mirror

如果仓库 X 可以提供仓库 Y 存储的所有内容,那么就可以认为 X 是 Y 的一个镜像。换句话说,任何一个可以从仓库 Y 获得的构件,都能够从它的镜像中获取。举个例子,http://maven.net.cn/content/groups/public/ 是中央仓库 http://repo1.maven.org/maven2/ 在中国的镜像,由于地理位置的因素,该镜像能够提供比中央仓库更快的服务。因此,可以配置 Maven 使用该镜像来替代中央仓库,代码如下:


  ...
  
    
      maven.net.cn
      one of the central mirrors in china
      http://maven.net.cn/content/groups/public/
      central   
* 


external:* 


repo1,repo2 


*,!repo1  

1.2 应用 pom.xml 仓库配置方式

这里的配置与 maven setting 类似,不再多余解释,直接引用笔者的 demo 配置,如下:

 
    
      jboss-public-repository-group
      JBoss Public Repository Group
      https://repository.jboss.org/nexus/content/groups/public/
      default
      
        never
      
      
        daily
      
    
  

2. maven 仓库搜索优先级

1)maven 仓库搜索路径

mavenSearch.png

maven 仓库搜索需要分两种场景:

Case 1:如果没有配置 mirrorOf* 的镜像仓库,搜索路径按照下面顺序获取构件(jar)

  • Step 1:查找本地仓库,如果没有则进入到下一步
  • Step 2:在全局应用的私服仓库中(setting.xml文件的profile)寻找,如果没有则进入下一步
  • Step 3:在应用自身的私服仓库中(应用pom.xml配置的repository)寻找,如果没有则进入下一步
  • Step 4:查找中央仓库,如果没有配置mirror,就默认中央仓库地址 https://repo.maven.apache.org/maven2

Case 2:如果配置有 mirrorOf * 的镜像仓库,则忽略上述规则,只从此仓库获取jar包(详细参考下面示例)

2)场景分析

以博主遇到的场景做分析,xmlpull.jar 包不在公司的远程仓库(http://mvnrepo.abc.com/mvn/repository)中,存在于 远程仓库https://repository.jboss.org/nexus/content/groups/public,结合以下两种场景来说明问题。

场景一:以下配置能从远程仓库中正常拉取 xmlpull.jar 包

原因:按上述搜索顺序,先从在全局应用的私服仓库中(setting.xml文件的profile)寻找,没有找到,则从项目 pom.xml 配置的 repository 找到并下载成功。

  • maven setting.xml 配置

     
         
            tbmirror-all 
            central  
            taobao mirror
            http://mvnrepo.abc.com/mvn/repository
        
     
    
    
    
         
            test 
             
                 
                    central 
                    http://mvnrepo.abc.com/mvn/repository 
                 
             
            
            
             
                 
                    central 
                    http://mvnrepo.abc.com/mvn/repository 
                 
             
         
     

    
        com.alibaba.org.apache.maven.plugins
        com.alibaba.maven.plugins
    
    
     
        test 
     

  • 应用 pom.xml 仓库配置

    
      jboss-public-repository-group
      JBoss Public Repository Group
      https://repository.jboss.org/nexus/content/groups/public/
      default
      
        never
      
      
        daily
      
    
  
场景二:以下配置不能从远程仓库中拉取 xmlpull.jar 包,报错误信息:one of its dependencies could not be resolved: Could not find artifact xmlpull:xmlpull:jar:1.2.0 in tbmirror-all (http://mvnrepo.abc.com/mvn/repository)

原因:maven setting.xml 配置了 mirror*,只从公司私服上下载 xmlpull.jar 包,未找到则报错

  • maven setting.xml 配置

     
         
            tbmirror-all 
            *
            taobao mirror
            http://mvnrepo.abc.com/mvn/repository
        
     
    
    
    
         
            test 
             
                 
                    central 
                    http://mvnrepo.abc.com/mvn/repository 
                 
             
            
            
             
                 
                    central 
                    http://mvnrepo.abc.com/mvn/repository 
                 
             
         
     

    
        com.alibaba.org.apache.maven.plugins
        com.alibaba.maven.plugins
    
    
     
        test 
     

  • 应用 pom.xml 仓库配置

    
      jboss-public-repository-group
      JBoss Public Repository Group
      https://repository.jboss.org/nexus/content/groups/public/
      default
      
        never
      
      
        daily
      
    
  

号v公众:方辰的博客

你可能感兴趣的:(maven仓库配置及搜索顺序)