Maven 版本管理与 flatten-maven-plugin 插件的使用解析
1. flatten-maven-plugin 介绍
1.1 环境
- IntelliJ IDEA 2021.3
- JDK 1.8.0_301
- Apache Maven 3.8.1
- org.codehaus.mojo：versions-maven-plugin 1.2.7
- https://www.mojohaus.org/flatten-maven-plugin/
1.2 版本占位符
自 Maven 3.5.0-beta-1 开始，可以使用 ${revision}, ${sha1} and/or ${changelist} 这样的变量作为版本占位符。
像这样：
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>org.apache.maven.ci</groupId>
<artifactId>ci-parent</artifactId>
<name>First CI Friendly</name>
<version>${revision}</version>
<properties>
<revision>1.0</revision>
</properties>
...
</project>或者像这样：
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>org.apache.maven.ci</groupId>
<artifactId>ci-parent</artifactId>
<name>First CI Friendly</name>
<version>${revision}${sha1}${changelist}</version>
...
<properties>
<revision>1.0</revision>
<changelist>-SNAPSHOT</changelist>
<sha1/>
</properties>
</project>可以使用这样的命令：
mvn -Drevision=2.7.8 -Dchangelist=-RELEASE -Dsha1=ssbd clean package
缺点：
Install / Deploy 时，版本占位符将不能被替换。这将导致 Install / Deploy 后， maven 不能识别。
使用 flatten-maven-plugin 解决这个问题。
flatten-maven-plugin：
<build>
<plugins>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>flatten-maven-plugin</artifactId>
<version>${flatten-maven-plugin.version}</version>
<configuration>
<updatePomFile>true</updatePomFile>
<flattenMode>resolveCiFriendliesOnly</flattenMode>
</configuration>
<executions>
<execution>
<id>flatten</id>
<phase>process-resources</phase>
<goals>
<goal>flatten</goal>
</goals>
</execution>
<execution>
<id>flatten-clean</id>
<phase>clean</phase>
<goals>
<goal>clean</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>2. 实例分析
2.1 先看一下自己构建的项目
基于 COLA 4.X 构建一个项目，本人目前正在写支付中台，所以就以此为例构建 “pointer-pay” 项目：
mvn archetype:generate \
-DgroupId=com.pointer.pay \
-DartifactId=pointer-pay \
-Dversion=1.0.0-SNAPSHOT \
-Dpackage=com.pointer.pay \
-DarchetypeArtifactId=cola-framework-archetype-web \
-DarchetypeGroupId=com.alibaba.cola \
-DarchetypeVersion=4.3.1然后看一下其初始项目的版本管理方式：
parent：
module：
可以看到这里的父工程和modules都写死了版本。当然，像支付中台或者其他不会变更需求的项目，这个写也没什么毛病。
But，在大多数互联网公司中，几乎每个项目都处在版本快速迭代中，甚至一两周更新一个小版本，一个月更新一个大版本。如果还是这样直接写死版本的话，通常做法就是全局搜索替换版本号，这样就显得很捞，也不太科学。然后就有了revision 的占位符统一管理。
2.2 再看一下开源项目是怎么进行版本管理的
我们可以在 spring-boot 和 spring-cloud-alibaba 的开源项目中看到，其就是利用 revision 占位符来进行统一版本管理的。
https://github.com/spring-projects/spring-boot/blob/2.2.x/pom.xml
https://github.com/alibaba/spring-cloud-alibaba/blob/2021.x/pom.xml
2.3 改造 pointer-pay 先看一下原来的项目结构：
然后利用 revision 占位符来统一管理版本：
父工程pom：
子工程pom：
修改完以后编译运行都没问题。然后 install、deploy 的时候就出现问题了：打出来的jar包的pom文件里还是原来的revision变量，下面一起到maven仓库中查看一下：
可见这里识别不出版本号，也就会导致引用方不能识别你的 pom/jar 包。这时 flatten-maven-plugin 就该出场了，在你的父 pom 引入相关插件：
<build>
<plugins>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>flatten-maven-plugin</artifactId>
<version>1.2.7</version>
<configuration>
<updatePomFile>true</updatePomFile>
<flattenMode>resolveCiFriendliesOnly</flattenMode>
</configuration>
<executions>
<execution>
<id>flatten</id>
<phase>process-resources</phase>
<goals>
<goal>flatten</goal>
</goals>
</execution>
<execution>
<id>flatten-clean</id>
<phase>clean</phase>
<goals>
<goal>clean</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>然后重新 clean、install 一下，你会发现每个模块根目录下多了一个 .flattened-pom.xml 文件，那么这个玩意是怎么生成的呢？下面一起看一下 updatePomFile 标签，官方文档是这个描述的：
The flag to indicate if the generated flattened POM shall be set as POM file to the current project. By default this is only done for projects with packaging other than pom. You may want to also do this for pom packages projects by setting this parameter to true or you can use false in order to only generate the flattened POM but never set it as POM file. If flattenMode is set to bom the default value will be true.
大概意思是：updatePomFile 属性表示是否将生成的 .flattened-pom.xml 作为当前项目的 pom 文件。默认只有打包的时候（package、install、deploy）会将 .flattened-pom.xml 做为当前项目的 pom 文件，但是打包类型 pom 的 pom.xml 中的占位符是不会被替换的。如果想要都被替换，那就将 updatePomFile 的属性设置为 true 吧。如果 flattenMode 被设置为 bom，updatePomFile 默认属性值为 true。
再一起看一下引入 flatten-maven-plugin 之后编译过的 pom 文件：
到此这篇关于Maven 版本管理与 flatten-maven-plugin 插件的使用及分析的文章就介绍到这了,更多相关Maven 版本管理与 flatten-maven-plugin 插件内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
Spring Boot整合Kafka+SSE实现实时数据展示
本文主要介绍了Spring Boot整合Kafka+SSE实现实时数据展示2024-06-06
这篇文章主要介绍了java static块和构造函数的实例详解的相关资料,希望通过本文能帮助到大家，让大家理解掌握Java static关键字的函数方法，需要的朋友可以参考下2017-09-09
这篇文章主要为大家介绍了elasticsearch索引index功能源码示例，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪2022-04-04
这篇文章主要介绍了Java 注解的相关资料，帮助大家更好的理解和学习使用Java，感兴趣的朋友可以了解下2021-03-03
这篇文章主要介绍了Java变量与常量，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2019-04-04
这篇文章主要介绍了关于Mybatis-Plus Update更新策略问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2021-11-11
一般单例都是五种写法：懒汉，饿汉，双重校验锁，静态内部类和枚举。本文整理了几种常见的单例写法，下面跟着小编一起来看下吧2017-01-01
这篇文章主要介绍了 Java实现九宫格的简单实例的相关资料,需要的朋友可以参考下2017-06-06
Java SpringBoot项目如何优雅的实现操作日志记录
这篇文章主要介绍了Java SpringBoot项目如何优雅的实现操作日志记录，文章围绕主题展开详细的内容介绍，具有一定的参考价值，需要的朋友可以参考一下2022-08-08
这篇文章主要介绍了Java模拟计算机的整数乘积计算功能,简单分析了计算机数值进制转换与通过位移进行乘积计算的原理,并结合具体实例给出了java模拟计算机成绩运算的相关操作技巧,需要的朋友可以参考下2017-09-09
最新评论