让maven使用国内镜像和archetypeCatalog

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

今天尝试一个朋友写的快速创建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真是一个概念很多、文档极差的工具（我其实特别不想用它），如果要学习它，我觉得使用“概念关系图”的是一种极好的方式（实验室的同学们应该知道）。今天时间有限，改天我自己试一下。