{"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\/nl\/blog\/administrirovanie\/opyt-ispolzovaniya-flatten-maven-plugin-dlya-uproshheniya-versionirovaniya-v-maven-proektah","title":{"rendered":"Ervaring met flatten-maven-plugin voor het vereenvoudigen van versiebeheer in Maven-projecten","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

Alconost is professioneel bezig met<\/h4>\n

\nBij 1C ontwikkelen we niet alleen een platform 1C: Enterprise<\/a><\/noindex> en een werkende opdracht krijgen. C++<\/a><\/noindex> en JavaScript<\/a><\/noindex>, maar ook applicaties in Java \u2013 met name een nieuwe ontwikkelomgeving Enterprise Development Tools<\/a><\/noindex> gebaseerd op Eclipse en de server die diep ge\u00efntegreerd is met het platform van de messenger \u2013 Interactiesystemen<\/a><\/noindex>.<\/p>\n

Inleiding<\/h4>\n

\nAls bouwsysteem voor Java-applicaties gebruiken we meestal Maven, en in dit korte artikel willen we het hebben over een van de problemen waarmee we tijdens de ontwikkeling zijn geconfronteerd, en de aanpak die ons heeft geholpen dit probleem op te lossen.
\n<\/a><\/noindex><\/p>\n

Achtergronden en werkproces<\/h4>\n

\nGezien de specificiteit van de ontwikkeling in onze Maven-projecten gebruiken we behoorlijk veel modules, afhankelijkheden en subprojecten. Het aantal POM-bestanden in \u00e9\u00e9n boom kan oplopen tot tientallen of zelfs honderden.<\/p>\n

\"Ervaring
\n
\nHet lijkt misschien: maak het \u00e9\u00e9n keer aan en vergeet het. Als je iets moet wijzigen of toevoegen in alle bestanden, zijn er genoeg handige tools in editors en IDE's. En wat is de meest voorkomende regelmatige wijziging in pom.xml? We vermoeden dat het de wijziging van versies van projecten en afhankelijkheden is. Misschien wil iemand hiertegen in discussie gaan, maar zo vergaat het ons. De reden is dat we naast de kern gelijktijdig veel eigen bibliotheken ontwikkelen, en voor constante reproduceerbaarheid van de bouw- en testresultaten is het gebruik van snapshots voor ons geen handige aanpak. Daarom moeten we bij elke build het versienummer in de projecten verhogen.<\/p>\n

Ook heeft de ontwikkelaar af en toe de behoefte om zijn eigen tak van een bibliotheek te bouwen en de functionaliteit ervan te controleren over alle afhankelijkheden, waarvoor we handmatig de versie in al deze afhankelijkheden moeten wijzigen.<\/p>\n

Oorspronkelijke oplossing<\/h4>\n

\nMet zulke frequente en meervoudige wijzigingen in versies willen we het proces binnen CI vereenvoudigen en automatiseren. Hier komt een handige bekende plugin van pas versions-maven-plugin<\/i> \u2013 we koppelen deze aan en starten <\/p>\n

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

en Maven doet alles zoals het hoort: het doorloopt de hi\u00ebrarchie van boven naar beneden, vervangt alle versies \u2013 prachtig! Nu hoeven we alleen nog een pull-request aan te maken, de collega's bekijken de wijzigingen en we kunnen snel in de trunk integreren. Snel? Hoe zou dat kunnen. Een paar honderd pom.xml<\/i> bij de review, en dat is nog niet eens de code meegerekend. Daarnaast zijn merge-conflicten ook niet te vermijden met zo'n groot aantal wijzigingen in bestanden. Het is belangrijk op te merken dat tijdens het CI-proces versiewijzigingen automatisch plaatsvinden samen met de functionaliteitswijzigingen, en niet afzonderlijk.<\/p>\n

Nieuwe mogelijkheden<\/h4>\n

\nEen tijdje hebben we het rustig gehouden en ons eraan overgegeven, totdat de jongens van Maven Apache Project<\/a><\/noindex> begonnen met het opnemen van ondersteuning voor zogenaamde \"plaatsvervangers\" van versies (placeholders) in Maven, te beginnen met versie 3.5.0-beta-1. De essentie van deze plaatsvervangers is dat in pom.xml<\/i> plaats van een specifieke versie van het project variabelen worden gebruikt ${revision}<\/i>, ${sha1}<\/i> en ${changelist}<\/i>. De waarden van deze eigenschappen worden ofwel gedefinieerd in het element <properties<\/i>>, of ze kunnen worden gedefinieerd via een systeemkenmerk<\/p>\n

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

Waarden van systeemkenmerken hebben voorrang boven waarden die in <properties<\/i>> zijn gedefinieerd.<\/p>\n

Ouder<\/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>Eerste CI-vriendelijk<\\\/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>
\nAfgeleide<\/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

Als je versie 2.0.0-SNAPSHOT wilt bouwen, gebruik je gewoon <\/p>\n

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

Als je een release wilt maken, reset je gewoon de SNAPSHOT <\/p>\n

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

*De bovenstaande voorbeelden zijn genomen van artikel<\/a><\/noindex> de website van Maven Apache Project<\/p>\n

De harde realiteit<\/h4>\n

\nHet is allemaal goed en wel, het is tijd om een gevoel van voldoening te ervaren, maar dat is niet het geval. Blijkbaar werkt deze methode niet voor install en deploy, omdat in de beschrijvingen van de artefacten die in de repository worden gepubliceerd, ${revision}<\/i> niet zal worden vervangen door de waarde en Maven begrijpt dan helemaal niet waar het over gaat.<\/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

Licht aan het einde van de tunnel<\/h4>\n

\nWe moeten een oplossing voor het probleem zoeken. De situatie zou kunnen worden gered door flatten-maven-plugin<\/a><\/noindex>Deze plugin staat alle variabelen in pom toe, maar snijdt ook een hoop andere informatie uit die alleen nodig is bij de build en niet bij het importeren van gepubliceerde artefacten in andere projecten. Daarnaast 'vereenvoudigt' de plugin alle parent-child afhankelijkheden, waardoor platte pom's ontstaan die alles bevatten wat nodig is. Het nadeel was dat hij te veel 'overbodige' informatie uitsnijdt, wat ons helemaal niet beviel. Na het bestuderen van informatie over de ontwikkeling van deze plugin, bleek dat we niet alleen in het universum waren; in augustus 2018 was er op GitHub in de repository van de plugin een pull-request aangemaakt met het verzoek om de mogelijkheid te cre\u00ebren om zelf te bepalen hoe pom.xml 'veranderd' moet worden. De ontwikkelaars luisterden naar de stemmen van de behoeftigen, en in december, met de lancering van versie 1.1.0, werd de nieuwe modus resolveCiFriendliesOnly in de flatten-maven-plugin ge\u00efntroduceerd, die als nooit tevoren van pas kwam \u2013 het laat pom.xml intact behalve het element <version><\/i> en staat toe ${revision}<\/i>, ${sha1}<\/i> en ${changelist}<\/i>.<\/p>\n

We voegen de plugin aan het project toe<\/p>\n

<plugins>
\n\u00a0\u00a0<plugin>
\n\u00a0\u00a0\u00a0\u00a0<groupId>org.codehaus.mojo<\\\/groupId>
\n\u00a0\u00a0\u00a0\u00a0<artifactId>flatten-maven-plugin<\\\/artifactId>
\n\u00a0\u00a0\u00a0\u00a0<version>1.1.0<\\\/version>
\n\u00a0\u00a0\u00a0\u00a0<configuration>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<updatePomFile>true<\\\/updatePomFile>
\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\u00a0<id>flatten<\\\/id>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<phase>process-resources<\\\/phase>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<goals>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<goal>flatten<\\\/goal>
\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\u00a0<id>flatten.clean<\\\/id>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<phase>clean<\\\/phase>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<goals>
\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<goal>clean<\\\/goal>
\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

Klaar!<\/p>\n

Happy end<\/h4>\n

\nVoortaan moeten we, om de versie van het hele project te wijzigen en dit aan alle afhankelijkheden te laten weten, slechts het element <revision<\/i>> in slechts \u00e9\u00e9n enkele root pom.xml<\/i>. Tijdens de review komen er niet honderden van deze bestanden met dezelfde wijziging binnen, maar \u00e9\u00e9n. En het is ook niet meer nodig om gebruik te maken van versions-maven-plugin<\/i>.
\n
Bron: 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\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\udd47Ervaring met het gebruik van flatten-maven-plugin voor het vereenvoudigen van versiebeheer in maven-projecten | ProHoster","description":"Over ons Bij 1C ontwikkelen we niet alleen het 1C: Enterprise platform op","canonical_url":"https:\/\/prohoster.info\/nl\/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":"nl_NL","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\/nl\/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\/nl\/wp-json\/wp\/v2\/posts\/32476","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/prohoster.info\/nl\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/prohoster.info\/nl\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/prohoster.info\/nl\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/prohoster.info\/nl\/wp-json\/wp\/v2\/comments?post=32476"}],"version-history":[{"count":0,"href":"https:\/\/prohoster.info\/nl\/wp-json\/wp\/v2\/posts\/32476\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/prohoster.info\/nl\/wp-json\/wp\/v2\/media\/24280"}],"wp:attachment":[{"href":"https:\/\/prohoster.info\/nl\/wp-json\/wp\/v2\/media?parent=32476"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/prohoster.info\/nl\/wp-json\/wp\/v2\/categories?post=32476"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/prohoster.info\/nl\/wp-json\/wp\/v2\/tags?post=32476"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}