让maven使用国内镜像和archetypeCatalog

作者: 6d96978eeefb | 来源:发表于2016-11-27 12:21 被阅读3982次

    作为一个程序员,每一天都能感受到土啬的深深恶意。

    今天尝试一个朋友写的快速创建Java程序的框架ActFramework,结果在写hello world时,运行mvn命令就被卡了个半死。

    就是下面这条用于搭出项目架子的命令:

    mvn archetype:generate \
        -DgroupId=com.mycom.helloworld \
        -DartifactId=helloworld \
        -DarchetypeArtifactId=maven-archetype-quickstart \
        -DinteractiveMode=false
    

    运行之后,卡在下面这一行,长达100年:

    [INFO] Scanning for projects...
    [INFO]
    [INFO] ------------------------------------------------------------------------
    [INFO] Building Maven Stub Project (No POM) 1
    [INFO] ------------------------------------------------------------------------
    [INFO]
    [INFO] >>> maven-archetype-plugin:2.3:generate (default-cli) > generate-sources @ standalone-pom >>>
    [INFO]
    [INFO] <<< maven-archetype-plugin:2.3:generate (default-cli) < generate-sources @ standalone-pom <<<
    [INFO]
    [INFO] --- maven-archetype-plugin:2.3:generate (default-cli) @ standalone-pom ---
    [INFO] Generating project in Batch mode
    

    它到底在等什么呢?给mvn加上-X参数,显示调试级别的日志:

    [DEBUG]   (f) session = org.apache.maven.execution.MavenSession@66f66866
    [DEBUG] -- end configuration --
    [INFO] Generating project in Batch mode
    [DEBUG] Searching for remote catalog: http://repo.maven.apache.org/maven2/archetype-catalog.xml
    

    原来是在访问http://repo.maven.apache.org/maven2/archetype-catalog.xml这个地址,遗憾的是,它可能是被土啬了。

    面对这种情况,我的第一反应是找个国内的源吧,让maven从国内下载依赖库。

    找到了一篇文章说阿里云可用,测试了一下果然可以(感谢阿里以及这位同学)。

    添加阿里云的mirror

    按照文章的提示,我要把阿里云的地址加到maven的配置文件中,那么应该加到哪里呢?

    通常来说,对于*nix系统,一般是在~/.m2/settings.xml中,但是最好先确认一下。

    输入命令mvn -X,不用管它后面是否成功,我们的目的是要从日志信息中,看看maven到底用的是哪个配置文件。

    仔细检查,果然在大片输出中看到了以下信息:

    [DEBUG] Reading global settings from /usr/local/Cellar/maven/3.3.9/libexec/conf/settings.xml
    [DEBUG] Reading user settings from /Users/twer/.m2/settings.xml
    

    原来它先从自己的安装目录里找到全局settings.xml,然后再找~/.m2/settings.xml

    那我们就把以下内容添加到后者中的<mirrors>标签中吧!

    <mirror>
          <id>alimaven</id>
          <name>aliyun maven</name>
          <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
          <mirrorOf>central</mirrorOf>        
    </mirror>
    

    这段话是什么意思呢?关键点在于<mirrorOf>central</mirrorOf>,它是说,把我提供的这个阿里云的源当作central源的代理吧,以后你需要访问那个名为central的源时,就把所有的请求转发到我阿里云上。

    那么central又是什么呢?原来maven自己内置了一个超级POM,里面预先定义了名为central对应的地址:

    <repositories>
      <repository>
        <id>central</id>
        <name>Central Repository</name>
        <url>http://repo.maven.apache.org/maven2</url>
        <layout>default</layout>
        <snapshots>
          <enabled>false</enabled>
        </snapshots>
      </repository>
    </repositories>
    

    可以看到,central这个id对应的是http://repo.maven.apache.org/maven2

    配置完以后,再次运行,看到它的确使用了阿里云:

    [DEBUG] Using mirror alimaven (http://maven.aliyun.com/nexus/content/groups/public/) for central (https://repo.maven.apache.org/maven2).
    

    还没来得及开心,再次卡住100年:

    [INFO] Generating project in Batch mode
    [DEBUG] Searching for remote catalog: http://repo.maven.apache.org/maven2/archetype-catalog.xml
    

    我已经配置好了镜像,maven为什么还要去访问 http://repo.maven.apache.org/maven2/archetype-catalog.xml 这个地址呢?

    指定archetypeCatalog

    经过一翻搜索,发现原来我的mvn命令是用来创建项目的,它还需要从http://repo.maven.apache.org/maven2/archetype-catalog.xml下载项目原型信息。

    对于如何在配置文件中一劳永逸的把它换成国内源,由于时间所限,我还没有找到办法,不过至少我们可以在前面的mvn命令中,添加上archetypeCatalog参数,即:

    mvn archetype:generate \
        -DgroupId=com.mycom.helloworld \
        -DartifactId=helloworld \
        -DarchetypeArtifactId=maven-archetype-quickstart \
        -DinteractiveMode=false \
        -DarchetypeCatalog=http://maven.aliyun.com/nexus/content/groups/public/
    

    这样就行了,分分钟就下载成功。

    如果有同学知道如何在maven的配置文件中配置,不用每次传参数,请一定要告诉我。

    感受

    两点感受

    1. 我的朋友GreenLuo,是曾经那个非常著名的Java中playframework1的一个积极贡献者,在play1不再开发之后,自己花了两年时间写了这个ActFramework

      由于他人不在国内,所以没有想到,在土啬内的同学连最基本的hello world都很难跑完吧!我也是今天试用的时候,才发现这个问题。

    2. Maven真是一个概念很多、文档极差的工具(我其实特别不想用它),如果要学习它,我觉得使用“概念关系图”的是一种极好的方式(实验室的同学们应该知道)。今天时间有限,改天我自己试一下。

    相关文章

      网友评论

      本文标题:让maven使用国内镜像和archetypeCatalog

      本文链接:https://www.haomeiwen.com/subject/apxnpttx.html