五、Maven仓库更新策略

maven仓库的更新策略指的是更新maven-metadata-[repository].xml,即何时触发从远程仓库读取最西的'maven-metadata-[repository].xml'的策略。

一、Maven下载仓库配置

updatePolicy: 该标签用于指定更新尝试发生的频率。Maven会比较远程和本地pom的时间戳(时间戳在maven-metadata文件)。可选项有:1)always;2)daily(默认);3)interval:X(X为整数,单位为分钟);4)never。


  ...
  
    
      
        false
        always
        warn
      
      
        true
        never
        fail
      
      Nexus Snapshots
      snapshots-repo
      https://oss.sonatype.org/content/repositories/snapshots
      default
    
  
  
    ...
  
  ...

二、Maven更新逻辑

参考maven3.6.3源码:org.apache.maven.artifact.repository.metadata.DefaultRepositoryMetadataManager#resolve方法

  1. 如果-U强制更新,update=true
  2. 如果maven-metadata-local.xml存在,且该文件的lastModified不符合更新策略,update=false
  3. 如果maven-metadata-snapshot.xml不存在,update=true
  4. 如果maven-metadata-snapshot.xml存在,则检查resolver-status.properties中的时间戳是否符合更新策略
    1)如果符合,update=true
    2)否则,update=false
#NOTE: This is a Maven Resolver internal implementation file, its format can be changed without prior notice.
#Tue Aug 11 16:46:54 CST 2020
maven-metadata-snapshots.xml.lastUpdated=1597135614187

三、Maven更新策略源码

参考maven3.6.3源码:org.apache.maven.artifact.repository.ArtifactRepositoryPolicy#checkOutOfDate

public boolean checkOutOfDate(Date lastModified) {
        boolean checkForUpdates = false;

        if (UPDATE_POLICY_ALWAYS.equals(updatePolicy)) {
            checkForUpdates = true;
        } else if (UPDATE_POLICY_DAILY.equals(updatePolicy)) {
            // Get local midnight boundary
            Calendar cal = Calendar.getInstance();

            cal.set(Calendar.HOUR_OF_DAY, 0);
            cal.set(Calendar.MINUTE, 0);
            cal.set(Calendar.SECOND, 0);
            cal.set(Calendar.MILLISECOND, 0);

            if (cal.getTime().after(lastModified)) {
                checkForUpdates = true;
            }
        } else if (updatePolicy.startsWith(UPDATE_POLICY_INTERVAL)) {
            String s = updatePolicy.substring(UPDATE_POLICY_INTERVAL.length() + 1);
            int minutes = Integer.valueOf(s);
            Calendar cal = Calendar.getInstance();
            cal.add(Calendar.MINUTE, -minutes);
            if (cal.getTime().after(lastModified)) {
                checkForUpdates = true;
            }
        }
        // else assume "never"
        return checkForUpdates;
    }

四、Maven build时使用哪个Jar

  1. 读取groupId/artifactId/version/maven-metadata-local.xmlversioning -> snapshotVersions -> snapshotVersion -> updated(只看jar包的,忽略pom)
  2. 读取groupId/artifactId/version/maven-metadata-snapshot.xmlversioning -> lastUpdated
  3. 选择最近的时间戳的依赖版本;若是远程版本,且版本不存在时会触发远程jar下载逻辑。

NOTE:
如果远程比本地的新,则远程下载的包会复制一份覆盖本地的artifactId-version.jar和pom文件;

左maven-metadata-local.xml, 右maven-matadata-snapshot.xml

参考

  1. http://maven.apache.org/pom.html#Repositories

你可能感兴趣的:(五、Maven仓库更新策略)