spring boot之maven-wrapper
Spring Boot有很多功能特性值得借鉴和学习,很多玩Spring Boot的人知道不需要安装Tomcat很方便,其实并没有发现Maven也是不需要提前安装。它这样做的好处在于解决了开发环境maven版本不一致导致的各种问题,spring boot中集成了maven-wrapper的确比较务实。
它是什么
相信大家都用到spring的脚手架:https://start.spring.io/ 来生成Spring Boot项目,而项目的根目录中会多几个文件:
cmd > C:\Users\alex\Desktop\demo> tree /f
│ mvnw //linux-shell
│ mvnw.cmd //window-cmd
│ pom.xml
├─.mvn
│ └─wrapper
│ maven-wrapper.jar
│ maven-wrapper.properties
│ MavenWrapperDownloader.java
├─src
maven-wrapper解决了2个问题:
1.可以为某个Java工程指定某个特定Maven版本,避免因为版本差异引起的诡异错误,这样就统一该项目的开发环境;
2.不再需要提前安装Maven,简化了开发环境的配置;
玩法及原理
1.当前项目(spring boot)
在项目目录下执行mvnw clean,其实就是将之前你熟悉的mvn替换为mvnw命令即可,一点也不复杂。
mvnw第一次运行会检测$USER_HOME/.m2/wrapper/dists 目录下是否有maven-wrapper.properties中指定的Maven版本,如果没有就自动下载。
此时你会问下载后的maven会在哪里?
一般会在${user.home}\.m2\wrapper\dists目录,我的机器是在:C:\Users\alex\.m2\wrapper\dists\apache-maven-3.6.2-bin\795eh28tki48bv3l67maojf0ra
如何调整版本呢?
具体可参与maven-wrapper.properties中配置:
distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.6.2/apache-maven-3.6.2-bin.zip
wrapperUrl=https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.5/maven-wrapper-0.5.5.jar
原理:mvnw.cmd逻辑也不复杂,先将maven-wrapper.jar添加到classpath,再运行MavenWrapperDownloader#main。
public class MavenWrapperDownloader {private static final String WRAPPER_VERSION = "0.5.5";/*** Default URL to download the maven-wrapper.jar from, if no 'downloadUrl' is provided.*/private static final String DEFAULT_DOWNLOAD_URL = "https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/"+ WRAPPER_VERSION + "/maven-wrapper-" + WRAPPER_VERSION + ".jar";/*** Path to the maven-wrapper.properties file, which might contain a downloadUrl property to* use instead of the default one.*/private static final String MAVEN_WRAPPER_PROPERTIES_PATH =".mvn/wrapper/maven-wrapper.properties";/*** Path where the maven-wrapper.jar will be saved to.*/private static final String MAVEN_WRAPPER_JAR_PATH =".mvn/wrapper/maven-wrapper.jar";/*** Name of the property which should be used to override the default download url for the wrapper.*/private static final String PROPERTY_NAME_WRAPPER_URL = "wrapperUrl";public static void main(String args[]) {System.out.println("- Downloader started");File baseDirectory = new File(args[0]);System.out.println("- Using base directory: " + baseDirectory.getAbsolutePath());// If the maven-wrapper.properties exists, read it and check if it contains a custom// wrapperUrl parameter.File mavenWrapperPropertyFile = new File(baseDirectory, MAVEN_WRAPPER_PROPERTIES_PATH);String url = DEFAULT_DOWNLOAD_URL;if(mavenWrapperPropertyFile.exists()) {FileInputStream mavenWrapperPropertyFileInputStream = null;try {mavenWrapperPropertyFileInputStream = new FileInputStream(mavenWrapperPropertyFile);Properties mavenWrapperProperties = new Properties();mavenWrapperProperties.load(mavenWrapperPropertyFileInputStream);url = mavenWrapperProperties.getProperty(PROPERTY_NAME_WRAPPER_URL, url);} catch (IOException e) {System.out.println("- ERROR loading '" + MAVEN_WRAPPER_PROPERTIES_PATH + "'");} finally {try {if(mavenWrapperPropertyFileInputStream != null) {mavenWrapperPropertyFileInputStream.close();}} catch (IOException e) {// Ignore ...}}}System.out.println("- Downloading from: " + url);File outputFile = new File(baseDirectory.getAbsolutePath(), MAVEN_WRAPPER_JAR_PATH);if(!outputFile.getParentFile().exists()) {if(!outputFile.getParentFile().mkdirs()) {System.out.println("- ERROR creating output directory '" + outputFile.getParentFile().getAbsolutePath() + "'");}}System.out.println("- Downloading to: " + outputFile.getAbsolutePath());try {downloadFileFromURL(url, outputFile);System.out.println("Done");System.exit(0);} catch (Throwable e) {System.out.println("- Error downloading");e.printStackTrace();System.exit(1);}}private static void downloadFileFromURL(String urlString, File destination) throws Exception {if (System.getenv("MVNW_USERNAME") != null && System.getenv("MVNW_PASSWORD") != null) {String username = System.getenv("MVNW_USERNAME");char[] password = System.getenv("MVNW_PASSWORD").toCharArray();Authenticator.setDefault(new Authenticator() {@Overrideprotected PasswordAuthentication getPasswordAuthentication() {return new PasswordAuthentication(username, password);}});}URL website = new URL(urlString);ReadableByteChannel rbc;rbc = Channels.newChannel(website.openStream());FileOutputStream fos = new FileOutputStream(destination);fos.getChannel().transferFrom(rbc, 0, Long.MAX_VALUE);fos.close();rbc.close();}}
2.全局命令
还可以mvn -N io.takari:maven:wrapper -Dmaven=3.3.3表示我们期望使用的Maven的版本为3.3.3,将mvnw提升为全局命令,个人感觉意义不大,它最大的贡献在于保留及坚持个性化。
3.idea插件maven-wrapper-support
它需要结合当前项目(找maven-wrapper.properties配置)来使用。
maven-wrapper-support的逻辑也不复杂:会监测项目下的.mvn/wrapper/maven-wrapper.properties中的distributionUrl属性值,且自动下载maven版本到用户目录.m2/wrapper目录中,并且改变setting->build->build Tools ->maven-> maven home directory的值,但执行的命令是原生mvn的命令,而不是项目中下的mvnw命令。
原理:具体验证可查看plugin安装目录一般为:idea.config.path=${user.home}/.IntelliJIdea/config,比如我的:C:\Users\alex\.IntelliJIdea2018.3\config\plugins\maven-wrapper-support\lib中的maven-wrapper-support-0.5.1.jar代码MavenWrapperProjectComponent.class。
public class MavenWrapperProjectComponent extends AbstractProjectComponent {private VirtualFile wrapperSettings;private Logger log = Logger.getInstance(this.getClass());public MavenWrapperProjectComponent(Project project) {super(project);}private void applyWrapper() {if (this.wrapperSettings != null) {StringBuilder output = new StringBuilder();WrapperExecutor wrapperExecutor = WrapperExecutor.forWrapperPropertiesFile(new File(this.wrapperSettings.getPath()), output);File mavenUserHome = new File(System.getProperty("user.home") + "/.m2");Installer installer = new Installer(new DefaultDownloader("mvnw", "0.4.0"), new PathAssembler(mavenUserHome));try {File mavenHome = installer.createDist(wrapperExecutor.getConfiguration());this.changeMavenHomeTo(mavenHome.getAbsolutePath(), "maven wrapper defined in " + this.wrapperSettings.getPath());} catch (Exception var6) {this.log.error(var6);}}}private void changeMavenHomeTo(String mavenPath, String message) {MavenGeneralSettings generalSettings = MavenProjectsManager.getInstance(this.myProject).getGeneralSettings();if (generalSettings != null) {String oldMavenHome = generalSettings.getMavenHome();if (!mavenPath.equals(oldMavenHome)) {generalSettings.setMavenHome(mavenPath);this.log.info("Maven changed to " + message);Bus.notify(new Notification("maven-wrapper", "Maven changed", "Maven changed to " + message, NotificationType.INFORMATION));}}}public void projectOpened() {VirtualFileManager.getInstance().addVirtualFileListener(new com.blackbuild.intellij.wavenwrappersupport.MavenWrapperProjectComponent.ChangeListener(this));this.wrapperSettings = this.myProject.getBaseDir().findFileByRelativePath(".mvn/wrapper/maven-wrapper.properties");this.applyWrapper();}@NotNullpublic String getComponentName() {String var10000 = this.getClass().getName();if (var10000 == null) {$$$reportNull$$$0(0);}return var10000;}
}
注意事项
1.distributionUrl下载会比较慢
建议替换为:http://www-us.apache.org/dist/maven/maven-3/3.5.4/binaries/apache-maven-3.5.4-bin.zip
2.mvnw.bat中执行老版本的maven可能会报错:"Error: M2_HOME is set to an invalid directory"
Maven早期版本不叫mvn.cmd,而是叫mvn.bat,找到代码替换掉即可
spring boot之maven-wrapper相关推荐
- Spring Boot 把 Maven 干掉了,正式拥抱 Gradle!
在国外某社交网站上有一个关于迁移 Spring Boot 迁移 Maven 至 Gradle 的帖子: 该贴子上也有很多人质疑:Maven 用的好好的,为什么要迁移至 Gradle? 虽然该贴子只是说 ...
- Spring Boot项目(Maven\Gradle)三种启动方式及后台运行详解
Spring Boot项目三种启动方式及后台运行详解 1 Spring Boot项目三种启动方法 运行Application.java类中的Main方法 项目管理工具启动 Maven项目:mvn sp ...
- Spring boot的Maven配置依赖
Spring boot 的 Maven 配置依赖 springboot spring pom maven models 我们通过引用spring-boot-starter-parent,添加sprin ...
- spring boot 本地maven手动添加pom.xml依赖
spring boot 本地maven手动添加pom.xml依赖 按照如下pom.xml配置,本地jar包可以正常使用,适用于maven仓库中没有的的jar包下载下来,手动添加依赖. <!-- ...
- JavaEE + Oracle + Spring Boot + Mybatis + Maven 开发简易版银行管理系统(附源码)
文章目录 JavaEE + Oracle + Spring Boot + Mybatis + Maven 开发简易版银行管理系统 一.系统介绍 二.开发步骤 三.系统展示 四.开发总结 五.数据库相关 ...
- Spring boot的Maven插件(一):repackage目标
简介 Spring Boot Maven Plugin插件提供spring boot在maven中的支持.允许你打包可运行的jar包或war包. 插件提供了几个maven目标和Spring Boot ...
- spring boot 通过Maven + tomcat 自动化部署
使用maven创建的springboot项目,默认是jar包,springboot还有自己带的tomcat. 现在为了简单实现本地自动发布项目到服务器,需要通过发布war包的形式,通过maven将项目 ...
- spring boot 使用maven和fat jar/war运行应用程序的对比
文章目录 简介 Spring Boot Maven Plugin 使用Maven命令来运行应用程序 作为fat jar/war包运行应用程序 详解War文件 详解jar文件 如何选择 使用maven和 ...
- Spring Boot的Maven插件Spring Boot Maven plugin详解
pring Boot的Maven插件(Spring Boot Maven plugin)能够以Maven的方式为应用提供Spring Boot的支持,即为Spring Boot应用提供了执行Maven ...
- Spring Boot 使用 Maven assembly 插件打包
文章目录 1 摘要 2 Maven 核心依赖与配置 2.1 pom.xml 配置 2.2 assembly 配置信息 3 启动与停止脚本 3.1 启动脚本 3.2 停止脚本 4 推荐参考资料 5 Gi ...
最新文章
- 【OpenCV】内核的形状函数使用记录
- Python之pypmml:pypmml的简介、安装、使用方法之详细攻略
- JAVA 编程开发入门-张晨光-专题视频课程
- unzipping/Users/xq/.gradle/wrapper /dists/gradle-3.3-all/55gk2rcmfc6p2dg9u9ohc3hw9/gradle-3.3-all.zi
- 使用蓝图构建Flask项目目录
- 6-MyBatis基础
- gdb调试动态链接so
- 一个很简单的例子,从汇编层次理解函数调用
- Spark:一个独立应用
- 商务与经济统计++原书第12版+[(美)安德森著][机械工业出版社][2015.07][515页][13854037]第一章读书笔记
- 后缀–ize_动词后加ize的后缀有什么作用
- unity 遮挡剔除的实现
- Unraid启动后需要设置和注意的事项
- 公司注册地址可以随便写吗,如何注册企业工商营业执照
- 几种for循环用法详解。
- Matlab状态模式(State)
- k8s event 事件输入elk 并设置钉钉报警
- CentOS 8 EOL如何切换源
- 使用rtklib进行实时PPP定位
- (附源码)计算机毕业设计SSM基于框架的家用电器销售管理
热门文章
- 软件测试基础-黑盒测试、白盒测试、测试用例设计
- 局域网内海量文件快速复制方法
- strtol()详解
- 某APT组织利用AVAST杀软的白利用针对越南司法部投放恶意文档
- 前端HTMl摩天轮展示
- Java报表制作(iReport+jaserReport+jFreeChart)
- MUV LUV EXTRA -( kmp最小循环节 )
- 解决git push时报“remote: You are not allowed to upload code“的报错
- Appium常用配置
- Go协程泄漏和修复方法