关于maven包装器的一些使用心得

1. 起因

  在学习SpringBoot的过程中，使用到了maven包装器。maven包装器默认的会把需要的maven下载到${user.home}/.m2。由于在机房原因，每次C盘都会被格式化，而我的用户目录也是在C盘，这也就使得每次都要重新下载。所以，就需要更改下载位置，避免重复下载。

2. 相关代码分析

  使用maven管理SpringBoot项目时，需要使用到mvnw命令，如mvnw spring-boot:run命令。所以我们就先从mvnw.cmd文件分析。

2.1 分析mvnw.cmd文件

  此脚本主要是运行maven-wrapper.jar，上面的信息为其执行做了必要的准备信息。

2.2 分析maven-wrapper.jar

2.2.1 maven用户目录

  maven-wrapper源码
  首先分析MavenWrapperMain类，在main方法，注意到53行，它传入了一个Installer对象，这个对象主要是用来进行下载安装maven。Installer对象又传入两个对象，即DefaultDownloader和PathAssembler。其中PathAssembler对象用来包含路径集，它传入了MavenUserHome路径，用来作为存储下载maven的根目录。

  继续查看mavenUserHome()方法。

  上面对应的常量如下。
String DEFAULT_MAVEN_USER_HOME = System.getProperty( "user.home" ) + "/.m2";
String MAVEN_USER_HOME_PROPERTY_KEY = "maven.user.home";
String MAVEN_USER_HOME_ENV_KEY = "MAVEN_USER_HOME";
  首先，它会去尝试获取系统属性，若没有，则再尝试获取环境变量，若还是没有，则使用默认路径。
  我的系统属性和环境变量都没有设置，所以它就会用默认路径${user.home}/.m2。所以只需添加系统属性或环境变量，便可更改maven用户目录。我这里是添加了环境变量。在Windows下使用下面的命令可实现快速添加环境变量。

setx /m MAVEN_USER_HOME E:\javaee\maven

  以上，随着maven用户目录的修改，原问题也就得到了解决。

2.2.2 更进一步，其他属性

  接下来分析的是maven-wrapper.properties文件以及相关属性的处理过程，感兴趣的可以继续往下看。
  回到程序入口方法，还是这张图。

  我们查看52行的forProjectDirectory()方法体。

  它调用构造方法，并传入maven-wrapper.properties文件。
  在构造方法中，主要是修改WrapperConfiguration对象（配置信息）。这些属性及功能如下。

属性名	作用
distributionUrl	要下载的maven地址
zipStoreBase	下载的压缩包存储的根目录
zipStorePath	下载的压缩包存储在zipStoreBase下的子目录
distributionBase	解压后文件所在的根目录
distributionPath	解压后文件存储在distributionBase下的子目录

  关于上面的默认值，通过继续分析可以找到。在中WrapperConfiguration类中，定义了一些常量。

  其中distributionBase和zipBase最终值是MAVEN_USER_HOME，distributionPath和zipPath最终值是wrapper/dists。
  到此为止，我们的分析也就结束啦。

3.总结

  这篇文章解决了maven包装器默认路径问题，可以通过添加系统属性和环境变量来修改maven用户目录。此外分析了maven-wrapper.properties可以配置的一些属性，可以通过这些属性达到更细的配置。

如果你有更好的意见或建议，欢迎在评论区留言。