{"id":32476,"date":"2019-10-31T21:47:17","date_gmt":"2019-10-31T18:47:17","guid":{"rendered":"https:\/\/prohoster.info\/blog\/opyt-ispolzovaniya-flatten-maven-plugin-dlya-uproshheniya-versionirovaniya-v-maven-proektah\/"},"modified":"2019-10-31T21:47:17","modified_gmt":"2019-10-31T18:47:17","slug":"opyt-ispolzovaniya-flatten-maven-plugin-dlya-uproshheniya-versionirovaniya-v-maven-proektah","status":"publish","type":"post","link":"https:\/\/prohoster.info\/en\/blog\/administrirovanie\/opyt-ispolzovaniya-flatten-maven-plugin-dlya-uproshheniya-versionirovaniya-v-maven-proektah","title":{"rendered":"Experience using flatten-maven-plugin for simplifying versioning in Maven projects","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

About Us<\/h4>\n

\nAt 1C, we develop not only the platform 1C: Enterprise<\/a><\/noindex> to C++<\/a><\/noindex> and JavaScript<\/a><\/noindex>, but also applications in Java \u2013 specifically a new development environment Enterprise Development Tools<\/a><\/noindex> based on Eclipse, and the server is deeply integrated with the messenger platform \u2013 Interaction Systems<\/a><\/noindex>.<\/p>\n

Introduction<\/h4>\n

\nAs the build system for Java applications, we most often use Maven, and in this brief article, we would like to discuss one of the problems we encountered during the organization of development and the approach that allowed us to overcome this issue.
\n<\/a><\/noindex><\/p>\n

Prerequisites and Workflow<\/h4>\n

\nDue to the specifics of development in our Maven projects, we use quite a few modules, dependencies, and sub-projects. The number of POM files in a single tree can reach dozens and even hundreds.<\/p>\n

\"Experience
\n
\nIt would seem: nothing terrible, we created them once and forgot. If we need to change or add something in all files at once, there are plenty of convenient tools in editors and IDEs. What is the most common regular change in pom.xml? We believe it's changing the versions of projects and dependencies. Some may want to argue with this, but that\u2019s how it is for us. The reason lies in the fact that alongside the core, we are simultaneously developing many of our own libraries, and for consistent reproducibility of build and test results, the use of snapshots does not seem like a convenient approach. For this reason, we have to raise the version number in the projects with each build.<\/p>\n

Additionally, developers occasionally need to build their branch of a library and verify its functionality across all dependencies, which requires manually changing the version in all of them.<\/p>\n

Initial Solution<\/h4>\n

\nWith such frequent and numerous version changes, we want to simplify and automate the process within CI. Here, a convenient well-known plugin comes to the rescue versions-maven-plugin<\/i> \u2013 we connect it and run <\/p>\n

mvn -N versions:set -DnewVersion=2.0.1 <\/i><\/p>\n

and Maven will do everything right: it will traverse the hierarchy from top to bottom, substituting all versions \u2014 beautiful! Now we just need to create a pull request, colleagues will review the changes, and we can quickly merge into trunk. Quickly? Not just like that. A couple of hundred pom.xml<\/i> for review, and that doesn't take into account the code. Moreover, no one is immune to merge conflicts when dealing with such a large number of modified files. It should be noted that during the CI process, version changes occur automatically along with functional updates, rather than separately.<\/p>\n

New features<\/h4>\n

\nFor a while, we settled down and, having accepted it, lived on until the guys from Maven Apache Project<\/a><\/noindex> included support for so-called 'version placeholders' in Maven starting from version 3.5.0-beta-1. The essence of these placeholders is that pom.xml<\/i> instead of specifically indicating the project version, variables are used ${revision}<\/i>, ${sha1}<\/i> and ${changelist}<\/i>. The values of these properties are set either in the <properties<\/i>> element, or they can be defined through the system property<\/p>\n

mvn -Drevision=2.0.0 clean package<\/i><\/p>\n

The values of system properties take precedence over values defined in <properties<\/i>>.<\/p>\n

Parent<\/b>
\n<project>
\n\u00a0\u00a0<modelVersion>4.0.0<\\\/modelVersion>
\n\u00a0\u00a0<parent>
\n\u00a0\u00a0\u00a0\u00a0<groupId>org.apache<\\\/groupId>
\n\u00a0\u00a0\u00a0\u00a0<artifactId>apache<\\\/artifactId>
\n\u00a0\u00a0\u00a0\u00a0<version>18<\\\/version>
\n\u00a0\u00a0<\\\/parent>
\n\u00a0\u00a0<groupId>org.apache.maven.ci<\\\/groupId>
\n\u00a0\u00a0<artifactId>ci-parent<\\\/artifactId>
\n\u00a0\u00a0<name>First CI Friendly<\\\/name>
\n\u00a0\u00a0<version>${revision}${sha1}${changelist}<\/b><\\\/version>
\n\u00a0\u00a0\u2026
\n\u00a0\u00a0<properties>
\n\u00a0\u00a0\u00a0\u00a0<revision><\/b>1.3.1<\\\/revision><\/b>
\n\u00a0\u00a0\u00a0\u00a0<changelist><\/b>-SNAPSHOT<\\\/changelist><\/b>
\n\u00a0\u00a0\u00a0\u00a0<sha1\\\/><\/b>
\n\u00a0\u00a0<\\\/properties>
\n<\\\/project>
\n<\/i>
\nChild<\/b>
\n<project>
\n\u00a0\u00a0<modelVersion>4.0.0<\\\/modelVersion>
\n\u00a0\u00a0<parent>
\n\u00a0\u00a0\u00a0\u00a0<groupId>org.apache.maven.ci<\\\/groupId>
\n\u00a0\u00a0\u00a0\u00a0<artifactId>ci-parent<\\\/artifactId>
\n\u00a0\u00a0\u00a0\u00a0<version>${revision}${sha1}${changelist}<\/b><\\\/version>
\n\u00a0\u00a0<\\\/parent>
\n\u00a0\u00a0<groupId>org.apache.maven.ci<\\\/groupId>
\n\u00a0\u00a0<artifactId>ci-child<\\\/artifactId>
\n\u00a0\u00a0\u00a0\u2026
\n<\\\/project>
\n<\/i><\/p>\n

If you want to build version 2.0.0-SNAPSHOT, just use <\/p>\n

\u00a0\u00a0\u00a0\u00a0mvn -Drevision=2.0.0 clean package<\/i><\/p>\n

If you want to make a release, simply reset the SNAPSHOT <\/p>\n

\u00a0\u00a0\u00a0\u00a0mvn -Dchangelist= clean package<\/i><\/p>\n

*The examples above are taken from article<\/a><\/noindex> the Maven Apache Project website<\/p>\n

The Harsh Reality<\/h4>\n

\nEverything is fine and great, it's time to feel satisfaction, but no. It turns out that this method won't work for install and deploy, since the descriptions of the artifacts published in the repository won't be replaced ${revision}<\/i> with its value and Maven won't understand what it's all about.<\/p>\n

<parent>
\n\u00a0\u00a0\u00a0\u00a0<groupId>org.apache<\\\/groupId>
\n\u00a0\u00a0\u00a0\u00a0<artifactId>apache<\\\/artifactId>
\n\u00a0\u00a0\u00a0\u00a0<version>${revision}<\\\/version>
\n<\\\/parent>
\n<\/i><\/p>\n

Light at the End of the Tunnel<\/h4>\n

\nWe need to find a solution to the problem. The situation could be saved by flatten-maven-plugin<\/a><\/noindex>This plugin allows all variables in the pom, but it also removes a lot of other information that is only needed during the build and is not necessary when importing published artifacts into other projects. The plugin also 'flattens' all parent-child dependencies, resulting in flat pom files that include everything needed. The inconvenience was that it cuts out too much 'extra' information, which was not acceptable to us. After studying the information regarding the development of this plugin, it turned out we are not alone in the universe, as in August 2018, a pull request was created in the GitHub repository of the plugin with a request to allow defining how to 'corrupt' pom.xml on our own. The developers listened to the voices of the needy, and already in December, with the release of the new version 1.1.0, a new mode named resolveCiFriendliesOnly was introduced in the flatten-maven-plugin, which was just right for us \u2013 it leaves the pom.xml as it is, except for the element <version><\/i> and allows ${revision}<\/i>, ${sha1}<\/i> and ${changelist}<\/i>.<\/p>\n

Adding the plugin to the project<\/p>\n

<plugins>
\n\u00a0\u00a0<plugin>
\n\u00a0\u00a0\u00a0\u00a0org.codehaus.mojo
\n\u00a0\u00a0\u00a0\u00a0flatten-maven-plugin
\n\u00a0\u00a0\u00a0\u00a01.1.0
\n\u00a0\u00a0\u00a0\u00a0<configuration>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0true
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<flattenMode>resolveCiFriendliesOnly<\/b><\/flattenMode>
\n\u00a0\u00a0\u00a0\u00a0<\/configuration>
\n\u00a0\u00a0\u00a0\u00a0<executions>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<execution>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0flatten
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0process-resources
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<goals>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0flatten
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/goals>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/execution>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<execution>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0flatten.clean
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0clean
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<goals>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0clean
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/goals>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/execution>
\n\u00a0\u00a0\u00a0\u00a0<\/executions>
\n\u00a0\u00a0<\/plugin>
\n<\/plugins>
\n<\/i><\/p>\n

Done!<\/p>\n

Happy ending<\/h4>\n

\nFrom now on, to change the version of the entire project and inform all dependencies about it, we only need to edit the <revision<\/i>> element in just one root pom.xml<\/i>. A single file with the identical change arrives for review instead of a hundred or so of these files. This also eliminates the need to use versions-maven-plugin<\/i>.
\n
Source: habr.com<\/a><\/p>","protected":false,"gt_translate_keys":[{"key":"rendered","format":"html"}]},"excerpt":{"rendered":"

\u041e \u043d\u0430\u0441 \u0412 1\u0421 \u043c\u044b \u0440\u0430\u0437\u0440\u0430\u0431\u0430\u0442\u044b\u0432\u0430\u0435\u043c \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u0443 1\u0421: \u041f\u0440\u0435\u0434\u043f\u0440\u0438\u044f\u0442\u0438\u0435 \u043d\u0430 \u0421++ \u0438 JavaScript, \u043d\u043e \u0438 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f \u043d\u0430 Java \u2013 \u0432 \u0447\u0430\u0441\u0442\u043d\u043e\u0441\u0442\u0438 \u043d\u043e\u0432\u0443\u044e \u0441\u0440\u0435\u0434\u0443 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438 Enterprise Development Tools \u043d\u0430 \u0431\u0430\u0437\u0435 Eclipse \u0438 \u0441\u0435\u0440\u0432\u0435\u0440 \u0433\u043b\u0443\u0431\u043e\u043a\u043e \u0438\u043d\u0442\u0435\u0433\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u043e\u0433\u043e \u0441 \u043f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u043e\u0439 \u043c\u0435\u0441\u0441\u0435\u043d\u0434\u0436\u0435\u0440\u0430 \u2013 \u0421\u0438\u0441\u0442\u0435\u043c\u044b \u0412\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u0438\u044f. \u0412\u0441\u0442\u0443\u043f\u043b\u0435\u043d\u0438\u0435 \u0412 \u043a\u0430\u0447\u0435\u0441\u0442\u0432\u0435 \u0441\u0438\u0441\u0442\u0435\u043c\u044b \u0441\u0431\u043e\u0440\u043a\u0438 Java-\u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0439 \u0447\u0430\u0449\u0435 \u0432\u0441\u0435\u0433\u043e \u043c\u044b \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c maven, \u0438 \u0432 […]<\/p>\n","protected":false,"gt_translate_keys":[{"key":"rendered","format":"html"}]},"author":1,"featured_media":24280,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[688],"tags":[],"class_list":["post-32476","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-administrirovanie"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\n","aioseo_head_json":{"title":"\ud83e\udd47Experience using flatten-maven-plugin for simplifying versioning in maven projects | ProHoster","description":"About us At 1C we develop not only the 1C:Enterprise platform on","canonical_url":"https:\/\/prohoster.info\/en\/blog\/administrirovanie\/opyt-ispolzovaniya-flatten-maven-plugin-dlya-uproshheniya-versionirovaniya-v-maven-proektah","robots":"max-image-preview:large","keywords":"","webmasterTools":{"miscellaneous":""},"schema":null,"og:locale":"en_US","og:site_name":"ProHoster | \u041a\u0443\u043f\u0438\u0442\u044c \u043d\u0430\u0434\u0435\u0436\u043d\u044b\u0439 \u0445\u043e\u0441\u0442\u0438\u043d\u0433 \u0434\u043b\u044f \u0441\u0430\u0439\u0442\u043e\u0432 \u0441 \u0437\u0430\u0449\u0438\u0442\u043e\u0439 \u043e\u0442 DDoS, VPS VDS \u0441\u0435\u0440\u0432\u0435\u0440\u044b","og:type":"article","og:title":"\ud83e\udd47\u041e\u043f\u044b\u0442 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f flatten-maven-plugin \u0434\u043b\u044f \u0443\u043f\u0440\u043e\u0449\u0435\u043d\u0438\u044f \u0432\u0435\u0440\u0441\u0438\u043e\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u0432 maven-\u043f\u0440\u043e\u0435\u043a\u0442\u0430\u0445 | ProHoster","og:description":"\u041e \u043d\u0430\u0441 \u0412 1\u0421 \u043c\u044b \u0440\u0430\u0437\u0440\u0430\u0431\u0430\u0442\u044b\u0432\u0430\u0435\u043c \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u0443 1\u0421: \u041f\u0440\u0435\u0434\u043f\u0440\u0438\u044f\u0442\u0438\u0435 \u043d\u0430","og:url":"https:\/\/prohoster.info\/en\/blog\/administrirovanie\/opyt-ispolzovaniya-flatten-maven-plugin-dlya-uproshheniya-versionirovaniya-v-maven-proektah","og:image":"https:\/\/prohoster.info\/wp-content\/uploads\/2021\/11\/logo-350.jpg","og:image:secure_url":"https:\/\/prohoster.info\/wp-content\/uploads\/2021\/11\/logo-350.jpg","og:image:width":350,"og:image:height":350,"article:published_time":"2019-10-31T18:47:17+00:00","article:modified_time":"2019-10-31T18:47:17+00:00","article:publisher":"https:\/\/www.facebook.com\/prohoster","article:author":"https:\/\/www.facebook.com\/prohoster"},"aioseo_meta_data":{"post_id":"32476","title":null,"description":null,"keywords":null,"keyphrases":null,"primary_term":null,"canonical_url":null,"og_title":null,"og_description":null,"og_object_type":"default","og_image_type":"default","og_image_url":null,"og_image_width":null,"og_image_height":null,"og_image_custom_url":null,"og_image_custom_fields":null,"og_video":null,"og_custom_url":null,"og_article_section":null,"og_article_tags":null,"twitter_use_og":false,"twitter_card":"default","twitter_image_type":"default","twitter_image_url":null,"twitter_image_custom_url":null,"twitter_image_custom_fields":null,"twitter_title":null,"twitter_description":null,"schema":{"blockGraphs":[],"customGraphs":[],"default":{"data":{"Article":[],"Course":[],"Dataset":[],"FAQPage":[],"Movie":[],"Person":[],"Product":[],"ProductReview":[],"Car":[],"Recipe":[],"Service":[],"SoftwareApplication":[],"WebPage":[]},"graphName":"","isEnabled":true},"graphs":[]},"schema_type":null,"schema_type_options":null,"pillar_content":false,"robots_default":true,"robots_noindex":false,"robots_noarchive":false,"robots_nosnippet":false,"robots_nofollow":false,"robots_noimageindex":false,"robots_noodp":false,"robots_notranslate":false,"robots_max_snippet":null,"robots_max_videopreview":null,"robots_max_imagepreview":"large","priority":null,"frequency":null,"local_seo":null,"seo_analyzer_scan_date":"2026-01-21 11:03:20","breadcrumb_settings":null,"limit_modified_date":false,"reviewed_by":null,"ai":null,"created":"2021-03-01 02:58:23","updated":"2026-01-21 11:03:20","focus_keyword":null,"additional_keywords":null,"truseo_locale":null},"gt_translate_keys":[{"key":"link","format":"url"}],"_links":{"self":[{"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/posts\/32476","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/comments?post=32476"}],"version-history":[{"count":0,"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/posts\/32476\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/media\/24280"}],"wp:attachment":[{"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/media?parent=32476"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/categories?post=32476"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/tags?post=32476"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}